Ansible

Comandos e fluxos de trabalho abrangentes do Ansible para administração de sistemas em todas as plataformas.

Comandos Básicos

Comando	Descrição
`ansible --version`	Mostrar versão do ansible
`ansible --help`	Exibir informações de ajuda
`ansible init`	Inicializar ansible no diretório atual
`ansible status`	Verificar status atual
`ansible list`	Listar opções disponíveis
`ansible info`	Exibir informações do sistema
`ansible config`	Mostrar configurações de configuração
`ansible update`	Atualizar para a versão mais recente
`ansible start`	Iniciar serviço ansible
`ansible stop`	Parar serviço ansible
`ansible restart`	Reiniciar serviço ansible
`ansible reload`	Recarregar configuração

Instalação

Linux/Ubuntu

# Package manager installation
sudo apt update
sudo apt install ansible

# Alternative installation
wget https://github.com/example/ansible/releases/latest/download/ansible-linux
chmod +x ansible-linux
sudo mv ansible-linux /usr/local/bin/ansible

# Build from source
git clone https://github.com/example/ansible.git
cd ansible
make && sudo make install

sudo apt-get update sudo apt-get install ansible

macOS

# Homebrew installation
brew install ansible

# MacPorts installation
sudo port install ansible

# Manual installation
curl -L -o ansible https://github.com/example/ansible/releases/latest/download/ansible-macos
chmod +x ansible
sudo mv ansible /usr/local/bin/

brew install ansible

Windows

# Chocolatey installation
choco install ansible

# Scoop installation
scoop install ansible

# Winget installation
winget install ansible

# Manual installation
# Download from https://github.com/example/ansible/releases
# Extract and add to PATH

pip install ansible

Configuração

Comando	Descrição
`ansible config show`	Exibir configuração atual
`ansible config list`	Listar todas as opções de configuração
`ansible config set <key> <value>`	Definir valor de configuração
`ansible config get <key>`	Obter valor de configuração
`ansible config unset <key>`	Remover valor de configuração
`ansible config reset`	Redefinir para configuração padrão
`ansible config validate`	Validar arquivo de configuração
`ansible config export`	Exportar configuração para arquivo

Operações Avançadas

Operações de Arquivo

# Create new file/resource
ansible create <name>

# Read file/resource
ansible read <name>

# Update existing file/resource
ansible update <name>

# Delete file/resource
ansible delete <name>

# Copy file/resource
ansible copy <source> <destination>

# Move file/resource
ansible move <source> <destination>

# List all files/resources
ansible list --all

# Search for files/resources
ansible search <pattern>

Copiar arquivos
Gerenciar permissões
Criar e excluir arquivos/diretórios

Operações de Rede

# Connect to remote host
ansible connect <host>:<port>

# Listen on specific port
ansible listen --port <port>

# Send data to target
ansible send --target <host> --data "<data>"

# Receive data from source
ansible receive --source <host>

# Test connectivity
ansible ping <host>

# Scan network range
ansible scan <network>

# Monitor network traffic
ansible monitor --interface <interface>

# Proxy connections
ansible proxy --listen <port> --target <host>:<port>

Configurar interfaces de rede
Gerenciar firewall
Configurar roteamento

Gerenciamento de Processos

# Start background process
ansible start --daemon

# Stop running process
ansible stop --force

# Restart with new configuration
ansible restart --config <file>

# Check process status
ansible status --verbose

# Monitor process performance
ansible monitor --metrics

# Kill all processes
ansible killall

# Show running processes
ansible ps

# Manage process priority
ansible priority --pid <pid> --level <level>

Iniciar/parar serviços
Monitorar processos
Gerenciar recursos do sistema

Recursos de Segurança

Autenticação

# Login with username/password
ansible login --user <username>

# Login with API key
ansible login --api-key <key>

# Login with certificate
ansible login --cert <cert_file>

# Logout current session
ansible logout

# Change password
ansible passwd

# Generate new API key
ansible generate-key --name <key_name>

# List active sessions
ansible sessions

# Revoke session
ansible revoke --session <session_id>

Configurar chaves SSH
Gerenciar usuários e grupos
Controle de acesso baseado em função

Criptografia

# Encrypt file
ansible encrypt --input <file> --output <encrypted_file>

# Decrypt file
ansible decrypt --input <encrypted_file> --output <file>

# Generate encryption key
ansible keygen --type <type> --size <size>

# Sign file
ansible sign --input <file> --key <private_key>

# Verify signature
ansible verify --input <file> --signature <sig_file>

# Hash file
ansible hash --algorithm <algo> --input <file>

# Generate certificate
ansible cert generate --name <name> --days <days>

# Verify certificate
ansible cert verify --cert <cert_file>

Criptografar variáveis
Proteger credenciais
Gerenciar segredos

Monitoramento e Registro

Monitoramento do Sistema

# Monitor system resources
ansible monitor --system

# Monitor specific process
ansible monitor --pid <pid>

# Monitor network activity
ansible monitor --network

# Monitor file changes
ansible monitor --files <directory>

# Real-time monitoring
ansible monitor --real-time --interval 1

# Generate monitoring report
ansible report --type monitoring --output <file>

# Set monitoring alerts
ansible alert --threshold <value> --action <action>

# View monitoring history
ansible history --type monitoring

Coletar métricas de desempenho
Monitorar recursos do sistema
Alertas e notificações

Registro

# View logs
ansible logs

# View logs with filter
ansible logs --filter <pattern>

# Follow logs in real-time
ansible logs --follow

# Set log level
ansible logs --level <level>

# Rotate logs
ansible logs --rotate

# Export logs
ansible logs --export <file>

# Clear logs
ansible logs --clear

# Archive logs
ansible logs --archive <archive_file>

Configurar logs
Rotacionar arquivos de log
Analisar registros do sistema

Solução de Problemas

Problemas Comuns

Problema: Comando não encontrado

# Check if ansible is installed
which ansible
ansible --version

# Check PATH variable
echo $PATH

# Reinstall if necessary
sudo apt reinstall ansible
# or
brew reinstall ansible

Verificar PATH
Reinstalar pacote
Verificar instalação do Ansible

Problema: Permissão negada

# Run with elevated privileges
sudo ansible <command>

# Check file permissions
ls -la $(which ansible)

# Fix permissions
chmod +x /usr/local/bin/ansible

# Check ownership
sudo chown $USER:$USER /usr/local/bin/ansible

Usar sudo
Verificar permissões de arquivo
Ajustar configurações de segurança

Problema: Erros de configuração

# Validate configuration
ansible config validate

# Reset to default configuration
ansible config reset

# Check configuration file location
ansible config show --file

# Backup current configuration
ansible config export > backup.conf

# Restore from backup
ansible config import backup.conf

Validar sintaxe do playbook
Verificar arquivos de configuração
Depurar configurações

Problema: Serviço não iniciando

# Check service status
ansible status --detailed

# Check system logs
journalctl -u ansible

# Start in debug mode
ansible start --debug

# Check port availability
netstat -tulpn|grep <port>

# Kill conflicting processes
ansible killall --force

Verificar logs de serviço
Reiniciar serviço
Verificar dependências

Comandos de Depuração

Comando	Descrição
`ansible --debug`	Ativar saída de depuração
`ansible --verbose`	Habilitar registro detalhado
`ansible --trace`	Habilitar registro de rastreamento
`ansible test`	Executar testes integrados
`ansible doctor`	Executar verificação de saúde do sistema
`ansible diagnose`	Gerar relatório de diagnóstico
`ansible benchmark`	Executar benchmarks de desempenho
`ansible validate`	Validar instalação e configuração

ansible-playbook —syntax-check
ansible-playbook -vvv
ansible-console

Otimização de Desempenho

Gerenciamento de Recursos

# Set memory limit
ansible --max-memory 1G <command>

# Set CPU limit
ansible --max-cpu 2 <command>

# Enable caching
ansible --cache-enabled <command>

# Set cache size
ansible --cache-size 100M <command>

# Clear cache
ansible cache clear

# Show cache statistics
ansible cache stats

# Optimize performance
ansible optimize --profile <profile>

# Show performance metrics
ansible metrics

Limitar execuções paralelas
Configurar forks
Otimizar inventário

Processamento Paralelo

# Enable parallel processing
ansible --parallel <command>

# Set number of workers
ansible --workers 4 <command>

# Process in batches
ansible --batch-size 100 <command>

# Queue management
ansible queue add <item>
ansible queue process
ansible queue status
ansible queue clear
```## Integração
```bash
#!/bin/bash
# Example script using ansible

set -euo pipefail

# Configuration
CONFIG_FILE="config.yaml"
LOG_FILE="ansible.log"

# Check if ansible is available
if ! command -v ansible &> /dev/null; then
    echo "Error: ansible is not installed" >&2
    exit 1
fi

# Function to log messages
log() \\\\{
    echo "$(date '+%Y-%m-%d %H:%M:%S') - $1"|tee -a "$LOG_FILE"
\\\\}

# Main operation
main() \\\\{
    log "Starting ansible operation"

    if ansible --config "$CONFIG_FILE" run; then
        log "Operation completed successfully"
        exit 0
    else
        log "Operation failed with exit code $?"
        exit 1
    fi
\\\\}

# Cleanup function
cleanup() \\\\{
    log "Cleaning up"
    ansible cleanup
\\\\}

# Set trap for cleanup
trap cleanup EXIT

# Run main function
main "$@"
```### Integração de API
```python
#!/usr/bin/env python3
"""
Python wrapper for the tool
"""

import subprocess
import json
import logging
from pathlib import Path
from typing import Dict, List, Optional

class ToolWrapper:
    def __init__(self, config_file: Optional[str] = None):
        self.config_file = config_file
        self.logger = logging.getLogger(__name__)

    def run_command(self, args: List[str]) -> Dict:
        """Run command and return parsed output"""
        cmd = ['tool_name']

        if self.config_file:
            cmd.extend(['--config', self.config_file])

        cmd.extend(args)

        try:
            result = subprocess.run(
                cmd,
                capture_output=True,
                text=True,
                check=True
            )
            return \\\\{'stdout': result.stdout, 'stderr': result.stderr\\\\}
        except subprocess.CalledProcessError as e:
            self.logger.error(f"Command failed: \\\\{e\\\\}")
            raise

    def status(self) -> Dict:
        """Get current status"""
        return self.run_command(['status'])

    def start(self) -> Dict:
        """Start service"""
        return self.run_command(['start'])

    def stop(self) -> Dict:
        """Stop service"""
        return self.run_command(['stop'])

# Example usage
if __name__ == "__main__":
    wrapper = ToolWrapper()
    status = wrapper.status()
    print(json.dumps(status, indent=2))
```## Variáveis de Ambiente

| Variável | Descrição | Padrão |
|----------|-------------|---------|
| `ANSIBLE_CONFIG` | Caminho do arquivo de configuração | `~/.ansible/config.yaml` |
| `ANSIBLE_HOME` | Diretório home | `~/.ansible` |
| `ANSIBLE_LOG_LEVEL` | Nível de log | `INFO` |
| `ANSIBLE_LOG_FILE` | Caminho do arquivo de log | `~/.ansible/logs/ansible.log` |
| `ANSIBLE_CACHE_DIR` | Diretório de cache | `~/.ansible/cache` |
| `ANSIBLE_DATA_DIR` | Diretório de dados | `~/.ansible/data` |
| `ANSIBLE_TIMEOUT` | Tempo limite padrão | `30s` |
| `ANSIBLE_MAX_WORKERS` | Trabalhadores máximos | `4` |## Arquivo de Configuração
```yaml
# ~/.ansible/config.yaml
version: "1.0"

# General settings
settings:
  debug: false
  verbose: false
  log_level: "INFO"
  log_file: "~/.ansible/logs/ansible.log"
  timeout: 30
  max_workers: 4

# Network configuration
network:
  host: "localhost"
  port: 8080
  ssl: true
  timeout: 30
  retries: 3

# Security settings
security:
  auth_required: true
  api_key: ""
  encryption: "AES256"
  verify_ssl: true

# Performance settings
performance:
  cache_enabled: true
  cache_size: "100M"
  cache_dir: "~/.ansible/cache"
  max_memory: "1G"

# Monitoring settings
monitoring:
  enabled: true
  interval: 60
  metrics_enabled: true
  alerts_enabled: true
```## Exemplos
```bash
# 1. Initialize ansible
ansible init

# 2. Configure basic settings
ansible config set host example.com
ansible config set port 8080

# 3. Start service
ansible start

# 4. Check status
ansible status

# 5. Perform operations
ansible run --target example.com

# 6. View results
ansible results

# 7. Stop service
ansible stop
```### Fluxo Básico
```bash
# Comprehensive operation with monitoring
ansible run \
  --config production.yaml \
  --parallel \
  --workers 8 \
  --verbose \
  --timeout 300 \
  --output json \
  --log-file operation.log

# Monitor in real-time
ansible monitor --real-time --interval 5

# Generate report
ansible report --type comprehensive --output report.html
```### Fluxo Avançado
```bash
#!/bin/bash
# Automated ansible workflow

# Configuration
TARGETS_FILE="targets.txt"
RESULTS_DIR="results/$(date +%Y-%m-%d)"
CONFIG_FILE="automation.yaml"

# Create results directory
mkdir -p "$RESULTS_DIR"

# Process each target
while IFS= read -r target; do
    echo "Processing $target..."

    ansible \
        --config "$CONFIG_FILE" \
        --output json \
        --output-file "$RESULTS_DIR/$\\\\{target\\\\}.json" \
        run "$target"

done < "$TARGETS_FILE"

# Generate summary report
ansible report summary \
    --input "$RESULTS_DIR/*.json" \
    --output "$RESULTS_DIR/summary.html"
```### Exemplo de Automação

## Melhores Práticas

### Segurança
- Sempre verifique as somas de verificação ao baixar binários
- Use métodos de autenticação fortes (chaves de API, certificados)
- Atualize regularmente para a versão mais recente
- Siga o princípio do menor privilégio
- Ative o registro de auditoria para conformidade
- Use conexões criptografadas sempre que possível
- Valide todas as entradas e configurações
- Implemente controles de acesso adequados

### Desempenho
- Use limites de recursos apropriados para seu ambiente
- Monitore o desempenho do sistema regularmente
- Otimize a configuração para seu caso de uso
- Use processamento paralelo quando benéfico
- Implemente estratégias de cache adequadas
- Manutenção e limpeza regulares
- Perfile gargalos de desempenho
- Use algoritmos e estruturas de dados eficientes

### Operacional
- Mantenha documentação abrangente
- Implemente estratégias de backup adequadas
- Use controle de versão para configurações
- Monitore e alerte sobre métricas críticas
- Implemente tratamento de erros adequado
- Use automação para tarefas repetitivas
- Auditorias de segurança e atualizações regulares
- Planeje a recuperação de desastres

### Desenvolvimento
- Siga padrões e convenções de codificação
- Escreva testes abrangentes
- Use integração/implantação contínua
- Implemente registro e monitoramento adequados
- Documente APIs e interfaces
- Use controle de versão efetivamente
- Revise o código regularmente
- Mantenha compatibilidade com versões anteriores

## Recursos

### Documentação Oficial
- [Site Oficial]()
- [Documentação]()
- [Referência da API]()
- [Guia de Instalação]()
- [Referência de Configuração]()

### Recursos da Comunidade
- [Repositório GitHub]()
- [Rastreador de Problemas]()
- [Fórum da Comunidade]()
- [Servidor Discord]()
- [Comunidade Reddit]()
- [Stack Overflow]()

### Recursos de Aprendizado
- [Guia de Introdução]()
- [Série de Tutoriais]()https://example.com/ansible)
- [Documentation](https://docs.example.com/ansible)
- [API Reference](https://api.example.com/ansible)
- [Installation Guide](https://docs.example.com/ansible/installation)
- [Configuration Reference](https://docs.example.com/ansible/configuration)

### Community Resources
- [GitHub Repository](https://github.com/example/ansible)
- [Issue Tracker](https://github.com/example/ansible/issues)
- [Community Forum](https://forum.example.com/ansible)
- [Discord Server](https://discord.gg/ansible)
- [Reddit Community](https://reddit.com/r/ansible)
- [Stack Overflow](https://stackoverflow.com/questions/tagged/ansible)

### Learning Resources
- [Getting Started Guide](https://docs.example.com/ansible/getting-started)
- [Tutorial Series](https://docs.example.com/ansible/tutorials) [Guia de Melhores Práticas]([Tutoriais em Vídeo](https://youtube.com/c/ansible) [Cursos de Treinamento]([Programa de Certificação](https://certification.example.com/ansible) [Ferramentas Relacionadas](

### Ferramentas Relacionadas
- [Git](git.md) - Funcionalidade complementar
- [Docker](docker.md) - Solução alternativa
- [Kubernetes](kubernetes.md) - Parceiro de integração

---

*Última atualização: 2025-07-06|[Editar no GitHub](https://github.com/perplext/1337skills/edit/main/docs/cheatsheets/ansible.md)*