# runner edit

Edita a configuracao de uma aplicacao registrada, como a branch trackeada.

# Sintaxe

runner edit <APP> [OPTIONS]

# Argumentos

# Opcoes

# Exemplos

# Ver configuracao atual

runner edit runner-docs/front --show

Saida:

App Configuration: runner-docs/front
─────────────────────────────
  Path:    /apps/runner-docs
  Branch:  main
  Type:    front-static
  Version: v1.0.0
  Status:  atualizado

# Mudar para branch dev

runner edit runner-docs/front --branch dev

Saida:

Changing branch: main → dev
✓ Git repository found
✓ Branch 'dev' exists on remote
✓ Branch contains .deploy.yml
✓ State updated
✓ Branch 'dev' is now active

Done! Run 'runner fetch' to check for updates.

# Mudar branch sem fazer pull

runner edit runner-docs/front --branch main --pull false

Apenas atualiza o state file, sem executar git checkout/pull.

# Validacoes

O comando realiza tres validacoes antes de alterar a branch:

1. Repositorio ativo - Verifica se o diretorio contem .git
2. Branch existe - Verifica se a branch existe no remote via git ls-remote
3. Contem .deploy.yml - Verifica se a branch contem o arquivo de configuracao

Se qualquer validacao falhar, a alteracao e cancelada:

✗ Error: Branch 'inexistente' does not exist on remote
  Available branches:
    origin/dev
    origin/main
    origin/dist

# Fluxo de Uso

Apos alterar a branch, execute fetch para verificar atualizacoes:

# 1. Mudar branch
runner edit runner-docs/front --branch dev

# 2. Verificar atualizacoes
runner fetch runner-docs/front

# 3. Deploy se necessario
runner deploy runner-docs/front

# State File

O comando modifica o arquivo de state em /opt/runner/state/{app}.yml:

app_path: /apps/runner-docs
project: runner-docs
system: front
app_type: front-static
dist_branch: dev  # <- alterado pelo edit
current_version: v1.0.0
status: atualizado

# Casos de Uso

# Testar versao de desenvolvimento

# Mudar para dev
runner edit meu-app/front --branch dev
runner fetch --deploy

# Depois de testar, voltar para main
runner edit meu-app/front --branch main
runner fetch --deploy

# Deploy de branch especifica

# Deploy de uma feature branch
runner edit meu-app/sys --branch feature/nova-api
runner deploy meu-app/sys

# Rollback para dist
runner edit meu-app/sys --branch dist
runner deploy meu-app/sys

# Disponibilidade

• Adicionado em: v1.2.2-rc.8

# Veja Tambem

• fetch - Buscar atualizacoes
• deploy - Executar deploy
• instances - Gerenciar instancias