Aangepaste software migreren naar Azure App Service met behulp van een aangepaste container

Azure App Service biedt vooraf gedefinieerde toepassingsstacks, zoals ASP.NET of Node.js, in Windows. Deze toepassingsstacks worden uitgevoerd op IIS. De vooraf geconfigureerde Windows-omgeving vergrendelt het besturingssysteem van:

• Beheerderstoegang.
• Software-installaties.
• Wijzigingen in de algemene assemblycache.

Zie De functionaliteit van het besturingssysteem in App Service voor meer informatie.

U kunt een aangepaste, geconfigureerde Windows-installatiekopieën implementeren vanuit Visual Studio om wijzigingen in het besturingssysteem aan te brengen die uw app nodig heeft. Hierdoor kunt u eenvoudig een on-premises app migreren waarvoor een aangepaste besturingssysteem- en softwareconfiguratie is vereist. Dit zelfstudie laat zien hoe u een ASP.NET-app naar App Service migreert die aangepaste lettertypen gebruikt die zijn geïnstalleerd in de Windows-lettertypenbibliotheek. U implementeert een aangepaste, geconfigureerde Windows-installatiekopieën van Visual Studio naar Azure Container Registry en voert deze vervolgens uit in App Service.

Vereisten

• Meld u aan voor een Docker Hub-account.
• Installeer Docker voor Windows.
• Configureer Docker om Windows-containers uit te voeren.
• Installeer Visual Studio 2022 met de ASP.NET- en webontwikkelingsworkloads en Azure-ontwikkelworkloads . Als u Visual Studio 2022 al hebt geïnstalleerd:
  • Installeer de nieuwste updates in Visual Studio door Help>Controleren op updates te selecteren.
  • Voeg de workloads toe in Visual Studio door Extra>Hulpprogramma’s en functies ophalen te selecteren.

De app lokaal instellen

Het voorbeeld downloaden

In deze stap stelt u het lokale .NET-project in.

• Download het voorbeeldproject.
• Pak het custom-font-win-container-master.zip-bestand uit (pak het uit).

Het voorbeeldproject bevat een eenvoudige ASP.NET toepassing die gebruikmaakt van een aangepast lettertype dat is geïnstalleerd in de Windows-lettertypebibliotheek. Het is niet nodig om lettertypen te installeren. Het voorbeeld is echter een voorbeeld van een app die is geïntegreerd met het onderliggende besturingssysteem. Om een ​​dergelijke app naar App Service te migreren, wijzigt u uw code om de integratie te verwijderen of migreert u de code zoals ze is in een aangepaste Windows-container.

Het lettertype installeren

Ga in Windows Verkenner naar custom-font-win-container-master/CustomFontSample, klik met de rechtermuisknop op FrederickatheGreat-Regular.ttf en selecteer Installeren.

Dit lettertype is openbaar beschikbaar via Google Fonts.

De app uitvoeren

Open het bestand custom-font-win-container-master/CustomFontSample.sln in Visual Studio.

Selecteer Ctrl+F5 om de app uit te voeren zonder foutopsporing. De app wordt weergegeven in de standaardbrowser.

Omdat de app gebruikmaakt van een geïnstalleerd lettertype, kan de app niet worden uitgevoerd in de App Service-sandbox. U kunt deze echter implementeren met behulp van een Windows-container, omdat u het lettertype in de Windows-container kunt installeren.

Windows-container configureren

Klik in Solution Explorer met de rechtermuisknop op het project CustomFontSample en selecteer Add>Container Orchestration Support.

Selecteer Docker Compose>OK.

Uw project is nu ingesteld op uitvoering in een Windows-container. Er Dockerfile wordt een toegevoegd aan het CustomFontSample-project en er wordt een docker-compose-project toegevoegd aan de oplossing.

Open Dockerfile vanuit Solution Explorer.

U moet een ondersteunde bovenliggende installatiekopie gebruiken. Wijzig de bovenliggende installatiekopie door de regel FROM ​​te vervangen door de volgende code:

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

Voeg de volgende regel toe aan het einde van het bestand en sla het bestand op:

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

U kunt InstallFont.ps1 vinden in het project CustomFontSample. Het is een eenvoudig script waarmee het lettertype wordt geïnstalleerd. U vindt een complexere versie van het script in de PowerShell Gallery.

Publiceren naar Azure Container Registry

Azure Container Registry kan uw afbeeldingen opslaan voor containerimplementaties. U kunt App Service configureren voor het gebruik van installatiekopieën die worden gehost in Container Registry.

Het venster Publiceren openen

Klik in Solution Explorer met de rechtermuisknop op het project CustomFontSample en selecteer Publiceren.

Het register maken en publiceren

1. Selecteer Azure in het venster Publiceren en selecteer vervolgens Volgende.

2. Selecteer Azure Container Registry en selecteer vervolgens Volgende.

3. Selecteer het abonnement waarin u het register wilt publiceren en selecteer vervolgens Nieuw maken.

Aanmelden met een Azure-account

Selecteer een account toevoegen in het venster Azure Container Registry en meld u vervolgens aan bij uw Azure-abonnement. Als u al bent aangemeld, selecteert u het account met het gewenste abonnement in de vervolgkeuzelijst.

Het register configureren

Configureer het nieuwe containerregister met behulp van de voorgestelde waarden in de volgende tabel als richtlijn. Selecteer Maken wanneer u klaar bent.

Klik op Voltooien.

Er wordt een terminalvenster geopend en de voortgang van de implementatie van de installatiekopie wordt weergegeven. Wacht totdat de installatie is voltooid.

Aanmelden bij Azure

Meld u aan bij het Azure-portaal.

Een webtoepassing maken

Selecteer Een resource maken en selecteer vervolgens Maken onder Web-app.

Basisprincipes van app configureren

Configureer de instellingen op het tabblad Basisbeginselen met behulp van de volgende tabel als richtlijn.

Het tabblad Basisbeginselen moet er ongeveer als volgt uitzien:

De Windows-container configureren

Configureer uw aangepaste Windows-container op het tabblad Container , zoals wordt weergegeven in de volgende tabel en selecteer Vervolgens Beoordelen en maken.

De app voltooien

Selecteer Maken en wacht tot azure de vereiste resources heeft gemaakt.

Bladeren naar de web-app

Wanneer de implementatie is voltooid, wordt er een meldingsbericht weergegeven:

1. Selecteer Naar resource.

2. Selecteer op de app-pagina de koppeling onder URL.

Er wordt een nieuwe browserpagina geopend met de volgende pagina:

Wacht enkele minuten en probeer het opnieuw totdat u de startpagina krijgt met het lettertype dat u verwacht:

Gefeliciteerd U hebt een ASP.NET-toepassing gemigreerd naar App Service in een Windows-container.

De opstartlogboeken van de container weergeven

Het kan enige tijd duren voordat de Windows-container is geladen. Als u de voortgang wilt zien, gaat u naar de volgende URL. (Vervang <de app-naam> door de naam van uw app.)

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

De gestreamde logboeken zien er als volgt uit:

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 maakt gebruik van Docker-containertechnologie om zowel ingebouwde installatiekopieën als aangepaste installatiekopieën te hosten. Als u een lijst met ingebouwde installatiekopieën wilt zien, voert u de Azure CLI-opdracht az webapp list-runtimes --os linux uit. Als deze installatiekopieën niet voldoen aan uw behoeften, kunt u een aangepaste installatiekopie bouwen en implementeren.

In deze zelfstudie leert u het volgende:

Voor het voltooien van deze zelfstudie worden kleine kosten in rekening gebracht in uw Azure-account voor het containerregister en kunnen er meer kosten in rekening worden gebracht als u de container langer dan een maand host.

Uw eerste omgeving instellen

Voor deze zelfstudie is versie 2.0.80 of hoger van Azure CLI vereist. Als u Azure Cloud Shell gebruikt, is de nieuwste versie al geïnstalleerd.

• Zorg ervoor dat u een Azure-account met een actief abonnement hebt. Gratis een account maken

• Gebruik de Bash-omgeving in Azure Cloud Shell. Zie Aan de slag met Azure Cloud Shell voor meer informatie.

  

• Installeer de Azure CLI, indien gewenst, om CLI-referentieopdrachten uit te voeren. Als u in Windows of macOS werkt, kunt u Azure CLI uitvoeren in een Docker-container. Zie De Azure CLI uitvoeren in een Docker-container voor meer informatie.

  • Als u een lokale installatie gebruikt, meldt u zich aan bij Azure CLI met behulp van de opdracht az login. Volg de stappen die worden weergegeven in de terminal, om het verificatieproces te voltooien. Zie Verifiëren bij Azure met behulp van Azure CLI voor andere aanmeldingsopties.

  • Installeer de Azure CLI-extensie bij het eerste gebruik, wanneer u hierom wordt gevraagd. Zie Extensies gebruiken en beheren met de Azure CLIvoor meer informatie over extensies.

  • Voer az version uit om de geïnstalleerde versie en afhankelijke bibliotheken te vinden. Voer az upgrade uit om te upgraden naar de nieuwste versie.

• Installeer Docker. Dit gebruikt u om Docker-installatiekopieën te bouwen. Voor het installeren van Docker moet de computer mogelijk opnieuw worden opgestart.

Nadat u Docker hebt geïnstalleerd, opent u een terminalvenster en controleert u of de docker is geïnstalleerd:

docker --version

De voorbeeld-app klonen of downloaden

U kunt het voorbeeld voor deze zelfstudie verkrijgen via git-kloon of download.

De opslagplaats klonen met behulp van Git Bash

Kloon de voorbeeldopslagplaats:

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

Zorg ervoor dat u het --config core.autocrlf=input argument opneemt om de juiste regeleinden te garanderen in bestanden die in de Linux-container worden gebruikt.

Navigeer vervolgens naar de map:

cd docker-django-webapp-linux

De ZIP downloaden van GitHub

In plaats van git-kloon te gebruiken, kunt u naar https://github.com/Azure-Samples/docker-django-webapp-linuxCode>Local>Download ZIP gaan en selecteren.

Pak het ZIP-bestand uit in een map met de naam docker-django-webapp-linux.

Open vervolgens een terminalvenster in de map docker-django-webapp-linux .

Het Docker-bestand bekijken (optioneel)

Hier volgt het bestand in het voorbeeld met de naam Dockerfile. Hierin worden de Docker-installatiekopieën beschreven en vindt u configuratie-instructies.

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"]

• Met de eerste groep opdrachten worden de vereisten van de app geïnstalleerd in de omgeving.
• De tweede groep opdrachten maakt een SSH-server om verbeterde beveiligingscommunicatie tussen de container en de host te bieden.
• Met de laatste regel, ENTRYPOINT ["init.sh"], wordt init.sh aangeroepen om de SSH-service en Python-server te starten.

De installatiekopie lokaal bouwen en testen

1. Voer de volgende opdracht uit om de installatiekopie te bouwen:

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

2. Test of de build werkt door de Docker-container lokaal uit te voeren:

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

   Met deze docker run opdracht geeft u de poort op met behulp van het -p argument en bevat de naam van de installatiekopieën. -it hiermee kunt u stoppen met Ctrl+C.

   Tip

   Als u windows gebruikt en de fout *standard_init_linux.go:211: exec-gebruikersproces heeft 'geen dergelijk bestand of map' weergegeven, bevat het init.sh bestand CRLF-regeleinden in plaats van de verwachte LF-einden. Deze fout treedt op als u Git hebt gebruikt om de voorbeeldopslagplaats te klonen, maar de --config core.autocrlf=input parameter weggelaten. In dit geval kloont u de opslagplaats opnieuw met het --config argument. U ziet de fout mogelijk ook als u init.sh hebt bewerkt en vervolgens hebt opgeslagen met CRLF-einden. In dit geval slaat u het bestand opnieuw op met alleen LF-einden.

3. Blader om te http://localhost:8000 controleren of de web-app en de container correct werken.

   

Een door de gebruiker toegewezen beheerde identiteit maken

App Service kan een standaard beheerde identiteit of een door de gebruiker toegewezen beheerde identiteit gebruiken om te verifiëren met een containerregister. In deze zelfstudie gebruikt u een door de gebruiker toegewezen beheerde identiteit.

Een containerregister maken

De voorbeeldinstallatiekopieën naar Container Registry pushen

In deze sectie pusht u de installatiekopieën naar Container Registry, die later door App Service wordt gebruikt.

1. Gebruik vanuit de lokale terminal waar u de voorbeeldinstallatiekopie hebt gemaakt de docker login opdracht om u aan te melden bij het containerregister:

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

   Vervang <registry-name> en <registry-username> door waarden uit de vorige stappen. Wanneer u hierom wordt gevraagd, typt u een van de wachtwoorden uit de vorige sectie.

   Gebruik dezelfde registernaam in alle resterende stappen van deze sectie.

2. Wanneer de aanmelding is geslaagd, tagt u uw lokale Docker-installatiekopieën in het register:

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

3. Gebruik de opdracht docker push om de installatiekopie naar het register te pushen:

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

   De eerste keer dat u de installatiekopie uploadt, kan dit enkele minuten duren, omdat deze upload de basisinstallatiekopie bevat. De volgende uploads zijn doorgaans sneller.

   Terwijl u wacht, kunt u de stappen in de volgende sectie voltooien om App Service te configureren voor implementatie vanuit het register.

De beheerde identiteit voor uw register autoriseren

De beheerde identiteit die u hebt gemaakt, heeft nog geen autorisatie om uit het containerregister te halen. In deze stap schakelt u de autorisatie in.

De web-app maken

De web-app configureren

In deze stap configureert u de web-app als volgt:

• Configureer de app voor het verzenden van aanvragen naar poort 8000. De voorbeeldcontainer luistert op poort 8000 voor webaanvragen.
• Configureer uw app voor het gebruik van de beheerde identiteit om installatiekopieën op te halen uit uw containerregister.
• Configureer continue implementatie vanuit het containerregister. (Elke installatiekopie die naar het register wordt gepusht, activeert uw app om de nieuwe installatiekopie op te halen.) Deze stap is niet nodig om uw web-app te configureren om uit uw containerregister te halen, maar kan de web-app waarschuwen wanneer een nieuwe installatiekopie naar het register wordt gepusht. Als u deze stap niet voltooit, moet u handmatig een pull-installatiekopie activeren door de web-app opnieuw op te starten.

Bladeren naar de web-app

De eerste keer dat u toegang probeert te krijgen tot de app, kan het enige tijd duren voordat de app reageert omdat App Service de volledige installatiekopie uit het register moet ophalen. Als er een time-out optreedt voor de browser, vernieuwt u gewoon de pagina. Nadat de eerste installatiekopie is opgehaald, worden de volgende tests veel sneller uitgevoerd.

Toegang tot diagnostische logboeken

De app-code wijzigen en opnieuw implementeren

In deze sectie maakt u een wijziging in de code van de web-app, bouwt u de installatiekopieën opnieuw en pusht u deze vervolgens naar het containerregister. In App Service wordt vervolgens automatisch de bijgewerkte installatiekopie opgehaald uit het register om de actieve web-app bij te werken.

1. Open in uw lokale map docker-django-webapp-linux het bestand app/templates/app/index.html.

2. Wijzig eerst het HTML-element om overeen te komen met de volgende code.

   <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. Sla uw wijzigingen op.

4. Ga naar de map docker-django-webapp-linux en bouw de installatiekopieën opnieuw op:

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

5. Werk de tag van de afbeelding bij naar latest:

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

   Vervang <registry-name> door de naam van uw register.

6. Push de installatiekopie naar het register:

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

7. Wanneer de push van de installatiekopie is voltooid, meldt de webhook App Service over de push en probeert App Service de bijgewerkte installatiekopie op te halen. Wacht enkele minuten en controleer vervolgens of de update is geïmplementeerd door naar https://<app-name>.azurewebsites.net.

Verbinding maken met de container met behulp van SSH

SSH maakt verbeterde beveiligingscommunicatie mogelijk tussen een container en een client. Als u een SSH-verbinding met uw container wilt inschakelen, moet u hiervoor uw aangepaste installatiekopieën configureren. Wanneer de container wordt uitgevoerd, kunt u een SSH-verbinding openen.

De container configureren voor SSH

De voorbeeld-app die in deze zelfstudie wordt gebruikt, heeft al de benodigde configuratie in Dockerfile, waarmee de SSH-server wordt geïnstalleerd en ook de aanmeldingsreferenties worden ingesteld. Deze sectie is alleen ter informatie. Als u verbinding wilt maken met de container, gaat u verder met de volgende sectie.

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 kopieert ook het sshd_config bestand naar de map /etc/ssh/ en maakt poort 2222 beschikbaar op de container:

COPY sshd_config /etc/ssh/

# ...

EXPOSE 8000 2222

Poort 2222 is interne poort die alleen toegankelijk is voor containers in het brugnetwerk van een virtueel particulier netwerk.

Ten slotte wordt de SSH-server gestart met het invoerscript init.sh.

#!/bin/bash
service ssh start

De SSH-verbinding met de container openen

Resources opschonen

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