Projetos e ambientes¶
Cada projeto é descrito em projects/<projeto>/project.yaml no repositório de controle. Crie com project init, edite e faça o commit.
sql2devops project init financeiro -d postgres --envs DEV,HML,PROD
sql2devops project check financeiro
project: financeiro
environments: # na ordem de promoção
- name: DEV # approval: none (padrão)
targets:
financeiro-db: { driver: postgres, dsn_env: FIN_DEV_DSN }
- name: HML # exige DEV (o anterior)
approval: automatic # uma pipeline aprova, com evidência
targets:
financeiro-db: { driver: postgres, dsn_env: FIN_HML_DSN }
- name: PROD
approval: human
approvers: [github:alice, github:bruno]
min_approvals: 1
allow_self_approval: false # padrão: quem enviou não aprova
rerun_after_failure: false # padrão: true
variables:
senha_api: FIN_PROD_SENHA_API
targets:
financeiro-db: { driver: postgres, dsn_env: FIN_PROD_DSN }
emergency: # opcional
allowed: [github:plantao]
require_ticket: true
reviewers: [github:chefe]
Campos do ambiente¶
| Campo | Padrão | Significado |
|---|---|---|
name |
Nome do ambiente (DEV, HML, PROD…) | |
approval |
none |
none, automatic ou human |
approvers |
Quem pode aprovar (github:<login> ou usuário do sistema) |
|
min_approvals |
1 | Aprovações necessárias |
allow_self_approval |
false | Se quem enviou pode aprovar o próprio pacote |
rerun_after_failure |
true | Se uma versão que falhou pode rodar de novo |
variables |
Para cada variável, a variável de ambiente com o valor | |
targets |
Bancos: driver, dsn_env e, no SQLite, functions |
Promovendo¶
sql2devops promote CHG-1001 --project financeiro # próximo ambiente
sql2devops deploy CHG-1001 --project financeiro --env HML # um ambiente específico
sql2devops approve CHG-1001 --project financeiro --env HML --automatic --evidence "$URL_DOS_TESTES"
sql2devops approve CHG-1001 --project financeiro --env PROD
sql2devops status --project financeiro
O --force passa por cima das conferências de "já aplicado" e de divergência, nunca das regras de aprovação.