# Referência CLI

Guia completo de todos os comandos disponíveis no DeployAlly CLI.

# Instalação

curl -fsSL https://get.deployally.com | bash

Ou download manual:

curl -Lo deployally https://get.deployally.com/releases/latest/deployally
chmod +x deployally
sudo mv deployally /usr/local/bin/

# Estrutura de Comandos

deployally <comando> [subcomando] [opções]

# Comandos Globais

# --version

Exibe a versão do CLI.

deployally --version

# --help

Exibe ajuda do comando.

deployally --help
deployally deploy --help

# --config

Especifica arquivo de configuração alternativo.

deployally --config /path/to/config.toml deploy

# Comandos Principais

# init

Configura o CLI para uso.

# Sintaxe

deployally init [opções]

# Opções

# Exemplos

# Configurar com API
deployally init \
  --api-url https://sys.deployally.com \
  --api-key da_xxx

# Modo local/offline
deployally init --local

# list

Lista templates disponíveis.

# Sintaxe

deployally list [opções]

# Opções

# Exemplos

# Listar todos os templates
deployally list

# Listar apenas bancos de dados
deployally list --family database

# Listar MySQL
deployally list --species mysql

# Templates locais
deployally list --source local

# Saída JSON
deployally list --json

# deploy

Faz deploy de um template.

# Sintaxe

deployally deploy [opções]

# Opções

# Exemplos

# Deploy interativo
deployally deploy --species mysql

# Deploy com versão específica
deployally deploy --species mysql --version 8.4

# Deploy com profile de produção
deployally deploy --species mysql --version 8.4 --profile production

# Deploy sem confirmação
deployally deploy --species redis --yes

# status

Mostra status dos containers.

# Sintaxe

deployally status [opções]

# Opções

# Exemplos

# Status resumido
deployally status

# Incluir containers parados
deployally status --all

# Saída JSON
deployally status --json

# definitions

Gerencia definitions.

# Subcomandos

# Exemplos

# Listar definitions
deployally definitions list

# Ver detalhes
deployally definitions show mysql_meu_banco

# Atualizar profile
deployally definitions update mysql_meu_banco --profile production

# Ver histórico
deployally definitions history mysql_meu_banco

# Rollback
deployally definitions rollback mysql_meu_banco --revision 1

# Remover
deployally definitions delete mysql_meu_banco

# instances

Gerencia instances (containers).

# Subcomandos

# Exemplos

# Listar instances
deployally instances list

# Ver logs
deployally instances logs mysql_meu_banco

# Logs em tempo real
deployally instances logs mysql_meu_banco --follow

# Reiniciar
deployally instances restart mysql_meu_banco

# Executar comando
deployally instances exec mysql_meu_banco -- mysql -u root -p

# sync

Sincroniza estado entre definitions e instances.

# Sintaxe

deployally sync [opções]

# Opções

# Exemplos

# Verificar drift
deployally sync --check

# Corrigir diferenças
deployally sync --fix

# Ver o que seria feito
deployally sync --fix --dry-run

# self-update

Atualiza o CLI para a versão mais recente.

# Sintaxe

deployally self-update [opções]

# Opções

# Exemplos

# Atualizar para última versão
deployally self-update

# Verificar se há atualização (sem baixar)
deployally self-update --check

# Forçar reinstalação
deployally self-update --force

# Usar canal de release candidate
deployally self-update --channel rc

# Especificar caminho de instalação
deployally self-update --path /opt/bin/deployally

# Saída

════════════════════════════════════════════════════════════
   DEPLOYALLY SELF-UPDATE
════════════════════════════════════════════════════════════

  Versão atual: 0.8.10
  Canal: stable
  Destino: /usr/local/bin/deployally

  Baixando versão mais recente...

  ✓ Atualização concluída!
  Nova versão: deployally 0.9.0

════════════════════════════════════════════════════════════

# Processo de Atualização

1. Verifica versão atual
2. Baixa binário do servidor de releases
3. Verifica integridade (tamanho mínimo 1MB)
4. Testa execução do binário baixado
5. Cria backup do binário atual
6. Substitui pelo novo binário
7. Define permissões (755)
8. Remove backup após sucesso

Se qualquer verificação falhar, o backup é restaurado automaticamente.

# Arquivo de Configuração

Localização: ~/.config/deployally/config.toml

[api]
url = "https://sys.deployally.com"
api_key = "da_xxx"

[server]
name = "meu-servidor"
environment = "production"

[defaults]
source = "remote"
profile = "development"

[logging]
level = "info"

# Exit Codes

# Variáveis de Ambiente

# Próximos Passos

• Getting Started - Primeiro deploy
• Templates - Como funcionam os templates
• Integração API - Uso programático (restrito)