Pipelines¶
Toda pipeline faz as mesmas três coisas: instala o Sql2DevOps com a sua chave de download, pega um clone do repositório de controle e roda os comandos. Os secrets necessários:
| Secret | Para quê |
|---|---|
SQL2DEVOPS_DOWNLOAD_KEY |
Baixar a ferramenta (pegue a sua) |
SQL2DEVOPS_SIGNING_KEY |
Assinar o histórico (sql2devops key generate) |
SQL2DEVOPS_LICENSE |
Edição paga, quando você tiver |
| Strings de conexão | Uma por ambiente, com os nomes do project.yaml (dsn_env) |
| Um token do Git | Escrita no repositório de controle |
GitHub Actions¶
jobs:
banco:
runs-on: ubuntu-latest
environment: producao # opcional: o portão de aprovação do próprio GitHub
steps:
- uses: actions/checkout@v4
- name: Instalar o Sql2DevOps
run: curl -fsSL https://sql2devops.com/install.sh | sh
env:
SQL2DEVOPS_DOWNLOAD_KEY: ${{ secrets.SQL2DEVOPS_DOWNLOAD_KEY }}
SQL2DEVOPS_VIA: action
- name: Repositório de controle
run: git clone https://x-access-token:${{ secrets.CONTROL_REPO_TOKEN }}@github.com/sua-org/sql-control.git control
- name: Enviar e promover
run: |
export PATH="$HOME/.local/bin:$PATH"
sql2devops package submit --auto-version ./db/CHG-1001
sql2devops promote CHG-1001 --project financeiro
env:
SQL2DEVOPS_CONTROL_DIR: control
SQL2DEVOPS_SIGNING_KEY: ${{ secrets.SQL2DEVOPS_SIGNING_KEY }}
SQL2DEVOPS_LICENSE: ${{ secrets.SQL2DEVOPS_LICENSE }}
FIN_DEV_DSN: ${{ secrets.FIN_DEV_DSN }}
No GitHub Actions quem executa vira github:<login> automaticamente, e o approve --automatic usa a URL da execução como evidência quando --evidence não é informado.
GitLab CI¶
banco:
image: alpine:3.20
before_script:
- apk add --no-cache curl git
- curl -fsSL https://sql2devops.com/install.sh | sh
- export PATH="$HOME/.local/bin:$PATH"
- git clone "https://oauth2:${CONTROL_REPO_TOKEN}@gitlab.com/seu-grupo/sql-control.git" control
script:
- sql2devops package submit --auto-version ./db/CHG-1001
- sql2devops promote CHG-1001 --project financeiro
variables:
SQL2DEVOPS_CONTROL_DIR: control
Cadastre SQL2DEVOPS_DOWNLOAD_KEY, SQL2DEVOPS_SIGNING_KEY, as strings de conexão e CONTROL_REPO_TOKEN como variáveis de CI/CD mascaradas.
Azure DevOps¶
steps:
- pwsh: |
$env:SQL2DEVOPS_DOWNLOAD_KEY = "$(SQL2DEVOPS_DOWNLOAD_KEY)"
irm https://sql2devops.com/install.ps1 | iex
displayName: Instalar o Sql2DevOps
- pwsh: |
git clone https://$(CONTROL_REPO_TOKEN)@dev.azure.com/sua-org/seu-projeto/_git/sql-control control
sql2devops package submit --auto-version ./db/CHG-1001
sql2devops promote CHG-1001 --project financeiro
env:
SQL2DEVOPS_CONTROL_DIR: control
SQL2DEVOPS_SIGNING_KEY: $(SQL2DEVOPS_SIGNING_KEY)
FIN_DEV_DSN: $(FIN_DEV_DSN)
Em agentes Linux, use a linha do install.sh do exemplo do GitHub.
Jenkins¶
pipeline {
agent any
environment {
SQL2DEVOPS_DOWNLOAD_KEY = credentials('sql2devops-download-key')
SQL2DEVOPS_SIGNING_KEY = credentials('sql2devops-signing-key')
FIN_DEV_DSN = credentials('fin-dev-dsn')
SQL2DEVOPS_CONTROL_DIR = 'control'
}
stages {
stage('Banco') {
steps {
sh 'curl -fsSL https://sql2devops.com/install.sh | sh'
sh 'git clone git@github.com:sua-org/sql-control.git control'
sh '$HOME/.local/bin/sql2devops package submit --auto-version ./db/CHG-1001'
sh '$HOME/.local/bin/sql2devops promote CHG-1001 --project financeiro'
}
}
}
}
Validando na CI¶
Antes do merge, rode o pacote num banco descartável, sem mexer no repositório de controle:
sql2devops package run -d postgres ./db/CHG-1001