Inicio rápido: Uso de Acciones de GitHub para conectarse a Azure Database for PostgreSQL

Comienza con Acciones de GitHub utilizando un flujo de trabajo para implementar actualizaciones de bases de datos en Azure Database for PostgreSQL.

Prerrequisitos

Necesitas:

• Una cuenta de Azure con una suscripción activa. Cree una cuenta gratuita.
• Un repositorio de GitHub con datos de ejemplo (data.sql). Si no tiene una cuenta de GitHub, regístrese para obtener una gratis.
• Una instancia de servidor flexible de Azure Database for PostgreSQL.
• Crear una base de datos de Azure para PostgreSQL.

Información general sobre el archivo de flujo de trabajo

Un flujo de trabajo de Acciones de GitHub se define mediante un archivo YAML (.yml) en la ruta de acceso /.github/workflows/ de su repositorio. En esta definición se incluyen los diversos pasos y parámetros que componen el flujo de trabajo.

El archivo tiene dos secciones:

Genere las credenciales de implementación.

Copia la cadena de conexión de Azure Database for PostgreSQL

En Azure Portal, vaya a la instancia de servidor flexible de Azure Database for PostgreSQL y, en el menú de recursos, en Configuración, seleccione Conectar. En esa página, use el cuadro combinado Nombre de base de datos para seleccionar el nombre de la base de datos a la que desea conectarse. Expanda la sección Conectar desde su aplicación y copie la cadena de conexión ADO.NET, y sustituya el valor del marcador de posición {your_password} por su contraseña real. La cadena de conexión se parece a esto.

Server={servername.postgres.database.azure.com};Database={your_database};Port=5432;User Id={adminusername};Password={your_password};Ssl Mode=Require;

Use la cadena de conexión como secreto de GitHub.

Configuración de los secretos de GitHub

Agregar el flujo de trabajo

1. Vaya a la opción de Acciones del repositorio de GitHub.

2. Seleccione Set up your workflow yourself (Configure el flujo de trabajo usted mismo).

3. Elimine todo lo que aparezca después de la sección on: del archivo de flujo de trabajo. Por ejemplo, el flujo de trabajo restante puede tener el siguiente aspecto.

   name: CI
   
   on:
   push:
       branches: [ main ]
   pull_request:
       branches: [ main ]
   

4. Cambie el nombre del flujo de trabajo PostgreSQL for GitHub Actions y agregue las acciones de restauración e inicio de sesión. Estas acciones verifican el código de tu sitio y se autentican con Azure usando los secretos de GitHub que creó anteriormente.

   • OpenID Connect
   • Entidad de servicio

   name: PostgreSQL for GitHub Actions
   
   on:
   push:
       branches: [ main ]
   pull_request:
       branches: [ main ]
   
   jobs:
   build:
       runs-on: ubuntu-latest
       steps:
       - uses: actions/checkout@v1
       - uses: azure/login@v2
       with:
           client-id: ${{ secrets.AZURE_CLIENT_ID }}
           tenant-id: ${{ secrets.AZURE_TENANT_ID }}
           subscription-id: ${{ secrets.AZURE_SUBSCRIPTION_ID }}
   

5. Use la acción de implementación de Azure PostgreSQL para conectarse a la instancia de servidor flexible de Azure Database for PostgreSQL. Reemplace POSTGRESQL_SERVER_NAME por el nombre del servidor. Debe tener un archivo de datos de Azure Database for PostgreSQL denominado data.sql en el nivel raíz del repositorio.

    - uses: azure/postgresql@v1
      with:
       connection-string: ${{ secrets.AZURE_POSTGRESQL_CONNECTION_STRING }}
       server-name: POSTGRESQL_SERVER_NAME
       plsql-file: './data.sql'
   

6. Para completar el flujo de trabajo, agregue una acción al cierre de sesión de Azure. Este es el flujo de trabajo completado. El archivo aparece en la carpeta .github/workflows del repositorio.

   • OpenID Connect
   • Entidad de servicio

   name: PostgreSQL for GitHub Actions
   
   on:
   push:
       branches: [ main ]
   pull_request:
       branches: [ main ]
   
   
   jobs:
   build:
       runs-on: ubuntu-latest
       steps:
       - uses: actions/checkout@v1
       - 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/postgresql@v1
     with:
       server-name: POSTGRESQL_SERVER_NAME
       connection-string: ${{ secrets.AZURE_POSTGRESQL_CONNECTION_STRING }}
       plsql-file: './data.sql'
   
       # Azure logout
   - name: logout
     run: |
        az logout
   

Revisar la implementación

1. Vaya a la opción de Acciones del repositorio de GitHub.

2. Abra el primer resultado para ver los registros detallados de la ejecución del flujo de trabajo.

   

Limpieza de recursos

Cuando la base de datos y el repositorio de Azure Database for PostgreSQL ya no sean necesarios, limpie los recursos implementados mediante la eliminación del grupo de recursos y el repositorio de GitHub.

Contenido relacionado

• Integración de Azure y GitHub.
• Cómo conectarse al servidor.