Glossário do Runner
Termos curtos. Veja a referência completa de comandos em Referência CLI.
app
Unidade de deploy. Tem um .deploy.yml e mora em /data/apps/<nome>/.
Pode ter múltiplas instâncias (production, staging, etc.).
bundle
Arquivo .runner/secrets.enc — segredos criptografados (AES-GCM)
commitado no repo. Permite restaurar segredos em outro servidor que
tenha a ckey.
ckey
Chave de criptografia por app (app-state). Decripta o bundle
daquela app. Gerada no runner add. Pode ser exportada/importada via
runner ckeys export/import-sealed.
deploy
Ato de subir uma nova versão do container. Phases: fetch → prepare → security → image → container → health → routing. Veja GitOps mode.
dist branch
Branch onde o Runner faz push do .runner/secrets.enc e
.deploy.yml atualizado depois de cada deploy. Default: dist.
Configurável em state.dist_branch.
drift
Quando o .deploy.yml no manifest atual diverge do que o wizard
geraria com o docker-compose.yml/wizard-answers.yml atuais. Veja
Drift detected.
instância
Uma rota/ambiente independente de uma app. Ex: production em
app.com, staging em staging.app.com. Cada instância tem domínio,
versão e contagem de réplicas.
manifest
O .deploy.yml. Define tipo da app, image/build, port, healthcheck,
instances, secrets esperados.
mkey
Master key do servidor — encripta as ckeys antes de gravar no
state. Existe uma única por servidor. Sem ela, todas as ckeys viram
inacessíveis. Veja
Restaurar em novo servidor.
pause
Estado em que o cron fetch --deploy ignora a app. Pode ser manual
(runner pause <app>) ou automático (3 falhas consecutivas →
retry-exhausted).
per-service path
Em apps geradas via wizard --from-compose (multi-service), o bundle
fica em pull/<service>/.runner/secrets.enc em vez de pull/.runner/.
Evita colisão quando N apps compartilham o mesmo repo upstream. Veja
Multi-service shared repo.
pull/
Subdiretório dentro de /data/apps/<nome>/pull/. Clone do repo Git da
app. O Runner faz git fetch/reset aqui antes de build.
state
YAML em /opt/runner/state/<app>.yml. Histórico, contadores, ckey
encriptada, last deploy, etc.
wizard
Comando interativo que gera o .deploy.yml. Pode rodar runner wizard
em diretório com Dockerfile (state machine v2.30.0+) ou
runner wizard --from-compose em diretório com docker-compose.yml.