runner validate
Valida sintaxe do .deploy.yml e verifica consistencia da estrutura do projeto
(campos obrigatorios, referencias de imagem, ports, secrets declarados vs disponiveis).
Use quando: editou o manifest manualmente e quer confirmar antes de fazer deploy.
Sintaxe
runner validate --path <PATH> [flags]Flags
| Flag | Tipo | Obrigatorio | Descricao |
|---|---|---|---|
-p, --path <PATH> |
string | Sim | Caminho para o diretorio do projeto ou diretamente para o arquivo .deploy.yml |
--category <CATEGORY> |
enum | Nao | Executa apenas as verificacoes da categoria informada: manifest, structure, config, environment, version, docker |
-o, --output <FORMAT> |
enum | Nao | Formato de saida: human (padrao), json, yaml |
--json |
flag | Nao | Atalho para --output json |
-h, --help |
flag | Nao | Exibe ajuda |
Exemplos
Validar projeto pelo diretorio
runner validate --path /data/apps/meu-appValidar apontando diretamente para o manifest
runner validate --path /data/apps/meu-app/.deploy.ymlValidar apenas o manifest (sem checar estrutura de arquivos)
runner validate --path /data/apps/meu-app --category manifestSaida em JSON para CI/CD
runner validate --path /data/apps/meu-app --jsonCategorias de verificacao
| Categoria | O que verifica |
|---|---|
manifest |
Sintaxe YAML e campos obrigatorios do .deploy.yml |
structure |
Presenca de diretorios e arquivos esperados |
config |
Coerencia das configuracoes (ports, redes, healthcheck) |
environment |
Variaveis de ambiente declaradas vs disponiveis |
version |
Campo version e sua fonte (file, git-tag, git-commit) |
docker |
Referencias de imagem e parametros Docker |
Erros comuns
Missing required field 'project'— adicioneproject: <nome>no topo do.deploy.yml.Unknown healthcheck mode 'xyz'— os modos validos saopath,tcp,cmdeexit; veja a referencia de healthcheck.Secret declared but not in bundle— o secret esta declarado no manifest mas nao foi configurado; executerunner secrets show <app>para inspecionar.--path is required— o flag-p/--pathe obrigatorio; informe o caminho do projeto ou do.deploy.yml.
By Borlot.com.br on 27/05/2026