Pular para conteúdo

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

  1. Declare as variáveis no manifesto: variables: [senha_api].
  2. Para cada ambiente, o project.yaml diz qual variável de ambiente tem o valor:

    environments:
      - name: PROD
        variables:
          senha_api: FIN_PROD_SENHA_API
    
  3. Sem esse mapeamento, o valor vem de SQL2DEVOPS_VAR_<NOME> (por exemplo SQL2DEVOPS_VAR_SENHA_API).

  4. --var-env nome=VARIAVEL sobrepõe no exec, package run, deploy, promote e emergency.

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.