`runner preflight`

Roda as checagens de prontidao que ja acontecem antes de um deploy e as agrega num relatorio unico — manifesto, secrets, portas, DNS e argumentos de imagem — com verde/amarelo/vermelho por componente. Nao sobe container nenhum.

O exit code so e diferente de zero quando o status geral e vermelho (problema bloqueante). Amarelo passa. Isso e o que permite CI e o Deploy Wizard do CCS gatearem em cima dele sem quebrar por avisos.

Dois modos

Modo	Alvo	Como
App registrada	Uma app ja no Runner	`runner preflight <app>`
Repo (dry)	Um deploy que ainda nao existe	`runner preflight --repo <owner/name> --branch <b>`

O modo repo clona para um tempdir, opcionalmente escreve o .deploy.yml gerado pelo wizard (via stdin), roda as mesmas checagens e limpa tudo — sem registrar, sem commitar, sem deployar. E o que permite validar um manifesto antes de ele existir.

De exatamente um dos dois: <app> ou --repo + --branch. Sao mutuamente exclusivos.

Sintaxe

runner preflight <app>
runner preflight <app> --json
runner preflight --repo acme/app --branch main --json
cat gen.deploy.yml | runner preflight --repo acme/app --branch dev --manifest-stdin --json

Flags

Flag	Descricao
`--repo <OWNER/NAME>`	Modo repo: clona num tempdir e checa sem registrar. Exclui `<app>`
`--branch <BRANCH>`	Modo repo: branch a clonar. Obrigatorio com `--repo`
`--token <TOKEN>`	Modo repo: PAT para repo privado
`--manifest-stdin`	Modo repo: le o `.deploy.yml` do stdin e escreve no clone antes das checagens. O conteudo nunca e logado
`-o, --output`	`human` \| `json` \| `yaml`
`--json`	Relatorio em JSON (consumido pelo deploy wizard do CCS)
`-x, --exact`	Exige match exato de identidade
`--insecure`	Bypass dos guards de seguranca

Semantica do exit code

Status geral	Exit	Significado
verde	0	Pronto
amarelo	0	Ha avisos, mas nada bloqueia o deploy
vermelho	!= 0	Problema bloqueante

Gatear CI em preflight e seguro justamente porque amarelo nao derruba o pipeline.

Preflight vs validate vs doctor

Comando	Pergunta que responde
`validate`	O `.deploy.yml` esta sintatica e semanticamente correto?
`preflight`	Este deploy subiria agora? (secrets, portas, DNS, imagem)
`doctor`	O servidor esta saudavel? (mkey, ckeys, dependencias)

Ver tambem

By Borlot.com.br on 19/08/2026

# `runner preflight`

# Dois modos

# Sintaxe

# Flags

# Semantica do exit code

# Preflight vs validate vs doctor

# Ver tambem

Tags