Variáveis e segredos¶
Os scripts podem usar variáveis com a sintaxe do psql, então scripts escritos para o psql rodam sem mudança:
| Sintaxe | Vira |
|---|---|
:'nome' |
um texto entre aspas: 'd''água' |
:"nome" |
um identificador entre aspas: "minha tabela" |
:nome |
o valor como está |
CREATE ROLE api LOGIN PASSWORD :'senha_api';
Nada é substituído dentro de textos, comentários ou corpos $$ do PostgreSQL, e nomes desconhecidos ficam como estão, então casts ::int e atribuições := são seguros.
De onde vêm os valores¶
- Declare as variáveis no manifesto:
variables: [senha_api]. -
Para cada ambiente, o
project.yamldiz qual variável de ambiente tem o valor:environments: - name: PROD variables: senha_api: FIN_PROD_SENHA_API -
Sem esse mapeamento, o valor vem de
SQL2DEVOPS_VAR_<NOME>(por exemploSQL2DEVOPS_VAR_SENHA_API). --var-env nome=VARIAVELsobrepõe noexec,package run,deploy,promoteeemergency.
Na pipeline, essas variáveis de ambiente vêm dos secrets.
Nunca expostos¶
Os valores nunca são gravados no repositório de controle, na tabela de histórico ou em arquivo nenhum, e aparecem mascarados (****) em toda mensagem e relatório de falha. Os relatórios mostram o script como foi escrito, com as referências às variáveis.
Comandos do psql¶
O \set ON_ERROR_STOP on é ignorado, porque o Sql2DevOps sempre para no primeiro erro. Outros comandos do psql são recusados com uma mensagem clara: use variáveis no lugar do \set.