# Gerenciamento de Instancias

Comandos para gerenciar instancias, versoes e canary deployments.

# Listar Instancias

runner instances <project>

Exemplo:

runner instances meu-app

Output:

Instancias de meu-app:
  production (app.meusite.com.br)
    v1.0.1 (100%)
  staging (staging.meusite.com.br)
    develop-abc123 (100%)
  pr-42 (pr-42.staging.meusite.com.br) [ephemeral]
    pr-42-def456 (100%)

# Listar Versoes

runner versions <project> -i <instance>

Exemplo:

runner versions meu-app -i production

Output:

Versoes de meu-app (production):
  v1.0.1 (current)
  v1.0.0
  v0.9.0

# Ver Pesos (Canary)

runner weights <project> -i <instance>

Exemplo:

runner weights meu-app -i production

Output:

Distribuicao de trafego (production):
  v1.0.0: 90%
  v1.0.1-rc1: 10%

# Ajustar Peso

runner weight <project> <instance> <version> <weight>

Parametros:

• weight: 0-100 (porcentagem)

Exemplo:

# Aumentar canary para 50%
runner weight meu-app production v1.0.1-rc1 50

Output:

Peso atualizado:
  v1.0.0: 50%
  v1.0.1-rc1: 50%

# Promover Versao

runner promote <project> -i <instance> <version>

Exemplo:

runner promote meu-app -i production v1.0.1-rc1

Este comando:

1. Define peso 100% para a versao
2. Remove versoes antigas do routing
3. Limpa containers antigos

# Destruir Instancia

runner destroy <project> -i <instance>

Exemplo:

runner destroy meu-app -i pr-42

Este comando:

1. Para containers da instancia
2. Remove Traefik config
3. Remove diretorios

# Cleanup

runner cleanup [--expired]

Opcoes:

• Sem flags: limpa versoes antigas (mantendo keep_versions)
• --expired: limpa instancias ephemeral expiradas

Exemplo:

# Limpar versoes antigas
runner cleanup

# Limpar staging expirados
runner cleanup --expired

# Fluxo de Canary

# 1. Deploy Canary

runner deploy meu-app --version v1.0.1-rc1

# 2. Iniciar com 10%

runner weight meu-app production v1.0.1-rc1 10

# 3. Aumentar para 50%

runner weight meu-app production v1.0.1-rc1 50

# 4. Promover para 100%

runner promote meu-app -i production v1.0.1-rc1

# Rollback do Canary

Se algo der errado:

runner weight meu-app production v1.0.1-rc1 0

Ou destrua a versao:

runner destroy meu-app -i production --version v1.0.1-rc1