# FAQ

Perguntas frequentes sobre o DeployAlly.

# Geral

# O que é o DeployAlly?

DeployAlly é uma plataforma de deployment automatizado para containers. Ela simplifica o processo de criar, configurar e gerenciar containers Docker através de templates pré-configurados e uma interface unificada.

# Quais sistemas operacionais são suportados?

O CLI suporta:

• Linux (x86_64, arm64)
• macOS (Intel e Apple Silicon)
• Windows (via WSL)

Os servidores de destino devem rodar Linux com Docker.

# Preciso saber Docker para usar?

Conhecimento básico de Docker ajuda, mas não é obrigatório. Os templates abstraem a complexidade da configuração de containers.

# O DeployAlly é gratuito?

O DeployAlly oferece planos gratuitos e pagos. O plano gratuito inclui:

• 1 servidor
• Templates básicos
• 60 requisições/minuto à API

Planos pagos oferecem mais servidores, templates premium e rate limits maiores.

# Templates

# Quais templates estão disponíveis?

Atualmente oferecemos 14 templates:

Assets: MySQL 8.4/5.7, Redis 7, PostgreSQL 16

Infrastructure: Traefik 2.11, Prometheus, Grafana

Applications: WordPress, n8n, Mautic, Evolution API, Mailcow, Chatwoot, phpMyAdmin

# Posso criar meus próprios templates?

Sim! Você pode criar templates locais em YAML e usá-los com --source local. Veja Sistema de Templates.

# Como atualizo um template?

Templates são imutáveis. Para atualizar, você precisa:

1. Criar nova definition com a versão atualizada
2. Fazer deploy da nova definition
3. Migrar dados (se necessário)
4. Remover a definition antiga

# Posso modificar um template existente?

Templates remotos não podem ser modificados. Para customização:

1. Exporte o template para YAML local
2. Modifique conforme necessário
3. Use com --source local

# Deployments

# Quanto demora um deploy?

Depende de vários fatores:

• Se a imagem Docker já foi baixada
• Velocidade da rede
• Complexidade do serviço

Tipicamente:

• Primeiro deploy: 1-5 minutos (download da imagem)
• Deploys subsequentes: 10-30 segundos

# Posso fazer rollback de um deploy?

Sim! Cada alteração cria uma revisão:

deployally definitions history {nome}
deployally definitions rollback {nome} --revision {numero}

# O que acontece se o deploy falhar?

O container anterior permanece rodando. O DeployAlly usa estratégia blue-green:

1. Novo container é criado
2. Health check é executado
3. Se saudável, tráfego é direcionado para o novo
4. Container antigo é removido

Se falhar no passo 2 ou 3, o container antigo continua operando.

# Posso fazer deploy em múltiplos servidores?

Sim! Crie definitions para cada servidor:

deployally deploy --species mysql --server servidor-1
deployally deploy --species mysql --server servidor-2

# Segurança

# Como as senhas são armazenadas?

• Localmente: Em ~/.config/deployally/ com permissão 600
• No servidor: Criptografadas com AES-256-GCM no Vault
• Em trânsito: HTTPS (TLS 1.3)

Senhas nunca são armazenadas em texto plano ou sincronizadas para a nuvem.

# As API Keys são seguras?

Sim. API Keys são:

• Geradas com entropia criptográfica
• Armazenadas como hash SHA-256 no servidor
• Transmitidas apenas via HTTPS
• Revogáveis a qualquer momento

# Posso limitar acesso por IP?

Sim! Configure IP allowlist na API Key:

1. Dashboard > API Keys > Editar
2. Adicione IPs permitidos
3. Requisições de outros IPs serão bloqueadas

# Os dados são compartilhados?

Não compartilhamos dados de clientes. Apenas metadados anônimos são coletados para melhorias (opt-out disponível).

# Infraestrutura

# Preciso de um servidor dedicado?

Não necessariamente. DeployAlly funciona em:

• VPS (DigitalOcean, Linode, Vultr)
• Cloud (AWS, GCP, Azure)
• Servidores dedicados
• Máquinas locais

Requisito mínimo: 1GB RAM, 10GB disco.

# O DeployAlly gerencia DNS?

Não diretamente. Para domínios, você precisa:

1. Configurar DNS apontando para seu servidor
2. Usar Traefik (template disponível) para roteamento
3. Certificados SSL são gerados automaticamente via Let's Encrypt

# Posso usar sem internet?

Sim, com limitações:

1. Configure modo local: deployally init --local
2. Baixe templates localmente
3. Funcionalidades que dependem da API não funcionarão

# Como faço backup dos dados?

Os dados ficam em volumes Docker. Recomendamos:

1. Backup dos volumes: /var/lib/docker/volumes/
2. Exportar definitions: deployally definitions export
3. Usar ferramenta de backup (BackupAlly, rsync, etc.)

# Troubleshooting

# O container não inicia, o que fazer?

1. Verificar logs: deployally instances logs {nome}
2. Verificar recursos: docker stats
3. Verificar configuração: deployally definitions show {nome}

Veja Troubleshooting para mais detalhes.

# Como reporto um bug?

1. Colete informações: deployally --version, logs, configuração
2. Abra issue no GitHub ou
3. Envie para suporte@deployally.com

# Onde encontro mais ajuda?

• Documentação
• Troubleshooting
• GitHub Issues
• Email: suporte@deployally.com

# Billing e Planos

# Como funciona a cobrança?

• Plano Free: Gratuito, com limitações
• Planos pagos: Cobrados mensalmente
• Sem surpresas: Você define limites

# Posso cancelar a qualquer momento?

Sim! Cancele pelo Dashboard sem compromisso. Seus dados permanecem acessíveis por 30 dias.

# O que acontece se exceder o limite?

Requisições além do limite retornam erro 429 (Rate Limited). Seus containers continuam funcionando normalmente.