Migrera anpassad programvara till Azure App Service med hjälp av en anpassad container

Azure App Service tillhandahåller fördefinierade programstackar, till exempel ASP.NET eller Node.js, i Windows. Dessa programstackar körs på IIS. Den förkonfigurerade Windows-miljön låser operativsystemet från:

• Administrativ åtkomst.
• Programvaruinstallationer.
• Ändringar i den globala sammansättningscacheminnet.

Mer information finns i Operativsystemfunktioner i App Service.

Du kan distribuera en anpassad konfigurerad Windows-avbildning från Visual Studio för att göra os-ändringar som din app behöver. Det gör det enkelt att migrera en lokal app som kräver ett anpassat operativsystem och en egen programvarukonfiguration. Den här kursen beskriver hur du migrerar en ASP.NET-app till App Service som använder anpassade teckensnitt som installeras i Windows-teckensnittsbiblioteket. Du distribuerar en anpassad konfigurerad Windows-avbildning från Visual Studio till Azure Container Registry och kör den sedan i App Service.

Förutsättningar

• Registrera dig för ett Docker Hub-konto.
• Installera Docker för Windows.
• Konfigurera Docker för att köra Windows-containrar.
• Installera Visual Studio 2022 med arbetsbelastningarna ASP.NET och webbutveckling och Azure Development . Om du redan har Visual Studio 2022 installerat:
  • Installera de senaste uppdateringarna i Visual Studio genom att välja Hjälp>sök efter uppdateringar.
  • Lägg till arbetsbelastningarna i Visual Studio genom att välja Verktyg>Hämta verktyg och funktioner.

Konfigurera appen lokalt

Hämta exemplet

I det här steget konfigurerar du det lokala .NET-projektet.

• Ladda ned exempelprojektet.
• Extrahera (packa upp) custom-font-win-container-master.zip-filen.

Exempelprojektet innehåller ett enkelt ASP.NET program som använder ett anpassat teckensnitt som är installerat i Windows-teckensnittsbiblioteket. Det är inte nödvändigt att installera teckensnitt. Exemplet är dock ett exempel på en app som är integrerad med det underliggande operativsystemet. För att migrera den här typen av app till App Service måste du antingen omorganisera din kod för att ta bort integrationen eller migrera den som den är i en anpassad Windows-container.

Installera teckensnittet

I Utforskaren går du till custom-font-win-container-master/CustomFontSample, högerklickar på FrederickatheGreat-Regular.ttf och väljer Installera.

Det här teckensnittet är offentligt tillgängligt från Google Fonts.

Kör appen

Öppna filen custom-font-win-container-master/CustomFontSample.sln i Visual Studio.

Välj Ctrl+F5 för att köra appen utan att felsöka. Appen visas i din standardwebbläsare.

Eftersom appen använder ett installerat teckensnitt kan appen inte köras i Sandbox-miljön för App Service. Du kan dock distribuera den med hjälp av en Windows-container i stället, eftersom du kan installera teckensnittet i Windows-containern.

Konfigurera Windows-containern

I Solution Explorer högerklickar du på projektet CustomFontSample och väljer Lägg till>Container Orchestration Support (Stöd för containerorkestrering).

Välj Docker Compose>OK.

Projektet är nu inställt på att köras i en Windows-container. A Dockerfile läggs till i CustomFontSample-projektet och ett docker-compose-projekt läggs till i lösningen.

Öppna Dockerfile från Solution Explorer.

Du måste använda en överordnad avbildning som stöds. Ändra den överordnade avbildningen genom att ersätta raden FROM med följande kod:

FROM mcr.microsoft.com/dotnet/framework/aspnet:4.7.2-windowsservercore-ltsc2019

Lägg till följande rad i slutet av filen och spara filen:

RUN ${source:-obj/Docker/publish/InstallFont.ps1}

Du hittar InstallFont.ps1 i projektet CustomFontSample. Det är ett enkelt skript som installerar teckensnittet. Du hittar en mer komplex version av skriptet i PowerShell-galleriet.

Publicera till Azure Container Registry

Azure Container Registry kan lagra dina avbildningar för containerdistribution. Du kan konfigurera App Service för att använda avbildningar som finns i Container Registry.

Öppna fönstret Publicera

Högerklicka på Projektet CustomFontSample i Solution Explorer och välj Publicera.

Skapa och publicera registret

1. I fönstret Publicera väljer du Azure och sedan Nästa.

2. Välj Azure Container Registry och välj sedan Nästa.

3. Välj den prenumeration där du vill publicera registret och välj sedan Skapa ny.

Logga in med ett Azure-konto

I fönstret Azure Container Registry väljer du Lägg till ett konto och loggar sedan in på din Azure-prenumeration. Om du redan är inloggad väljer du det konto som innehåller den önskade prenumerationen i listrutan.

Konfigurera registret

Konfigurera det nya containerregistret med hjälp av de föreslagna värdena i följande tabell som en guide. När det är klart väljer du Skapa.

Välj Slutför.

Ett terminalfönster öppnas och visar förloppet för avbildningsdistributionen. Vänta tills distributionen har slutförts.

Logga in på Azure

Logga in på Azure-portalen.

Skapa en webbapp

Välj Skapa en resurs och välj sedan Skapa under Webbapp.

Konfigurera grunderna för appar

På fliken Grundläggande konfigurerar du inställningarna med hjälp av följande tabell som en guide.

Fliken Grundläggande bör se ut ungefär så här:

Konfigurera Windows-containern

På fliken Container konfigurerar du din anpassade Windows-container enligt följande tabell och väljer sedan Granska + skapa.

Slutför appgenereringen

Välj Skapa och vänta tills Azure har skapat de resurser som krävs.

Bläddra till webbappen

När distributionen är klar visas ett meddelande:

1. Välj Gå till resurs.

2. På appsidan väljer du länken under URL.

En ny webbläsarsida öppnas på följande sida:

Vänta några minuter och försök igen tills du får startsidan med det teckensnitt du förväntar dig:

Grattis! Du har migrerat ett ASP.NET-program till App Service i en Windows-container.

Visa containerns startloggar

Det kan ta lite tid innan Windows-containern läses in. Om du vill se förloppet går du till följande URL. (Ersätt <appnamn> med namnet på din app.)

https://<app-name>.scm.azurewebsites.net/api/logstream

De strömmade loggarna ser ut så här:

14/09/2018 23:16:19.889 INFO - Site: fonts-win-container - Creating container for image: customfontsample20180914115836.azurecr.io/customfontsample:latest.
14/09/2018 23:16:19.928 INFO - Site: fonts-win-container - Create container for image: customfontsample20180914115836.azurecr.io/customfontsample:latest succeeded. Container Id 329ecfedbe370f1d99857da7352a7633366b878607994ff1334461e44e6f5418
14/09/2018 23:17:23.405 INFO - Site: fonts-win-container - Start container succeeded. Container: 329ecfedbe370f1d99857da7352a7633366b878607994ff1334461e44e6f5418
14/09/2018 23:17:28.637 INFO - Site: fonts-win-container - Container ready
14/09/2018 23:17:28.637 INFO - Site: fonts-win-container - Configuring container
14/09/2018 23:18:03.823 INFO - Site: fonts-win-container - Container ready
14/09/2018 23:18:03.823 INFO - Site: fonts-win-container - Container start-up and configuration completed successfully

Azure App Service använder Docker-containerteknik som värd för både inbyggda avbildningar och anpassade avbildningar. Om du vill se en lista över inbyggda avbildningar kör du Azure CLI-kommandot az webapp list-runtimes --os linux. Om dessa avbildningar inte uppfyller dina behov kan du skapa och distribuera en anpassad avbildning.

I den här självstudien lär du dig att:

Att slutföra den här självstudien medför en liten avgift i ditt Azure-konto för containerregistret och kan medföra mer kostnader om du är värd för containern längre än en månad.

Konfigurera din första miljö

Den här självstudien kräver version 2.0.80 eller senare av Azure CLI. Om du använder Azure Cloud Shell är den senaste versionen redan installerad.

• Se till att du har ett Azure-konto med en aktiv prenumeration. Skapa ett konto utan kostnad.

• Använd Bash-miljön i Azure Cloud Shell. Mer information finns i Kom igång med Azure Cloud Shell.

  

• Om du föredrar att köra CLI-referenskommandon lokalt installerar du Azure CLI. Om du kör i Windows eller macOS kan du köra Azure CLI i en Docker-container. Mer information finns i Så här kör du Azure CLI i en Docker-container.

  • Om du använder en lokal installation loggar du in på Azure CLI med hjälp av kommandot az login. Slutför autentiseringsprocessen genom att följa stegen som visas i terminalen. Andra inloggningsalternativ finns i Autentisera till Azure med Azure CLI.

  • När du uppmanas att installera Azure CLI-tillägget vid första användningen. Mer information om tillägg finns i Använda och hantera tillägg med Azure CLI.

  • Kör az version om du vill hitta versionen och de beroende bibliotek som är installerade. Om du vill uppgradera till den senaste versionen kör du az upgrade.

• Installera Docker, som du använder för att skapa Docker-avbildningar. Installation av Docker kan kräva en omstart av datorn.

När du har installerat Docker öppnar du ett terminalfönster och kontrollerar att docker har installerats:

docker --version

Klona eller ladda ned exempelappen

Du kan hämta exemplet för den här självstudien via Git-klon eller nedladdning.

Klona lagringsplatsen med hjälp av Git Bash

Klona exempellagringsplatsen:

git clone https://github.com/Azure-Samples/docker-django-webapp-linux.git --config core.autocrlf=input

Se till att du inkluderar --config core.autocrlf=input argumentet för att garantera rätt radslut i filer som används i Linux-containern.

Navigera sedan till mappen:

cd docker-django-webapp-linux

Ladda ned ZIP från GitHub

I stället för att använda Git-klon kan du gå till https://github.com/Azure-Samples/docker-django-webapp-linux och välja Kod>lokal>nedladdning ZIP.

Packa upp ZIP-filen i en mapp med namnet docker-django-webapp-linux.

Öppna sedan ett terminalfönster i mappen docker-django-webapp-linux .

(Valfritt) Granska Docker-filen

Följande är filen i exemplet med namnet Dockerfile. Den beskriver Docker-avbildningen och innehåller konfigurationsinstruktioner.

FROM tiangolo/uwsgi-nginx-flask:python3.6

RUN mkdir /code
WORKDIR /code
ADD requirements.txt /code/
RUN pip install -r requirements.txt --no-cache-dir
ADD . /code/

# ssh
ENV SSH_PASSWD "root:Docker!"
RUN apt-get update \
        && apt-get install -y --no-install-recommends dialog \
        && apt-get update \
 && apt-get install -y --no-install-recommends openssh-server \
 && echo "$SSH_PASSWD" | chpasswd 

COPY sshd_config /etc/ssh/
COPY init.sh /usr/local/bin/

RUN chmod u+x /usr/local/bin/init.sh
EXPOSE 8000 2222

#CMD ["python", "/code/manage.py", "runserver", "0.0.0.0:8000"]
ENTRYPOINT ["init.sh"]

• Den första gruppen med kommandon installerar appens krav i miljön.
• Den andra gruppen med kommandon skapar en SSH-server som ger förbättrad säkerhet mellan containern och värden.
• Den sista raden, ENTRYPOINT ["init.sh"], anropar init.sh för att starta SSH-tjänsten och Python-servern.

Skapa och testa avbildningen lokalt

1. Kör följande kommando för att skapa avbildningen:

   docker build --tag appsvc-tutorial-custom-image .
   

2. Testa att bygget fungerar genom att köra Docker-containern lokalt:

   docker run -it -p 8000:8000 appsvc-tutorial-custom-image
   

   Det här docker run kommandot anger porten med hjälp -p av argumentet och innehåller namnet på avbildningen. -it gör att du kan stoppa det med hjälp av Ctrl+C.

   Dricks

   Om du kör i Windows och ser felet *standard_init_linux.go:211: exec-användarprocessen orsakade "ingen sådan fil eller katalog" innehåller den init.sh filen CRLF-radslut i stället för förväntade LF-slut. Det här felet inträffar om du använde Git för att klona exempellagringsplatsen men utelämnade parametern --config core.autocrlf=input . I det här fallet klonar du lagringsplatsen igen med --config argumentet . Du kan också se felet om du redigerade init.sh och sparade det med CRLF-slut. I det här fallet sparar du filen igen med endast LF-slut.

3. Bläddra till för http://localhost:8000 att kontrollera att webbappen och containern fungerar korrekt.

   

Skapa en användartilldelad hanterad identitet

App Service kan använda antingen en standardhanterad identitet eller en användartilldelad hanterad identitet för att autentisera med ett containerregister. I den här självstudien använder du en användartilldelad hanterad identitet.

Skapa ett containerregister

Skicka exempelavbildningen till Container Registry

I det här avsnittet skickar du avbildningen till Container Registry, som används av App Service senare.

1. Från den lokala terminalen där du skapade exempelavbildningen docker login använder du kommandot för att logga in i containerregistret:

   docker login <registry-name>.azurecr.io --username <registry-username>
   

   Ersätt <registry-name> och <registry-username> med värden från föregående steg. När du uppmanas till det skriver du in ett av lösenorden från föregående avsnitt.

   Använd samma registernamn i alla återstående steg i det här avsnittet.

2. När inloggningen lyckas taggar du din lokala Docker-avbildning till registret:

   docker tag appsvc-tutorial-custom-image <registry-name>.azurecr.io/appsvc-tutorial-custom-image:latest
   

3. docker push Använd kommandot för att skicka avbildningen till registret:

   docker push <registry-name>.azurecr.io/appsvc-tutorial-custom-image:latest
   

   Det kan ta några minuter att ladda upp bilden första gången eftersom den innehåller basavbildningen. Efterföljande uppladdningar går vanligtvis snabbare.

   Medan du väntar kan du slutföra stegen i nästa avsnitt för att konfigurera App Service att distribuera från registret.

Auktorisera den hanterade identiteten för registret

Den hanterade identitet som du skapade har ännu inte behörighet att hämta från containerregistret. I det här steget aktiverar du auktoriseringen.

Skapa webbappen

Konfigurera webbappen

I det här steget konfigurerar du webbappen på följande sätt:

• Konfigurera appen för att skicka begäranden till port 8000. Exempelcontainern lyssnar på port 8000 för webbbegäranden.
• Konfigurera din app så att den använder den hanterade identiteten för att hämta avbildningar från containerregistret.
• Konfigurera kontinuerlig distribution från containerregistret. (Varje avbildnings push-överföring till registret utlöser appen för att hämta den nya avbildningen.) Det här steget behövs inte för att konfigurera webbappen att hämta från containerregistret, men den kan meddela webbappen när en ny avbildning skickas till registret. Om du inte slutför det här steget måste du manuellt utlösa en avbildningshämtning genom att starta om webbappen.

Bläddra till webbappen

Första gången du försöker komma åt appen kan det ta lite tid för appen att svara eftersom App Service måste hämta hela avbildningen från registret. Om webbläsaren överskrider tidsgränsen uppdaterar du bara sidan. När den första avbildningen har hämtats körs efterföljande tester mycket snabbare.

Få åtkomst till diagnostikloggar

Ändra appkoden och distribuera om

I det här avsnittet gör du en ändring i webbappkoden, återskapar avbildningen och push-överför den sedan till containerregistret. App Service hämtar sedan automatiskt den uppdaterade avbildningen från registret för att uppdatera webbappen som körs.

1. Öppna filen app/templates/app/index.html i den lokala mappen docker-django-webapp-linux.

2. Ändra det första HTML-elementet så att det matchar följande kod.

   <nav class="navbar navbar-inverse navbar-fixed-top">
     <div class="container">
       <div class="navbar-header">
         <a class="navbar-brand" href="#">Azure App Service - Updated Here!</a>
       </div>
     </div>
   </nav>
   

3. Spara dina ändringar.

4. Gå till mappen docker-django-webapp-linux och återskapa avbildningen:

   docker build --tag appsvc-tutorial-custom-image .
   

5. Uppdatera avbildningens tagg till latest:

   docker tag appsvc-tutorial-custom-image <registry-name>.azurecr.io/appsvc-tutorial-custom-image:latest
   

   Byt ut <registry-name> mot namnet på ditt register.

6. Skicka avbildningen till registret:

   docker push <registry-name>.azurecr.io/appsvc-tutorial-custom-image:latest
   

7. När avbildnings push-överföringen är klar meddelar webhooken App Service om push-överföringen och App Service försöker hämta den uppdaterade avbildningen. Vänta några minuter och kontrollera sedan att uppdateringen har distribuerats genom att gå till https://<app-name>.azurewebsites.net.

Ansluta till containern med hjälp av SSH

SSH möjliggör förbättrad säkerhetskommunikation mellan en container och en klient. Om du vill aktivera en SSH-anslutning till containern måste du konfigurera din anpassade avbildning för den. När containern körs kan du öppna en SSH-anslutning.

Konfigurera containern för SSH

Exempelappen som används i den här självstudien har redan den nödvändiga konfigurationen i Dockerfile, som installerar SSH-servern och även anger inloggningsuppgifterna. Det här avsnittet är endast informationsspecifikt. Om du vill ansluta till containern går du vidare till nästa avsnitt.

ENV SSH_PASSWD "root:Docker!"
RUN apt-get update \
        && apt-get install -y --no-install-recommends dialog \
        && apt-get update \
  && apt-get install -y --no-install-recommends openssh-server \
  && echo "$SSH_PASSWD" | chpasswd 

Dockerfile kopierar också sshd_config-filen till mappen /etc/ssh/ och visar port 2222 i containern:

COPY sshd_config /etc/ssh/

# ...

EXPOSE 8000 2222

Port 2222 är en intern port som endast kan nås av containrar i bryggnätverket i ett privat virtuellt nätverk.

Slutligen startar inmatningsskriptet, init.sh, SSH-servern.

#!/bin/bash
service ssh start

Öppna SSH-anslutningen till containern

Rensa resurser

az group delete --name msdocs-custom-container-tutorial