Condividi tramite

Creare una pipeline CI/CD di GitHub Actions usando l'interfaccia della riga di comando per sviluppatori di Azure

Questo articolo illustra come usare l'interfaccia della riga di comando per sviluppatori di Azure (azd) per creare una pipeline CI/CD di GitHub Actions per un azd modello. Questa pipeline consente di eseguire il push degli aggiornamenti dei modelli in un repository di codice e di eseguire automaticamente il provisioning e la distribuzione delle modifiche nell'ambiente Azure.

Note

Il azd pipeline config comando è in versione beta. Per informazioni dettagliate, vedere la strategia di controllo delle versioni e rilascio delle funzionalità.

Prerequisites

Inizializzare il modello

Questo esempio usa il modello Hello-AZD , ma è possibile seguire questi passaggi per qualsiasi azd modello che include un file di definizione della .github pipeline (in genere presente nelle cartelle o .azdo ).

  1. In una directory vuota inizializzare il hello-azd modello:

    azd init -t hello-azd

  2. Quando richiesto, immettere un nome per l'ambiente, ad esempio helloazd.

Creare una pipeline con GitHub Actions

Seguire questa procedura per creare e configurare una pipeline:

  1. In un terminale nella radice del modello eseguire:

    azd pipeline config

  2. Quando viene richiesto di selezionare un provider, scegliere GitHub.

    ? Select a provider:  [Use arrows to move, type to filter]
> GitHub
  Azure DevOps

  3. Selezionare la sottoscrizione e l'area di Azure desiderate.

  4. Quando viene richiesto di configurare il repository remoto, scegliere Crea un nuovo repository GitHub privato. Se si ha un progetto esistente che si vuole usare, è anche possibile scegliere Seleziona un progetto GitHub esistente.

    ? How would you like to configure your git remote to GitHub?  [Use arrows to move, type to filter]
  Select an existing GitHub project
> Create a new private GitHub repository
  Enter a remote URL directly

  5. Immettere un nome per il nuovo repository.

  6. Quando viene richiesto di eseguire il commit e il push delle modifiche locali per avviare una nuova esecuzione di GitHub Actions, immettere y.

  7. Esaminare l'output nel terminale. Il azd pipeline config comando visualizza il nome del repository GitHub per il progetto.

    Note

    Per impostazione predefinita, azd pipeline config configura OpenID Connect (OIDC), dette anche credenziali federate . Per usare invece le credenziali client, eseguire azd pipeline config --auth-type client-credentials.

    Le credenziali OIDC/federate non sono supportate per Terraform.

    Altre informazioni sul supporto OIDC in azd.

  8. Nel browser aprire il repository GitHub per il progetto.

  9. Selezionare Azioni per visualizzare il flusso di lavoro in esecuzione.

    Screenshot del flusso di lavoro GitHub in esecuzione.

Testare la pipeline con una modifica del codice

  1. Nella directory del /src/components/pages progetto aprire Home.razor.

  2. Individuare il testo dell'intestazione Hello AZD! nella parte superiore del file.

  3. Modificare il testo in Hello, pipeline!.

  4. Salva il file.

  5. Effettua il commit e il push della modifica. Questa azione attiva la pipeline di GitHub Actions per distribuire l'aggiornamento.

    Screenshot dei passaggi necessari per apportare ed eseguire il commit della modifica al file di test.

  6. Nel browser aprire il repository GitHub del progetto per visualizzare:

    • Your commit
    • Commit dal programma di installazione di GitHub Actions

    Screenshot della modifica di cui è stato eseguito il commit in GitHub.

  7. Selezionare Azioni per visualizzare l'aggiornamento del test che si riflette nel flusso di lavoro.

    Screenshot del flusso di lavoro GitHub in esecuzione dopo l'aggiornamento dei test.

  8. Per visualizzare l'aggiornamento distribuito, visitare l'URL web front-end fornito nell'output azd.

Usare azd come azione GitHub

È possibile eseguire l'installazione azd come azione GitHub usando l'azione setup-azd. Per usarlo, aggiungere quanto segue al .github/workflows/azure-dev.yml file:

on: [push]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Install azd
        uses: Azure/setup-azd@v1.0.0

Note

Controllare le versioni setup-azd per il numero di versione più recente.

Pulire le risorse

Quando le risorse di Azure create in questo articolo non sono più necessarie, eseguire il comando seguente:

azd down

Questo comando rimuove tutte le risorse di Azure associate al progetto.

Next steps

Monitorare l'app usando l'interfaccia della riga di comando per sviluppatori di Azure (azd)

  • Last updated on