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) gebruikt om een CI/CD-pijplijn voor GitHub Actions 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

• De Azure Developer CLI installeren
• 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 uw externe opslagplaats te configureren, kiest u Een nieuwe persoonlijke GitHub-opslagplaats maken. Als u een bestaand project hebt dat u wilt gebruiken, kunt u ook een bestaand GitHub-project selecteren.

   ? 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 Uitvoering van GitHub Actions te starten, voert u het volgende in y.

7. Controleer de uitvoer in de terminal. Met azd pipeline config de opdracht 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, voert u azd pipeline config --auth-type client-credentials uit.

   OIDC/federatieve referenties worden niet geaccepteerd 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 zien draaien.

   

De pijplijn testen met een codewijziging

1. Open /src/components/pages in de directory van Home.razor het project.

2. Zoek de Hello AZD! koptekst boven aan 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:

   • Your commit
   • De doorvoer vanuit GitHub Actions instellen

   

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.

Gebruiken azd als een GitHub-actie

U kunt azd installeren als een GitHub-actie met de setup-azd actie. 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.

Next steps