GitHub Actions configureren met Azure CLI in Azure Container Apps

Met Azure Container Apps kunt u GitHub Actions gebruiken om revisies naar uw container-app te publiceren. Wanneer doorvoeringen naar uw GitHub-opslagplaats worden gepusht, wordt een Werkstroom voor GitHub Actions geactiveerd waarmee de containerinstallatiekopieën in het containerregister worden bijgewerkt. Zodra de container in het register is bijgewerkt, maakt Azure Container Apps een nieuwe revisie op basis van de bijgewerkte containerinstallatiekopieën.

De GitHub Actions-werkstroom wordt uitgevoerd wanneer er doorvoeringen zijn naar een specifieke vertakking in uw opslagplaats. U kiest welke vertakking de actie activeert bij het instellen van de werkstroom.

In dit artikel leest u hoe u een eenvoudige GitHub Actions-werkstroom genereert met Azure CLI. Zie Implementeren in Azure Container Apps met GitHub Actions om uw eigen werkstroom te maken die u volledig kunt aanpassen.

Verificatie

Wanneer u een GitHub Actions-integratie toevoegt of verwijdert, kunt u zich verifiëren door een persoonlijk GitHub-toegangstoken door te geven of de interactieve GitHub-aanmeldingservaring te gebruiken. De interactieve ervaring opent een formulier in uw webbrowser en biedt u de mogelijkheid om u aan te melden bij GitHub. Nadat de verificatie is geslaagd, wordt een token doorgestuurd naar de CLI die door GitHub wordt gebruikt voor de rest van de huidige sessie.

• Als u een persoonlijk toegangstoken wilt doorgeven, gebruikt u de --token parameter en geeft u een tokenwaarde op.
• Als u ervoor kiest om interactieve aanmelding te gebruiken, gebruikt u de --login-with-github parameter zonder waarde.

Notitie

Uw persoonlijke GitHub-toegangstoken moet het workflow bereik hebben geselecteerd.

Toevoegen

Met de containerapp github-action add opdracht maakt u een GitHub Actions-integratie met uw container-app.

Notitie

Voordat u verdergaat met het opgegeven voorbeeld, moet uw eerste container-app al zijn geïmplementeerd.

De eerste keer dat u GitHub Actions aan uw container-app koppelt, moet u een service-principalcontext opgeven. In de volgende opdracht ziet u hoe u een service-principal maakt.

Bash

az ad sp create-for-rbac \
  --name <SERVICE_PRINCIPAL_NAME> \
  --role "contributor" \
  --scopes /subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP_NAME>

Powershell

az ad sp create-for-rbac `
  --name <SERVICE_PRINCIPAL_NAME> `
  --role "contributor" `
  --scopes /subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP_NAME> 

Wanneer u met dit voorbeeld werkt, vervangt u de tijdelijke aanduidingen tussen <> uw waarden.

De retourwaarden van deze opdracht bevatten de waarden van appIdde service-principal, passworden tenant. U moet deze waarden doorgeven aan de az containerapp github-action add opdracht.

In het volgende voorbeeld ziet u hoe u een integratie toevoegt terwijl u een persoonlijk toegangstoken gebruikt.

Bash

az containerapp github-action add \
  --repo-url "https://github.com/<OWNER>/<REPOSITORY_NAME>" \
  --context-path "./dockerfile" \
  --branch <BRANCH_NAME> \
  --name <CONTAINER_APP_NAME> \
  --resource-group <RESOURCE_GROUP> \
  --registry-url <URL_TO_CONTAINER_REGISTRY> \
  --registry-username <REGISTRY_USER_NAME> \
  --registry-password <REGISTRY_PASSWORD> \
  --service-principal-client-id <appId> \
  --service-principal-client-secret <password> \
  --service-principal-tenant-id <tenant> \
  --token <YOUR_GITHUB_PERSONAL_ACCESS_TOKEN>

Powershell

az containerapp github-action add `
  --repo-url "https://github.com/<OWNER>/<REPOSITORY_NAME>" `
  --context-path "./dockerfile" `
  --branch <BRANCH_NAME> `
  --name <CONTAINER_APP_NAME> `
  --resource-group <RESOURCE_GROUP> `
  --registry-url <URL_TO_CONTAINER_REGISTRY> `
  --registry-username <REGISTRY_USER_NAME> `
  --registry-password <REGISTRY_PASSWORD> `
  --service-principal-client-id <appId> `
  --service-principal-client-secret <password> `
  --service-principal-tenant-id <tenant> `
  --token <YOUR_GITHUB_PERSONAL_ACCESS_TOKEN>

Wanneer u met dit voorbeeld werkt, vervangt u de tijdelijke aanduidingen tussen <> uw waarden.

Weergeven

De containerapp github-action show opdracht retourneert de configuratie-instellingen voor GitHub Actions voor een container-app.

In dit voorbeeld ziet u hoe u een integratie toevoegt terwijl u het persoonlijke toegangstoken gebruikt.

Bash

az containerapp github-action show \
  --resource-group <RESOURCE_GROUP_NAME> \
  --name <CONTAINER_APP_NAME>

Powershell

az containerapp github-action show `
  --resource-group <RESOURCE_GROUP_NAME> `
  --name <CONTAINER_APP_NAME>

Wanneer u met dit voorbeeld werkt, vervangt u de tijdelijke aanduidingen tussen <> uw waarden.

Met deze opdracht wordt een JSON-nettolading geretourneerd met de configuratie-instellingen voor GitHub Actions-integratie.

Delete

Met containerapp github-action delete de opdracht worden de GitHub Actions uit de container-app verwijderd.

Bash

az containerapp github-action delete \
  --resource-group <RESOURCE_GROUP_NAME> \
  --name <CONTAINER_APP_NAME> \
  --token <YOUR_GITHUB_PERSONAL_ACCESS_TOKEN>

Powershell

az containerapp github-action delete `
  --resource-group <RESOURCE_GROUP_NAME> `
  --name <CONTAINER_APP_NAME> `
  --token <YOUR_GITHUB_PERSONAL_ACCESS_TOKEN>

Wanneer u met dit voorbeeld werkt, vervangt u de tijdelijke aanduidingen tussen <> uw waarden.