Skapa en Ci/CD-pipeline för GitHub Actions med Hjälp av Azure Developer CLI

I den här artikeln får du lära dig hur du använder Azure Developer CLI (azd) för att skapa en Ci/CD-pipeline för GitHub Actions för en azd mall. Med den här pipelinen kan du skicka malluppdateringar till en kodlagringsplats och få ändringarna automatiskt etablerade och distribuerade till din Azure-miljö.

Prerequisites

• Installera Azure Developer CLI
• Visual Studio Code (valfritt för redigering av filer)
• Ett GitHub-konto
• En prenumeration på Azure

Initiera mallen

I det här exemplet används Hello-AZD-mallen , men du kan följa dessa steg för alla azd mallar som innehåller en pipelinedefinitionsfil (finns vanligtvis i mapparna .github eller .azdo ).

1. Initiera mallen i hello-azd en tom katalog:

   azd init -t hello-azd
   

2. När du uppmanas till det anger du ett namn för miljön, till exempel helloazd.

Skapa en pipeline med GitHub Actions

Följ dessa steg för att skapa och konfigurera en pipeline:

1. Kör följande i en terminal i mallens rot:

   azd pipeline config
   

2. När du uppmanas att välja en provider väljer du GitHub.

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

3. Välj önskad Azure-prenumeration och region.

4. När du uppmanas att konfigurera fjärrlagringsplatsen väljer du Skapa en ny privat GitHub-lagringsplats. Om du har ett befintligt projekt som du vill använda kan du också välja Välj ett befintligt GitHub-projekt.

   ? 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. Ange ett namn för den nya lagringsplatsen.

6. När du uppmanas att checka in och push-överföra dina lokala ändringar för att starta en ny GitHub Actions-körning anger du y.

7. Granska utdata i terminalen. Kommandot azd pipeline config visar GitHub-lagringsplatsens namn för projektet.

   Note

   Som standard azd pipeline config konfigurerar OpenID Connect (OIDC), även kallat federerade autentiseringsuppgifter. Om du vill använda klientautentiseringsuppgifter i stället kör du azd pipeline config --auth-type client-credentials.

   OIDC/federerade autentiseringsuppgifter stöds inte för Terraform.

   Läs mer om OIDC-stöd i azd.

8. Öppna GitHub-lagringsplatsen för projektet i webbläsaren.

9. Välj Åtgärder för att se arbetsflödet köras.

   

Testa pipelinen med en kodändring

1. Öppna /src/components/pages i projektets Home.razor-katalog.

2. Leta upp rubriktexten Hello AZD! längst upp i filen.

3. Ändra texten till Hello, pipeline!.

4. Spara filen.

5. Checka in och push-överför ändringen. Den här åtgärden utlöser GitHub Actions-pipelinen för att distribuera uppdateringen.

   

6. Öppna projektets GitHub-lagringsplats i webbläsaren för att se:

   • Your commit
   • Incheckningen från GitHub Actions-konfigurationen

   

7. Välj Åtgärder för att se testuppdateringen som visas i arbetsflödet.

   

8. För att visa den distribuerade uppdateringen, besök webbfrontendens URL som anges i azd resultatet.

Använda azd som en GitHub-åtgärd

Du kan installera azd som en GitHub-åtgärd med hjälp av åtgärden setup-azd. Om du vill använda den lägger du till följande i .github/workflows/azure-dev.yml filen:

on: [push]

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

Rensa resurser

När du inte längre behöver de Azure-resurser som skapats i den här artikeln kör du följande kommando:

azd down

Det här kommandot tar bort alla Azure-resurser som är associerade med projektet.

Next steps