# runner signal

Envia sinais de status de pipelines externos (CI/CD, smoke tests, testes de integracao) para o Runner. O Runner usa esses sinais para tomar decisoes sobre progressao de canary, pausas e aborts durante deploys.

Use quando: sua pipeline de CI precisa comunicar o resultado de testes para o Runner antes que um canary avance, ou para bloquear/desbloquear progressao automatica.

# Subcomandos

# runner signal send

Envia um sinal de status para uma app. O sinal pode acionar notificacao, pausa ou abort do deploy dependendo do status e da action configurada.

runner signal send <APP> --status <STATUS> [flags]

# Argumentos

# Flags

# Status e actions

# Exemplos

Testes passaram — liberar progressao:

runner signal send meu-app --status ok --message "50/50 testes passaram"

Testes falharam — abortar canary:

runner signal send meu-app --status fail --message "3 testes de integracao falharam"

Falha critica — acionar rollback imediato:

runner signal send meu-app --status fail --action rollback --message "endpoint /checkout retornando 500"

Aviso sem bloquear:

runner signal send meu-app --status warn --action notify --message "latencia P99 acima do esperado"

# runner signal clear

Remove o sinal ativo de uma app, desbloqueando a progressao de canary que estava pausada ou aguardando confirmacao.

runner signal clear <APP> [flags]

runner signal clear meu-app

# runner signal list

Lista todos os sinais ativos no momento.

runner signal list [flags]

runner signal list
# Saida exemplo:
# APP         STATUS  ACTION  MESSAGE                          AGE
# meu-app     fail    abort   3 testes de integracao falharam  2m
# outro-app   warn    pause   latencia alta                    15m

# Erros comuns

• app not found — O nome da app nao corresponde a nenhum projeto registrado; verifique com runner list.
• --status required — O flag --status e obrigatorio para signal send.
• unknown action — Actions validas sao notify, pause, abort, rollback; verifique a grafia.