Guida introduttiva: Usare GitHub Actions per connettersi al server flessibile Database di Azure per PostgreSQL

Introduzione a GitHub Actions usando un flusso di lavoro per distribuire gli aggiornamenti del database in Database di Azure per PostgreSQL.

Prerequisiti

È necessario:

• Un account Azure con una sottoscrizione attiva. Creare un account gratuito.
• Un repository GitHub con i dati di esempio (data.sql). Se non si ha un account GitHub, è possibile iscriversi gratuitamente.
• Un server flessibile di Database di Azure per PostgreSQL.
• Creare un server flessibile di Database di Azure per PostgreSQL.

Panoramica dei file del flusso di lavoro

Un flusso di lavoro GitHub Actions viene definito da un file YAML (con estensione yml) nel percorso /.github/workflows/ del repository. Questa definizione contiene i vari passaggi e i parametri che costituiscono il flusso di lavoro.

Il file è costituito da due sezioni:

Generare le credenziali per la distribuzione

Copiare la stringa di connessione del Database Azure per PostgreSQL

Nel portale di Azure, vai al tuo server flessibile di Database di Azure per PostgreSQL. Dal menu della risorsa, in Impostazioni, selezionare Connetti. In tale pagina utilizzare la casella combinata Nome database per selezionare il nome del database a cui connettersi. Espandere la sezione Connetti dalla tua app e copiare il stringa di connessione ADO.NET. Sostituire il valore segnaposto {your_password} con la password effettiva. La stringa di connessione è simile a questa.

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

Usa la stringa di connessione come segreto di GitHub.

Configurare i segreti GitHub

Aggiungere il flusso di lavoro

1. Passare ad Actions per il repository GitHub.

2. Selezionare Set up your workflow yourself (Configurare manualmente il flusso di lavoro).

3. Eliminare tutti quello che segue la sezione on: del file del flusso di lavoro. Ad esempio, il flusso di lavoro rimanente può essere simile al codice seguente.

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

4. Rinominare il flusso di lavoro PostgreSQL for GitHub Actions e aggiungere le azioni di checkout e accesso. Queste azioni controllano il codice del sito ed eseguono l'autenticazione con Azure usando i segreti GitHub creati in precedenza.

   • OpenID Connect
   • Service Principal

   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. Usa l'azione Azure PostgreSQL Deploy per connetterti al server flessibile di Database di Azure per PostgreSQL. Sostituire POSTGRESQL_SERVER_NAME con il nome del server. Dovrebbe essere presente un file di dati di Database di Azure per PostgreSQL denominato data.sql a livello radice del repository.

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

6. Completare il flusso di lavoro aggiungendo un'azione di disconnessione da Azure. Ecco il flusso di lavoro completato. Il file verrà visualizzato nella cartella .github/workflows del repository.

   • OpenID Connect
   • Service Principal

   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
   

Esaminare la distribuzione

1. Passare ad Actions per il repository GitHub.

2. Aprire il primo risultato per visualizzare i log dettagliati dell'esecuzione del flusso di lavoro.

   

Pulire le risorse

Quando il database e il repository di Database di Azure per PostgreSQL non sono più necessari, pulire le risorse distribuite eliminando il gruppo di risorse e il repository GitHub.

Contenuti correlati

• Integrazione di Azure e GitHub.
• Come connettersi al server.