Delen via

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.

Note

De azd pipeline config opdracht bevindt zich in bèta. Zie de strategie voor functieversiebeheer en release voor meer informatie.

Prerequisites

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.

    Schermopname van de actieve GitHub-werkstroom.

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.

    Schermopname van de stappen die nodig zijn om een wijziging in het testbestand aan te brengen en door te voeren.

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

    • Your commit
    • De doorvoer vanuit GitHub Actions instellen

    Schermopname van uw doorgevoerde wijziging in GitHub.

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

    Schermopname van de GitHub-werkstroom die wordt uitgevoerd na de testupdate.

  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

Note

Controleer de setup-azd-releases op het meest recente versienummer.

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

Uw app bewaken met behulp van Azure Developer CLI (azd)

  • Last updated on