# Instalação e Configuração

Configure o DeployAlly e faça seu primeiro deploy em 5 minutos.

# Pré-requisitos

Antes de começar, certifique-se de ter:

• Servidor Linux com Docker instalado
• Acesso SSH ao servidor
• Conta no DeployAlly (para usar a API centralizada)

# 1. Instalação do CLI

# Via Script (Recomendado)

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

O script detecta automaticamente sua arquitetura (x86_64, arm64) e instala o binário em /usr/local/bin/.

# Download Manual

Baixe o binário correspondente ao seu sistema:

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

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

# Verificar Instalação

deployally --version

Saída esperada:

deployally 0.8.10

# 2. Configuração Inicial

# Modo API (Recomendado)

Conecte o CLI à API centralizada para gerenciamento completo:

deployally init \
  --api-url https://sys.deployally.com \
  --api-key {SUA_API_KEY}

O comando cria o arquivo de configuração em ~/.config/deployally/config.toml.

# Modo Local (Offline)

Para usar apenas templates locais, sem conexão com a API:

deployally init --local

# 3. Preparar o Servidor

Se o servidor ainda não tem Docker instalado, use o Implant:

# No servidor de destino
curl -fsSL https://get.deployally.com/implant | bash

O Implant:

• Instala Docker e Docker Compose
• Configura rede e volumes padrão
• Registra o servidor na API (se configurado)

# 4. Primeiro Deploy

# Listar Templates Disponíveis

deployally list

Saída:

SPECIES          VARIANT    VERSION   DESCRIPTION
mysql            standard   8.4       MySQL Database Server
mysql            standard   5.7       MySQL Database Server (Legacy)
redis            alpine     7         Redis Cache Server
wordpress        standard   6         WordPress CMS
traefik          standard   2.11      Traefik Ingress Controller
...

# Deploy de MySQL

deployally deploy --species mysql --version 8.4

O CLI solicita os parâmetros necessários:

? Nome do banco de dados: meu_banco
? Usuário do banco: meu_usuario
? Senha do banco: ********
? Profile [minimal/development/production]: development

Criando definition...
Fazendo deploy...
Container mysql_meu_banco criado com sucesso!

# Verificar Status

deployally status

Saída:

CONTAINER          STATUS     HEALTH    UPTIME
mysql_meu_banco    running    healthy   2m

# 5. Estrutura de Arquivos

Após a configuração, o DeployAlly cria:

~/.config/deployally/
├── config.toml          # Configuração do CLI
├── templates/           # Templates locais (se usados)
└── definitions/         # Definitions criadas

# config.toml

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

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

[defaults]
source = "remote"

# 6. Atualização do CLI

O DeployAlly pode ser atualizado diretamente pela linha de comando.

# Verificar Atualizações

deployally self-update --check

# Atualizar para Última Versão

deployally self-update

O comando:

1. Baixa a nova versão do servidor de releases
2. Verifica integridade do binário
3. Cria backup do binário atual
4. Substitui pelo novo
5. Remove backup após sucesso

# Opções Adicionais

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

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

# Atualização Manual

Se preferir atualizar manualmente:

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

# Próximos Passos

• Sistema de Templates - Entenda como funcionam os templates
• Referência CLI - Todos os comandos disponíveis
• Taxonomia - Como os recursos são organizados
• Integração com API - Configuração avançada (restrito)

# Solução de Problemas

# Erro de conexão com API

Error: Failed to connect to API

Verifique:

1. URL da API está correta
2. API key é válida
3. Conexão com internet está funcionando

# Docker não encontrado

Error: Docker not found

Instale o Docker ou use o Implant para preparar o servidor:

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

# Permissão negada

Error: Permission denied

Adicione seu usuário ao grupo docker:

sudo usermod -aG docker $USER
# Faça logout e login novamente

Para mais problemas, consulte Troubleshooting.