pier.yaml e apply
Configuração no repositório e infraestrutura declarativa.
Há dois jeitos de descrever configuração em arquivo, para versionar junto com o código:
pier.yamlfica no repositório da aplicação e ajusta como ela é construída e roda, a cada deploy.pierctl applylê um arquivo seu e cria ou atualiza quais recursos existem: aplicações, bancos e stacks.
pier.yaml no repositório
Coloque um pier.yaml (ou .pier.yaml) na raiz do código, ou no diretório base configurado. A cada deploy, o Pier lê o arquivo e sobrepõe essas opções à configuração do painel, só para aquele deploy. O que está salvo no painel não muda.
Todas as chaves são opcionais:
build:
pack: dockerfile # dockerfile | nixpacks | railpack | static
dockerfile: docker/Dockerfile.prod
target: production # estágio de Dockerfile, opcional
publish_directory: /dist # static
spa: true # static
install_command: npm ci # nixpacks
build_command: npm run build
start_command: node server.js
port: 8080
runtime:
restart_policy: unless-stopped
stop_grace_seconds: 30
health:
enabled: true
path: /healthz
interval_seconds: 5
timeout_seconds: 5
retries: 10
start_period_seconds: 5
release:
command: npm run migrate
limits:
cpus: "0.5"
memory: 512m
processes:
- name: web
replicas: 2
- name: worker
command: node worker.js
limits: { memory: 1g }
watch_paths: ["apps/api/**"]O que não vai no arquivo
Domínios, variáveis, segredos, servidor, ambiente e origem do código não são aceitos no pier.yaml, de propósito. O repositório não decide para onde o código vai nem carrega segredos. Essas opções ficam no painel ou no apply.
Erros
O arquivo é validado com rigor. Uma chave desconhecida, um tipo errado ou um valor inválido falham o deploy antes do build, com a linha do problema:
pier.yaml, linha 4: campo desconhecido "prot"; aceitos: …O log do deploy lista o que veio do arquivo. Exemplo: Configuração de pier.yaml aplicada a este deploy: port, release.command.
O
pier.yamlnão é lido em aplicações de imagem, rollbacks e promoções, porque não há código para ler. E owatch_pathsdele não filtra webhooks, que rodam antes do checkout. Para monorepos, configure os caminhos observados também no painel.
Infraestrutura declarativa com apply
Descreva os recursos de um ou mais ambientes num YAML, com um documento por recurso:
# infra.yaml
kind: Application
project: loja
name: api
config:
source: { repository: https://github.com/acme/api, branch: main }
network: { port: 3000, domains: [https://api.exemplo.com] }
env:
LOG_LEVEL: info
DATABASE_URL: ${{principal.url}}
---
kind: Database
project: loja
name: principal
engine: postgresqlpierctl apply -f infra.yaml --diff # mostra o que mudaria
pierctl apply -f infra.yaml --deploy --wait # aplica e implantaO apply cria o que falta e atualiza o que mudou. Rodar duas vezes não muda nada na segunda.
Remover o que saiu do arquivo
Com --prune, aplicações, bancos e stacks que existem no Pier mas não estão no arquivo também são removidos. Isso vale só nos ambientes que o arquivo menciona. A CLI lista os candidatos e só remove com --yes:
pierctl apply -f infra.yaml --diff --prune # quem seria removido
pierctl apply -f infra.yaml --prune --yesNum ambiente protegido, confirme o nome do ambiente. Repita a flag para vários ambientes:
pierctl apply -f infra.yaml --prune --yes --confirm-environment productionVariáveis nunca são removidas pelo --prune.