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

In dit artikel leert u hoe u de Azure Developer CLI (azd) kunt gebruiken om een GitHub Actions CI/CD-pijplijn te maken voor een azd-sjabloon. Met deze pijplijn kunt u sjabloonupdates naar een codeopslagplaats pushen en uw wijzigingen automatisch inrichten en implementeren in uw Azure-omgeving.

Prerequisites

• Install the Azure Developer CLI
• Visual Studio Code (optioneel voor het bewerken van bestanden)
• Een GitHub-account
• Een Azure-abonnement

De sjabloon initialiseren

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

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

   azd init -t hello-azd
   

2. Wanneer u hierom wordt gevraagd, voert u een naam in voor de omgeving, zoals helloazd.

Een pijplijn maken met GitHub Actions

Volg deze stappen om een pijplijn te maken en te configureren:

1. Open een terminal in de hoofdmap van uw sjabloon en voer het volgende uit:

   azd pipeline config
   

2. Wanneer u wordt gevraagd om een provider te selecteren, kiest u GitHub.

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

3. Selecteer uw gewenste Azure abonnement en regio.

4. Wanneer u wordt gevraagd om de externe opslagplaats te configureren, kiest u Maak een nieuwe persoonlijke GitHub opslagplaats. Als u een bestaand project hebt dat u wilt gebruiken, kunt u ook kiezen Selecteer een bestaand GitHub project.

   ? 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. Voer een naam in voor de nieuwe opslagplaats.

6. Wanneer u wordt gevraagd uw lokale wijzigingen door te voeren en te pushen om een nieuwe GitHub Actions uit te voeren, voert u y in.

7. Controleer de uitvoer in de terminal. Met de opdracht azd pipeline config wordt de naam van de GitHub opslagplaats voor uw project weergegeven.

   Note

   azd pipeline config Configureert standaard OpenID Connect (OIDC), ook wel federatieve referenties genoemd. Als u in plaats daarvan clientreferenties wilt gebruiken, voer azd pipeline config --auth-type client-credentials uit.

   OIDC/federatieve referenties worden niet ondersteund voor Terraform.

   Meer informatie over OIDC-ondersteuning in azd.

8. Open in uw browser de GitHub opslagplaats voor uw project.

9. Selecteer Acties om de werkstroom te bekijken.

   

De pijplijn testen met een codewijziging

1. Open in de map van het project /src/components/pagesHome.razor.

2. Zoek de Hello AZD! koptekst bovenaan het bestand.

3. Wijzig de tekst in Hello, pipeline!.

4. Sla het bestand op.

5. Voer uw wijziging door en push deze. Met deze actie wordt de GitHub Actions-pijplijn geactiveerd om de update te implementeren.

   

6. Open in uw browser de GitHub opslagplaats van uw project om het volgende te zien:

   • Uw doorvoer
   • De doorvoering vanuit GitHub Actions setup

   

7. Selecteer Acties om de testupdate weer te geven die in de werkstroom wordt weergegeven.

   

8. Als u de geïmplementeerde update wilt weergeven, gaat u naar de front-end-URL van het web die in de azd uitvoer is opgegeven.

Gebruik azd als een GitHub actie

U kunt azd installeren als een GitHub-actie met behulp van de setup-azd action. Als u dit wilt gebruiken, voegt u het volgende toe aan uw .github/workflows/azure-dev.yml bestand:

on: [push]

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

De hulpbronnen opschonen

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

azd down

Met deze opdracht verwijdert u alle Azure resources die aan uw project zijn gekoppeld.

Volgende stappen