Condividi tramite


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

** Questo articolo illustra come utilizzare la CLI di Azure Developer (azd) per creare una pipeline CI/CD con Azure DevOps Pipelines (Azure Pipelines) per un modello azd. La pipeline consente di eseguire il push degli aggiornamenti in un repository di codice e di eseguire automaticamente il provisioning e la distribuzione delle modifiche nell'ambiente Azure.

Annotazioni

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

Prerequisiti

Inizializzare il modello

Questo esempio usa il modello Hello-AZD , ma è possibile seguire questa procedura per qualsiasi modello che includa un file di definizione della .github pipeline (disponibile 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 hello-azd.

Configurare Azure Pipelines

Annotazioni

Se si usa Azure Pipelines per un modello di Java in Windows, vedere la guida alla risoluzione dei problemi.

Creare o usare un'organizzazione Azure Pipelines

Per usare Azure Pipelines, è necessaria un'organizzazione. Crearne uno in https://dev.azure.com se non ne hai già uno.

Creare un token di accesso personale

L'interfaccia della riga di comando di Azure Developer richiede un token di accesso personale (PAT) per configurare Azure Pipelines. Creare un nuovo pat con gli ambiti seguenti:

  • Pool di agenti (leggere, gestire)
  • Compilazione (lettura ed esecuzione)
  • Codice (completo)
  • Progetto e team (lettura, scrittura e gestione)
  • Rilascio (lettura, scrittura, esecuzione e gestione)
  • Connessioni al servizio (lettura, interrogazione e gestione)

Configurare la pipeline

  1. Eseguire il comando seguente per configurare un progetto e un repository Azure Pipelines con una pipeline di distribuzione:

    azd pipeline config --provider azdo
    

    Annotazioni

    Per impostazione predefinita, azd pipeline config per Azure Pipelines usa le credenziali client. Le credenziali OIDC/federate non sono attualmente supportate. Altre informazioni sul supporto OIDC in azd.

  2. Rispondere alle richieste:

    • Token di accesso personale:

      • Incolla il PAT.

      • Facoltativamente, esportare il pat come variabile di ambiente di sistema per evitare richieste ripetute:

        export AZURE_DEVOPS_EXT_PAT=<PAT>
        
    • Nome organizzazione di Azure Pipelines:

      • Immetti il nome dell'organizzazione. Questo valore viene salvato nel .env file per l'ambiente corrente.
    • Non è stato trovato un "remote" denominato "origin". Si vuole configurare una?

    • Come si vuole configurare il progetto?

      • Creare un nuovo progetto Azure Pipelines
    • Immettere il nome per il nuovo progetto di Azure Pipelines O Premere INVIO per usare questo nome: ( {nome predefinito} )

      • Selezionare Invio oppure creare un nome di progetto univoco.
    • Ti piacerebbe eseguire il commit e il push delle modifiche locali per avviare la pipeline CI configurata?

  3. Per verificare la compilazione, passare al tuo progetto nel portale di Azure Pipelines (https://dev.azure.com).

Apportare e inviare una modifica del codice

  1. Nella directory /src/components/pages, apri Home.razor.

  2. Modificare il testo dell'intestazione Hello AZD! in Hello, pipeline! e salvare il file.

  3. Crea un ramo e effettua il commit della modifica. Il ramo main è protetto, quindi eseguire il push delle modifiche da un nuovo ramo e creare una richiesta pull in Azure Pipelines. La pull request attiva la pipeline e blocca il merge se la pipeline non riesce.

  4. Approva e integra la tua richiesta pull per riavviare la pipeline.

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

  5. Nel browser aprire il repository del progetto per visualizzare il commit e l'esecuzione della pipeline Azure.

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

  6. Visitare l'URL dell'interfaccia web per verificare l'aggiornamento.

Usare azd come attività di Azure Pipelines

Aggiungere azd come attività di Azure Pipelines per installare azd nella pipeline. Aggiungere quanto segue a .azdo/pipelines/azure-dev.yml:

trigger:
  - main
  - branch

pool:
  vmImage: ubuntu-latest
  # vmImage: windows-latest

steps:
  - task: setup-azd@0
    displayName: Install azd

Pulire le risorse

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

azd down

Passaggi successivi