Kontinuerlig distribution till Azure App Service

Kommentar

Från och med den 1 juni 2024 har alla nyligen skapade App Service-appar möjlighet att generera ett unikt standardvärdnamn med hjälp av namngivningskonventionen <app-name>-<random-hash>.<region>.azurewebsites.net. Befintliga appnamn förblir oförändrade.

Exempel: myapp-ds27dh7271aah175.westus-01.azurewebsites.net

Mer information finns i Unikt standardvärdnamn för App Service-resurs.

Azure App Service möjliggör kontinuerlig distribution från GitHub-, Bitbucket- och Azure Repos-lagringsplatser genom att hämta de senaste uppdateringarna.

Förbereda lagringsplatsen

Om du vill hämta automatiserade versioner från Azure App Service-byggservern kontrollerar du att lagringsplatsens rot har rätt filer i projektet.

Körmiljö	Rotkatalogfiler
ASP.NET (endast Windows)	*.sln, *.csproj eller default.aspx
ASP.NET Core	*.sln eller *.csproj
PHP	index.php
Ruby (endast Linux)	Gemfile
Node.js	server.js, app.jseller package.json med ett startskript
Python	*.py, requirements.txt eller runtime.txt
HTML	default.htm, default.html, default.asp, index.htm, index.html, eller iisstart.htm
WebJobs	<job_name>/run.<extension> under App_Data/jobs/continuous för kontinuerliga webbjobb eller App_Data/jobs/triggered för utlösta webbjobb. Mer information finns i Dokumentation om Kudu WebJobs.
Funktioner	Se Kontinuerlig distribution för Azure Functions.

Om du vill anpassa distributionen tar du med en .distributionsfil i lagringsplatsens rot. Mer information finns i Anpassa distributioner och Anpassat distributionsskript.

Kommentar

Om du använder Visual Studio kan du låta Visual Studio skapa en lagringsplats åt dig. Projektet är omedelbart redo för distribution via Git.

Konfigurera distributionskällan

1. I Azure-portalen går du till hanteringssidan för din App Service-app.

2. I den vänstra rutan väljer du Distributionscenter. Välj sedan Inställningar.

3. I rutan Källa väljer du något av CI/CD-alternativen:

   

Välj den flik som motsvarar din byggleverantör för att fortsätta.

GitHub

4. GitHub Actions är standardversionsprovidern. Om du vill ändra providern väljer du Ändra provider>App Service Build Service>OK.

5. Om du distribuerar från GitHub för första gången väljer du Auktorisera och följer auktoriseringsanvisningarna. Om du vill distribuera från en annan användares lagringsplats väljer du Ändra konto.

6. När du har auktorisera ditt Azure-konto med GitHub väljer du den organisation, lagringsplats och gren som du vill använda.

   Om du inte hittar en organisation eller lagringsplats kan du behöva aktivera fler behörigheter på GitHub. Mer information finns i Hantera åtkomst till organisationens lagringsplatser.

7. Under Autentiseringstyp väljer du Användartilldelad identitet för bättre säkerhet. Mer information finns i vanliga frågor och svar.

   Kommentar

   Om ditt Azure-konto har de behörigheter som krävs för alternativet Användartilldelad identitet skapar Azure en användartilldelad hanterad identitet åt dig. Om du inte gör det kan du samarbeta med Azure-administratören för att skapa en identitet med den roll som krävs för din app och sedan välja den här i listrutan.

8. (Valfritt) Om du vill se filen innan du sparar ändringarna väljer du Förhandsgranska fil. App Service väljer en arbetsflödesmall baserat på språkstackens inställning för din app och checkar in den i din valda GitHub-lagringsplats.

9. Välj Spara.

   Nya incheckningar i den valda lagringsplatsen och grenen distribueras nu kontinuerligt till din App Service-app. Du kan spåra incheckningar och distributioner på fliken Loggar .

Bitbucket

Bitbucket-integreringen använder App Service Build Services för byggautomatisering.

4. Om du distribuerar från Bitbucket för första gången väljer du Auktorisera och följer auktoriseringsanvisningarna. Om du vill distribuera från en annan användares lagringsplats väljer du Ändra konto.

5. För Bitbucket väljer du bitbucket-teamet, lagringsplatsen och grenen som du vill distribuera kontinuerligt.

6. Välj Spara.

   Nya incheckningar i den valda lagringsplatsen och grenen distribueras nu kontinuerligt till din App Service-app. Du kan spåra incheckningar och distributioner på fliken Loggar .

Lokal Git

Se Lokal Git-distribution till Azure App Service.

Azure-lagringsplatser

4. App Service Build Service är standardversionsprovidern.

   Kommentar

   Om du vill använda Azure Pipelines som byggleverantör för din App Service-app konfigurerar du den direkt från Azure Pipelines. Konfigurera den inte i App Service. Alternativet Azure Pipelines pekar dig bara i rätt riktning.

5. Välj den Azure DevOps-organisation, projekt, lagringsplats och gren som du vill distribuera kontinuerligt.

   Om din DevOps-organisation inte finns med i listan är den ännu inte länkad till din Azure-prenumeration. Mer information finns i Skapa en Azure-tjänstanslutning.

Andra lagringsplatser

För Windows-appar kan du manuellt konfigurera kontinuerlig distribution från en Git- eller Mercurial-molnlagringsplats som portalen inte har direkt stöd för, till exempel GitLab. Det gör du genom att välja Extern Git i listrutan Källa . Mer information finns i Konfigurera kontinuerlig distribution med hjälp av manuella steg.

Inaktivera kontinuerlig distribution

1. I Azure-portalen går du till hanteringssidan för din App Service-app.

2. I den vänstra rutan väljer du Distributionscenter. Välj sedan Inställningar>Koppla från:

   

3. Som standard bevaras GitHub Actions-arbetsflödesfilen på lagringsplatsen, men den fortsätter att utlösa distributionen till din app. Om du vill ta bort filen från lagringsplatsen väljer du Ta bort arbetsflödesfil.

4. Välj OK.

Vilka är byggleverantörerna?

Beroende på distributionskällan i Distributionscenter kan du se några alternativ att välja för byggleverantörer. Byggleverantörer hjälper dig att skapa en CI/CD-lösning med Azure App Service genom att automatisera kompilering, testning och distribution.

Du är inte begränsad till de alternativ för byggprovider som finns i Distributionscenter, men Med App Service kan du konfigurera dem snabbt och erbjuder en del integrerad distributionsloggning.

GitHub Actions

GitHub Actions-byggprovidern är endast tillgänglig för GitHub-distribution. När den konfigureras från appens distributionscenter slutför den dessa åtgärder för att konfigurera CI/CD:

• Sätter in en GitHub Actions-arbetsflödesfil på din GitHub-lagringsplats för att hantera bygg- och distributionsuppgifter till App Service.
• För grundläggande autentisering lägger du till publiceringsprofilen för din app som en GitHub-hemlighet. Arbetsflödesfilen använder den här hemligheten för att autentisera med App Service.
• Information om användartilldelad identitet finns i Vad gör det användartilldelade identitetsalternativet för GitHub Actions?
• Samlar in information från arbetsflödets körningsloggar och visar den på fliken Loggar i Distributionscenter.

Du kan anpassa GitHub Actions-byggprovidern på följande sätt:

• Anpassa arbetsflödesfilen när den har genererats på din GitHub-lagringsplats. Mer information finns i Arbetsflödessyntax för GitHub Actions. Se bara till att arbetsflödet distribueras till App Service med åtgärden azure/webapps-deploy .
• Om den valda grenen är skyddad kan du fortfarande förhandsgranska arbetsflödesfilen utan att spara konfigurationen och sedan lägga till den manuellt i lagringsplatsen. Den här metoden ger dig inte loggintegrering med Azure-portalen.
• I stället för att använda grundläggande autentisering eller en användartilldelad identitet kan du även distribuera med hjälp av tjänstens huvudnamn i Microsoft Entra-ID. Detta kan inte konfigureras i portalen.

App Service Build Service

Kommentar

App Service Build Service kräver grundläggande SCM-autentisering för att webhooken ska fungera. Mer information finns i Distribution utan grundläggande autentisering.

App Service Build Service är distributions- och byggmotorn som är inbyggd i App Service, även kallad Kudu. När det här alternativet har valts lägger App Service till en webhook på den lagringsplats som du har auktoriserat. All kod som skickas till lagringsplatsen utlöser webhooken, och App Service hämtar ändringarna till lagringsplatsen och utför eventuella distributionsuppgifter. Mer information finns i Distribuera från GitHub (Kudu).

Resurser:

• Undersöka vanliga problem med kontinuerlig distribution
• Kudu-projektet

Azure Pipelines

Azure Pipelines är en del av Azure DevOps. Du kan konfigurera en pipeline för att skapa, testa och distribuera din app till App Service från valfri källlagringsplats som stöds.

Om du vill använda Azure Pipelines som byggprovider konfigurerar du den inte i App Service, utan går direkt till Azure DevOps. I Distributionscenter pekar alternativet Azure Pipelines bara dig i rätt riktning.

Mer information finns i Distribuera till App Service med Hjälp av Azure Pipelines.

Vad händer med min app under distributionen?

Alla distributionsmetoder som stöds officiellt gör ändringar i filerna i mappen /home/site/wwwroot i din mapp. De här filerna används för att köra din app. Distributionen kan därför misslyckas på grund av låsta filer. Appen kan även bete sig oförutsägbart under distributionen eftersom alla filer inte uppdateras samtidigt. Det här beteendet är inte önskvärt för en app riktad till kunder. Det finns några sätt att undvika problemen:

• Kör appen direkt från ZIP-paketet utan att packa upp den.
• Stoppa eller aktivera offlineläge för appen under distributionen. Mer information finns i Hantera låsta filer under distributionen.
• Distribuera till en mellanlagringsplats med automatisk växling aktiverat.

Vanliga frågor och svar

• Fungerar GitHub Actions-byggprovidern med grundläggande autentisering om grundläggande autentisering är inaktiverad?
• Vad gör det användartilldelade identitetsalternativet för GitHub Actions?
• Varför ser jag felet "Den här identiteten har inte skrivbehörighet för den här appen. Välj en annan identitet eller samarbeta med administratören för att bevilja rollen Webbplatsdeltagare till din identitet i den här appen"?
• Varför ser jag felet "Den här identiteten har inte skrivbehörighet för den här appen. Välj en annan identitet eller samarbeta med administratören för att bevilja rollen Webbplatsdeltagare till din identitet i den här appen"?

Fungerar GitHub Actions-byggprovidern med grundläggande autentisering om grundläggande autentisering är inaktiverad?

Nej. Prova att använda GitHub Actions med det användartilldelade identitetsalternativet .

Mer information finns i Distribution utan grundläggande autentisering.

Vad gör det användartilldelade identitetsalternativet för GitHub Actions?

När du väljer användartilldelad identitet under GitHub Actions-källan konfigurerar App Service alla nödvändiga resurser i Azure och i GitHub för att aktivera den rekommenderade OpenID Connect-autentiseringen med GitHub Actions.

Mer specifikt utför App Service följande åtgärder:

• Skapar en federerad autentiseringsuppgift mellan en användartilldelad hanterad identitet i Azure och den valda lagringsplatsen och grenen i GitHub.
• Skapar hemligheterna AZURE_CLIENT_ID, AZURE_TENANT_IDoch AZURE_SUBSCRIPTION_ID från de federerade autentiseringsuppgifterna i din valda GitHub-lagringsplats.
• Tilldelar identiteten till din app.

I ett GitHub Actions-arbetsflöde på din GitHub-lagringsplats kan du sedan använda azure-/inloggningsåtgärden för att autentisera med din app med hjälp av OpenID Connect. Exempel finns i Lägga till arbetsflödesfilen till din GitHub-lagringsplats.

Om ditt Azure-konto har de behörigheter som krävs skapar App Service en användartilldelad hanterad identitet och konfigurerar den åt dig. Den här identiteten visas inte på sidan Identiteter i din app. Om ditt Azure-konto inte har de behörigheter som krävs måste du välja en befintlig identitet med den nödvändiga rollen.

Varför visas felet "Du har inte tillräcklig behörighet för den här appen för att tilldela rollbaserad åtkomst till en hanterad identitet och konfigurera federerade autentiseringsuppgifter"?

Meddelandet anger att ditt Azure-konto inte har de behörigheter som krävs för att skapa en användartilldelad hanterad identitet för GitHub Actions. De behörigheter som krävs (omfång för din app) är:

• Microsoft.Authorization/roleAssignments/write
• Microsoft.ManagedIdentity/userAssignedIdentities/write

Som standard har rollen Administratör för användaråtkomst och Rollen Ägare redan dessa behörigheter, men rollen Deltagare har inte det. Om du inte har de behörigheter som krävs kan du samarbeta med Azure-administratören för att skapa en användartilldelad hanterad identitet med rollen Webbplatsdeltagare. I Distributionscenter kan du sedan välja identiteten i listrutan GitHub>Identity.

Mer information om de alternativa stegen finns i Distribuera till App Service med GitHub Actions.

Varför ser jag felet "Den här identiteten har inte skrivbehörighet för den här appen. Välj en annan identitet eller samarbeta med administratören för att bevilja rollen Webbplatsdeltagare till din identitet i den här appen"?

Meddelandet anger att den valda användartilldelade hanterade identiteten inte har den roll som krävs för att aktivera OpenID Connect mellan GitHub-lagringsplatsen och App Service-appen. Identiteten måste ha någon av följande roller i appen: Ägare, Deltagare, Webbplatsdeltagare. Den minst privilegierade roll som identiteten behöver är Websites-deltagare.

Fler resurser

• Använda Azure PowerShell