Implementación de canalizaciones de CI/CD
Hasta este punto, cada paso del proceso era manual. Compile el proyecto, ejecute SqlPackage y compruebe el informe de implementación. Una canalización de CI/CD convierte esa secuencia en algo que sucede automáticamente en cada confirmación, con los mismos pasos, en el mismo orden, cada vez. Sin marcas olvidadas, sin errores tipográficos en las cadenas de conexión, no "funcionó en mi máquina".
Diseño de la estructura de canalización
La mayoría de las canalizaciones de base de datos siguen un patrón de dos fases:
-
Compilación: compile el proyecto de base de datos SQL y genere el
.dacpacartefacto. -
Implementar: publique ese
.dacpacen las bases de datos de destino, pasando por entornos (desarrollo, ensayo, producción).
Compilar una vez e implementar el mismo artefacto en todas partes elimina el problema de "funciona en desarrollo, falla en producción". El .dacpac que pasó la validación en la etapa de pruebas es el mismo archivo que se implementa en producción.
Implementar una canalización de CI/CD con Acciones de GitHub
Los flujos de trabajo de Acciones de GitHub residen en .GitHub/workflows/ y definen la canalización como YAML. La Azure/sql-action acción controla la .dacpac implementación en Azure SQL Database.
Este es un flujo de trabajo que se basa en cada inserción en main y se implementa en producción.
# .github/workflows/sql-deploy.yml
name: Build and Deploy SQL Project
on:
push:
branches: [main]
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Build SQL project
run: dotnet build ./Database.sqlproj -o ./output
- name: Upload dacpac artifact
uses: actions/upload-artifact@v4
with:
name: dacpac
path: ./output/Database.dacpac
deploy:
needs: build
runs-on: ubuntu-latest
environment: production
steps:
- name: Download dacpac artifact
uses: actions/download-artifact@v4
with:
name: dacpac
- name: Install SqlPackage
run: dotnet tool install -g microsoft.sqlpackage
- uses: azure/login@v2
with:
client-id: ${{ secrets.AZURE_CLIENT_ID }}
tenant-id: ${{ secrets.AZURE_TENANT_ID }}
subscription-id: ${{ secrets.AZURE_SUBSCRIPTION_ID }}
- uses: azure/sql-action@v2.3
with:
connection-string: ${{ secrets.AZURE_SQL_CONNECTION_STRING }}
path: './Database.dacpac'
action: 'publish'
📝
Azure/sql-action admite los scripts .dacpac, .sqlproj y .sql. Funciona con la autenticación de SQL, Microsoft Entra ID y la autenticación de entidad de servicio.
Si azure SQL Database tiene habilitadas reglas de firewall, la dirección IP del ejecutor de Acciones de GitHub necesita acceso. Al emparejar Azure/login con Azure/sql-action, la acción agrega una regla de firewall temporal para la dirección IP del ejecutor durante la implementación y la quita después.
Implementación de una canalización de CI/CD con Azure DevOps
Azure DevOps proporciona la tarea SqlAzureDacpacDeployment para la implementación de .dacpac. Esta es la canalización equivalente:
# azure-pipelines.yml
trigger:
- main
pool:
vmImage: 'windows-latest'
steps:
- task: DotNetCoreCLI@2
inputs:
command: 'build'
projects: './Database.sqlproj'
arguments: '-o $(Build.ArtifactStagingDirectory)'
- task: PublishBuildArtifacts@1
inputs:
PathtoPublish: '$(Build.ArtifactStagingDirectory)/Database.dacpac'
ArtifactName: 'dacpac'
- task: SqlAzureDacpacDeployment@1
inputs:
azureSubscription: 'your-service-connection'
AuthenticationType: 'server'
ServerName: 'your-server.database.windows.net'
DatabaseName: 'your-database'
SqlUsername: '$(SqlUser)'
SqlPassword: '$(SqlPassword)'
deployType: 'DacpacTask'
DeploymentAction: 'Publish'
DacpacFile: '$(Build.ArtifactStagingDirectory)/Database.dacpac'
Para los agentes de Linux o más control sobre el proceso, instale y use SqlPackage directamente:
steps:
- script: dotnet tool install --global microsoft.sqlpackage
displayName: 'Install SqlPackage'
- script: |
sqlpackage /Action:Publish \
/SourceFile:$(Build.ArtifactStagingDirectory)/Database.dacpac \
/TargetConnectionString:"$(ConnectionString)"
displayName: 'Deploy database'
Tanto si usa Acciones de GitHub como Azure DevOps, ambas canalizaciones necesitan credenciales para conectarse a la base de datos. El siguiente paso es asegurarse de que esas credenciales permanecen fuera de los archivos YAML.
Una cadena de conexión codificada en un archivo YAML es una vulnerabilidad a punto de ocurrir. Tanto Acciones de GitHub como Azure DevOps proporcionan mecanismos para almacenar e insertar secretos en tiempo de ejecución sin exponerlos en el control de código fuente.
Repositorio de GitHub y secretos de entorno
Almacene valores confidenciales como secretos de repositorio o secretos de entorno. En tu repositorio de GitHub en github.com:
- Seleccione Configuración>Secretos y variables>Acciones.
- Seleccione New repository secret (Nuevo secreto del repositorio).
- Agregue un nombre (como
AZURE_SQL_CONNECTION_STRING) y el valor.
Haga referencia a secretos en el proceso de trabajo con ${{ secrets.SECRET_NAME }}. Los secretos de entorno se limitan a entornos de implementación específicos, por lo que las credenciales de producción solo son accesibles para los trabajos destinados a producción.
Autenticación con entidad de servicio y OpenID Connect
Mejor aún, omita las contraseñas por completo.
OpenID Connect (OIDC) con Azure/login autenticaciones mediante credenciales federadas, sin ningún secreto de cliente almacenado en ningún lugar. Necesita tres valores:
-
AZURE_CLIENT_ID: identificador de la aplicación (cliente) de la entidad de servicio. -
AZURE_TENANT_ID. su id. de inquilino de Microsoft Entra ID. -
AZURE_SUBSCRIPTION_ID: Su ID de suscripción de Azure.
La entidad de servicio se autentica a través de credenciales federadas, por lo que no hay ninguna contraseña para rotar o filtrar.
Integración de Azure Key Vault
Para la administración centralizada de secretos, almacene las cadenas de conexión y las credenciales en Azure Key Vault y haga que la canalización las extraiga en el momento de la implementación. En Azure DevOps, la tarea Azure Key Vault recupera secretos en variables de canalización. En Acciones de GitHub, use Azure/login seguido de los comandos CLI de Azure para leer desde el almacén.
Importante
Rotar las credenciales de la base de datos con regularidad. Azure Key Vault se puede integrar con Azure Functions para automatizar la rotación de secretos, lo que reduce el riesgo de credenciales en peligro.
Implementación de controles de canalización de implementación
Una canalización que se implementa en producción en cada inserción sin ningún paso de revisión es arriesgada para los cambios en la base de datos. Necesita controles que impidan que los cambios no revisados lleguen a producción.
Reglas de protección del entorno
Tanto GitHub como Azure DevOps admiten entornos con reglas de protección que controlan las implementaciones:
- Revisores necesarios: uno o varios miembros del equipo deben aprobar antes de que se ejecute el trabajo de implementación. En GitHub, configure esta opción en Configuración>Entornos>Reglas de protección.
- Temporizadores de espera: agregue un retraso entre la aprobación y la ejecución, lo que proporciona al equipo una ventana para reconsiderar.
-
Ramas de implementación: restrinja las ramas que pueden tener como destino un entorno. Por ejemplo, solo
mainse implementa en producción.
Políticas de rama
Las políticas de rama protegen la rama principal y sirven como la primera línea de defensa. En Azure DevOps, configure:
- Número mínimo de revisores para las solicitudes de incorporación de cambios.
- Validación de compilación, que ejecuta la compilación del proyecto de SQL como una comprobación de solicitud de incorporación de cambios antes de la combinación.
- Resolución de comentarios, que requiere que se aborden todos los comentarios de revisión.
- Se incluyen automáticamente los revisores, por lo que se agregan personas específicas a las solicitudes de incorporación de cambios que tocan los archivos de base de datos.
GitHub proporciona protecciones similares a través de reglas de protección de rama o conjuntos de reglas.
Propietarios del código
Un CODEOWNERS archivo (GitHub) o una directiva de revisores incluida automáticamente (Azure DevOps) garantiza que las personas adecuadas revisen los cambios de la base de datos. No se combina ningún archivo SQL sin que el equipo de base de datos lo vea:
# .github/CODEOWNERS
/Database/ @db-team
*.sql @db-team @dba-lead
Esta regla requiere que los miembros de db-team revisen cualquier solicitud de extracción que modifique los archivos SQL o la carpeta del proyecto de base de datos.
Las comprobaciones de control de sucursales
En Azure DevOps, una comprobación de control de rama en las conexiones de servicio restringe las canalizaciones que pueden acceder a las credenciales de producción. Solo las canalizaciones que se ejecutan en el contexto de main obtienen acceso. Incluso si alguien modifica una canalización en una rama de características para apuntar a producción, la conexión de servicio rechaza la solicitud.
Conclusiones clave
Utilice Azure/sql-action (Acciones de GitHub) o SqlAzureDacpacDeployment (Azure DevOps) para implementar archivos .dacpac desde la canalización de CI/CD. Almacene cadenas de conexión y credenciales como secretos de repositorio, secretos de entorno o en Azure Key Vault y nunca codifique de forma hardcode en archivos YAML. Para autenticarse sin almacenar contraseñas, use OpenID Connect (OIDC) con credenciales federadas. Controle las implementaciones de producción con reglas de protección del entorno, los revisores necesarios y restricciones de rama de implementación. Use CODEOWNERS archivos o revisores incluidos automáticamente para asegurarse de que las personas adecuadas revisen los cambios de la base de datos.