Pular para conteúdo

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