Een Azure DevOps CI/CD-pijplijn maken met behulp van de Azure Developer CLI

In dit artikel wordt beschreven hoe u de Azure Developer CLI (azd) gebruikt om een CI/CD-pijplijn te maken met Azure DevOps-pijplijnen (Azure-pipelines) voor een sjabloon azd. Met de pijplijn kunt u updates naar een codeopslagplaats pushen en uw wijzigingen automatisch inrichten en implementeren in uw Azure-omgeving.

Vereiste voorwaarden

• Installeer de Azure Developer CLI.
• Visual Studio Code geïnstalleerd.

De sjabloon initialiseren

In dit voorbeeld wordt de Hello-AZD-sjabloon gebruikt, maar u kunt deze stappen volgen voor elke sjabloon die een pijplijndefinitiebestand bevat (te vinden in de .github of .azdo mappen).

1. Initialiseer de hello-azd sjabloon in een lege map:

   azd init -t hello-azd
   

2. Voer een naam in voor de omgeving (bijvoorbeeld hello-azd).

Azure-pipelines instellen

Een Azure-pipelines organisatie maken of gebruiken

Als u Azure-pipelines wilt gebruiken, hebt u een organisatie nodig. Maak er een op https://dev.azure.com als u er nog geen hebt.

Een persoonlijk toegangstoken maken (PAT)

Voor de Azure Developer CLI is een persoonlijk toegangstoken (PAT) vereist om Azure-pipelines te configureren. Maak een nieuwe PAT met de volgende machtigingen:

• Agentpools (lezen, beheren)
• Compileren (lezen en uitvoeren)
• Code (volledig)
• Het project en het team (lezen, schrijven en beheren)
• Release (lezen, schrijven, uitvoeren en beheren)
• Serviceverbindingen (lezen, query's uitvoeren en beheren)

De pijplijn configureren

1. Voer de volgende opdracht uit om een Azure-pipelines project en opslagplaats te configureren met een implementatiepijplijn:

   azd pipeline config --provider azdo
   

   Opmerking

   Standaard gebruikt azd pipeline config voor Azure-pipelines OIDC-referenties (federatieve referenties), zodat er geen clientsecret wordt aangemaakt of opgeslagen. Als u in plaats daarvan clientaanmeldingsgegevens wilt gebruiken, geeft u --auth-type client-credentials op. Meer informatie over OIDC-ondersteuning in azd.

2. Reageer op de aanwijzingen:

   • Persoonlijk toegangstoken (PAT):

     • Plak uw PAT.

     • U kunt uw PAT desgewenst exporteren als een omgevingsvariabele van het systeem om herhaalde prompts te voorkomen:

       export AZURE_DEVOPS_EXT_PAT=<PAT>
       

   • Azure-pipelines organisatienaam:

     • Voer de naam van uw organisatie in. Deze waarde wordt opgeslagen in het .env bestand voor de huidige omgeving.

   • Er is geen 'remote' met de naam 'origin' gevonden. Wilt u er een configureren?

     • Ja

   • Hoe wilt u uw project configureren?

     • Een nieuw Azure-pipelines Project maken

   • De naam voor uw nieuwe Azure-pipelines Project OR Druk op Enter om deze naam te gebruiken: ({default name} )

     • Selecteer Enter of maak een unieke projectnaam.

   • Wilt u uw lokale wijzigingen doorvoeren en pushen om de geconfigureerde CI-pijplijn te starten?

     • Ja

3. Als u de build wilt controleren, gaat u naar uw project in de Azure-pipelines-portal (https://dev.azure.com).

Een codewijziging maken en pushen

1. In de /src/components/pages map open Home.razor.

2. Wijzig de Hello AZD! koptekst in Hello, pipeline! en sla het bestand op.

3. Maak een vertakking en voer uw wijziging door. De main vertakking is beveiligd, dus push uw wijzigingen vanuit een nieuwe vertakking en maak een pull-aanvraag in Azure-pipelines. De pull-aanvraag activeert de pijplijn en blokkeert samenvoegen als de pijplijn mislukt.

4. Keur uw pull-aanvraag goed en voeg deze samen om de pijplijn opnieuw te starten.

   

5. Open in uw browser de opslagplaats van uw project om uw doorvoer en de Azure Pipeline-uitvoering te zien.

   

6. Ga naar de front-end-URL van het web om de update te controleren.

Gebruik azd als een Azure-pipelines taak

Voeg azd toe als een Azure-pipelines taak om azd in uw pijplijn te installeren. Voeg het volgende toe aan .azdo/pipelines/azure-dev.yml:

trigger:
  - main
  - master

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

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

De hulpbronnen opschonen

Wanneer u de Azure resources die in dit artikel zijn gemaakt niet meer nodig hebt, voert u het volgende uit:

azd down

Volgende stappen