Migrieren von benutzerdefinierter Software zu Azure App Service mithilfe eines benutzerdefinierten Containers

Azure App Service bietet vordefinierte Anwendungsstapel wie ASP.NET oder Node.jsunter Windows. Diese Anwendungsstacks werden in IIS ausgeführt. Durch die vorkonfigurierte Windows-Umgebung wird das Betriebssystem in folgenden Punkten eingeschränkt:

  • administrativer Zugriff
  • Softwareinstallationen.
  • Änderungen am globalen Assemblycache

Weitere Informationen finden Sie unter Betriebssystemfunktionen für App Service.

Sie können ein speziell konfiguriertes Windows-Image über Visual Studio bereitstellen, um die für Ihre App erforderlichen Betriebssystemänderungen vorzunehmen. Dies erleichtert die Migration einer On-Premises-Anwendung, die eine benutzerdefinierte Betriebssystem- und Softwarekonfiguration erfordert. Dieses Tutorial veranschaulicht, wie Sie eine ASP.NET-App zu App Service migrieren, die benutzerdefinierte Schriftarten verwendet, die in der Schriftartenbibliothek von Windows installiert sind. Sie stellen ein benutzerdefiniert konfiguriertes Windows-Image mit Visual Studio in der Azure Container Registry bereit und führen es dann in App Service aus.

Screenshot der Web-App, die in einem Windows-Container ausgeführt wird.

Voraussetzungen

App lokal einrichten

Beispiel herunterladen

In diesem Schritt richten Sie das lokale .NET-Projekt ein.

Das Beispielprojekt enthält eine einfache ASP.NET-Anwendung, die eine benutzerdefinierte Schriftart verwendet, die in der Schriftartenbibliothek von Windows installiert ist. Es ist nicht erforderlich, Schriftarten zu installieren. Das Beispiel ist jedoch ein Beispiel für eine App, die in das zugrunde liegende Betriebssystem integriert ist. Um eine solche App nach App Service zu migrieren, strukturieren Sie entweder Ihren Code neu, um die Integration zu entfernen, oder Sie migrieren sie unverändert in einem benutzerdefinierten Windows-Container.

Schriftart installieren

Wechseln Sie im Windows-Explorer zu custom-font-win-container-master/CustomFontSample, klicken Sie mit der rechten Maustaste auf FrederickatheGreat-Regular.ttf, und wählen Sie "Installieren" aus.

Diese Schriftart ist öffentlich bei Google Fonts erhältlich.

App ausführen

Öffnen Sie die Datei custom-font-win-container-master/CustomFontSample.sln in Visual Studio.

Wählen Sie STRG+F5 aus, um die App ohne Debuggen auszuführen. Die App wird im Standardbrowser angezeigt.

Screenshot: im Standardbrowser angezeigte App

Da die App eine installierte Schriftart verwendet, kann die App nicht in der App Service-Sandbox ausgeführt werden. Sie können sie jedoch mithilfe eines Windows-Containers bereitstellen, da Sie die Schriftart im Windows-Container installieren können.

Windows-Container konfigurieren

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt CustomFontSample, und wählen Sie Hinzufügen>Unterstützung für Containerorchestrierung aus.

Screenshot des CustomFontSample-Projekts im Projektmappen-Explorer. Die Menüelemente

Wählen Sie Docker Compose>OK aus.

Ihr Projekt ist jetzt für die Ausführung in einem Windows-Container eingerichtet. Eine Datei Dockerfile wird dem Projekt CustomFontSample hinzugefügt, und ein Projekt docker-compose wird der Projektmappe hinzugefügt.

Öffnen Sie im Projektmappen-Explorer Dockerfile.

Sie müssen ein unterstütztes Parent-Image verwenden. Ändern Sie das übergeordnete Image, indem Sie die FROM-Zeile durch den folgenden Code ersetzen:

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

Fügen Sie am Ende der Datei die folgende Zeile hinzu, und speichern Sie die Datei:

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

Sie finden das Skript InstallFont.ps1 im Projekt CustomFontSample. Es ist ein einfaches Skript, das die Schriftart installiert. Eine komplexere Version des Skripts finden Sie in der PowerShell Gallerie.

Hinweis

Wenn Sie den Windows-Container lokal testen möchten, stellen Sie sicher, dass Docker auf dem lokalen Computer läuft.

Veröffentlichen in der Azure Container Registry

Azure Container Registry kann Ihre Images für Containerbereitstellungen speichern. Sie können App Service so konfigurieren, dass Bilder verwendet werden, die in Container Registry gehostet werden.

Öffnen Sie das Fenster „Veröffentlichen“

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt CustomFontSample , und wählen Sie "Veröffentlichen" aus.

Screenshot des CustomFontSample-Projekts im Projektmappen-Explorer. Das Menüelement

Erstellen und Veröffentlichen des Registrierungseintrags

  1. Wählen Sie im Fenster "Veröffentlichen " Azure und dann "Weiter" aus.

  2. Wählen Sie Azure Container Registry und dann "Weiter" aus.

  3. Wählen Sie das Abonnement aus, in dem Sie den Registrierungseintrag veröffentlichen möchten, und wählen Sie dann "Neu erstellen" aus.

Screenshot des Fensters

Mit einem Azure-Konto anmelden

Wählen Sie im Azure Container Registry-Fenster „Konto hinzufügen“ aus, und melden Sie sich dann bei Ihrem Azure-Abonnement an. Wenn Sie bereits angemeldet sind, wählen Sie das Konto mit dem gewünschten Abonnement aus der Dropdownliste aus.

Registrierungsdatenbank konfigurieren

Konfigurieren Sie die neue Container Registry, indem Sie die in der folgenden Tabelle vorgeschlagenen Werte als Anleitung verwenden. Wählen Sie abschließend Erstellen aus.

Einstellung Vorgeschlagener Wert
DNS-Präfix Behalten Sie den generierten Registrierungsnamen bei, oder ändern Sie ihn in einen anderen eindeutigen Namen.
Ressourcengruppe Wählen Sie Neu aus, geben Sie myResourceGroup ein, und wählen Sie dann OK aus.
SKU Basic. Weitere Informationen finden Sie unter Tarife.
Registrierungsspeicherort Westeuropa

Screenshot des Azure-Containerregistrierungsfensters.

Wählen Sie "Fertig stellen" aus.

Ein Terminalfenster wird geöffnet und zeigt den Status der Imagebereitstellung. Warten Sie, bis die Bereitstellung abgeschlossen ist.

Anmelden bei Azure

Melden Sie sich beim Azure-Portal an.

Web-App erstellen

Wählen Sie Ressource erstellen und dann unter Web AppErstellen aus.

App-Grundeinstellungen konfigurieren

Konfigurieren Sie auf der Registerkarte " Grundlagen " die Einstellungen mithilfe der folgenden Tabelle als Leitfaden.

Einstellung Vorgeschlagener Wert
Abonnement Vergewissern Sie sich, dass das richtige Abonnement ausgewählt ist.
Ressourcengruppe Wählen Sie Neu erstellen, geben Sie myResourceGroup ein, und wählen Sie dann OK aus.
Name Geben Sie einen eindeutigen Namen ein. Die URL der Web-App lautet https://<app-name>.azurewebsites.net, wobei <app-name> der Name Ihrer App ist.
Veröffentlichen Container
Betriebssystem Windows
Region Westeuropa
Windows-Plan Wählen Sie Neu erstellen, geben Sie myAppServicePlan ein, und wählen Sie dann OK aus.

Die Registerkarte "Grundlagen" sollte ähnlich wie die folgende aussehen:

Screenshot der Registerkarte „Grundlagen“, die zum Konfigurieren der Web-App verwendet wird.

Windows-Container konfigurieren

Konfigurieren Sie auf der Registerkarte „Container“ Ihren benutzerdefinierten Windows-Container wie in der folgenden Tabelle dargestellt, und wählen Sie dann „Überprüfen + erstellen“ aus.

Einstellung Vorgeschlagener Wert
Imagequelle Azure Container Registry
Registrierungsdatenbank Wählen Sie die zuvor erstellte Registrierungsdatenbank aus.
Image customfontsample
Tag neueste

App-Erstellung abschließen

Wählen Sie Erstellen aus, und warten Sie, bis Azure die erforderlichen Ressourcen erstellt hat.

Navigieren Sie zur Web-App

Nach Abschluss der Bereitstellung wird eine Benachrichtigung angezeigt:

Screenshot der Benachrichtigung.

  1. Wählen Sie Zu Ressource wechseln aus.

  2. Wählen Sie auf der App-Seite den Link unter URL aus.

Eine neue Browserseite wird auf der folgenden Seite geöffnet:

Screenshot, der die neue Browserseite für die Web-App anzeigt.

Warten Sie einige Minuten, und wiederholen Sie den Vorgang, bis die Startseite mit der von Ihnen erwarteten Schriftart angezeigt wird:

Screenshot der Startseite mit der von Ihnen konfigurierten Schriftart.

Herzlichen Glückwunsch! Sie haben eine ASP.NET Anwendung zu App Service in einem Windows-Container migriert.

Container-Startprotokolle anzeigen

Das Laden des Windows-Containers kann eine Weile dauern. Um den Status anzuzeigen, wechseln Sie zur folgenden URL. (Ersetzen Sie <app-name> durch den Namen Ihrer App.)

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

Die gestreamten Protokolle sehen wie folgt aus:

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 verwendet Docker-Containertechnologie, um sowohl integrierte Images als auch benutzerdefinierte Images zu hosten. Um eine Liste der integrierten Images anzuzeigen, führen Sie den Azure CLI-Befehl az webapp list-runtimes --os linux aus. Wenn diese Images Ihre Anforderungen nicht erfüllen, können Sie ein benutzerdefiniertes Image erstellen und bereitstellen.

Hinweis

Ihr Container sollte auf die x86-64-Architektur abzielen. ARM64 wird nicht unterstützt.

In diesem Tutorial lernen Sie Folgendes:

  • Übertragen Sie ein benutzerdefiniertes Docker-Image in die Azure Container Registry.
  • Stellen Sie das benutzerdefinierte Image für App Service bereit.
  • Konfigurieren Sie Umgebungsvariablen.
  • Ziehen Sie das Bild mithilfe einer verwalteten Identität in App Service.
  • Greifen Sie auf Diagnoseprotokolle zu.
  • Aktivieren Sie CI/CD von der Containerregistrierung für App Service.
  • Stellen Sie eine Verbindung mit dem Container mittels SSH her.

Die Durchführung dieses Tutorials verursacht eine kleine Gebühr in Ihrem Azure-Konto für die Container-Registry und kann weitere Kosten verursachen, wenn Sie den Container länger als einen Monat hosten.

Ihre Umgebung einrichten

Für dieses Tutorial ist mindestens Version 2.0.80 der Azure CLI erforderlich. Bei Verwendung von Azure Cloud Shell ist die aktuelle Version bereits installiert.

  • Installieren Sie Docker. Mit diesem Tool erstellen Sie Docker-Images. Zum Installieren von Docker ist möglicherweise ein Neustart des Computers erforderlich.

Öffnen Sie nach der Installation von Docker ein Terminalfenster, und vergewissern Sie sich, dass Docker installiert ist:

docker --version

Klonen oder die Beispiel-App herunterladen

Sie können das Beispiel für dieses Lernprogramm über Git Clone oder Download abrufen.

Klonen Sie das Repository mithilfe von Git Bash

Klonen Sie das Beispielrepository:

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

Fügen Sie unbedingt das Argument --config core.autocrlf=input mit ein, um ordnungsgemäße Zeilenenden in Dateien zu gewährleisten, die im Linux-Container verwendet werden.

Navigieren Sie dann zu folgendem Ordner:

cd docker-django-webapp-linux

ZIP-Datei von GitHub herunterladen

Anstatt Git Clone zu verwenden, können Sie zu https://github.com/Azure-Samples/docker-django-webapp-linux gehen und Code>Local>Download ZIP auswählen.

Entpacken Sie die ZIP-Datei in einen Ordner namens docker-django-webapp-linux.

Öffnen Sie dann ein Terminalfenster im Ordner docker-django-webapp-linux.

Bereite den Probenbehälter vor

Das neuere Browserterminal und az webapp exec bieten authentifizierten Zugriff auf laufende Linux-Container, ohne dass ein SSH-Server oder ein eingebettetes SSH-Passwort im Image erforderlich ist. Legacy Kudu WebSSH und az webapp ssh Zugriff erfordern möglicherweise weiterhin einen SSH-Server. Das Sample-Repository enthält ein altes SSH-Setup. Ersetzen Sie vor dem Bau den Inhalt der Dockerfile durch die folgende reine App-Konfiguration:

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/

COPY init.sh /usr/local/bin/

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

ENTRYPOINT ["init.sh"]

Ersetzen Sie den Inhalt von init.sh durch folgendes Skript, wobei Linux-Zeilenenden beibehalten werden:

#!/bin/bash
set -e

exec python /code/manage.py runserver 0.0.0.0:8000

Entferne die Legacy-sshd_config-Datei aus deinem lokalen Sample-Ordner, damit ADD . /code/ sie nicht ins Image kopiert.

Das Dockerfile installiert die Abhängigkeiten der App, kopiert die App und das Startskript und gibt den Port der Anwendung frei. Der Entrypoint startet nur die Python-Anwendung. Diese Änderungen entfernen die SSH-Installation und Zugangsdaten des Samples. Das Image enthält /bin/bash für das neuere Browser-Terminal und die Standard-Shell az webapp exec .

Lokales Erstellen und Testen des Images

Hinweis

Docker Hub erzwingt Kontingente für die Anzahl der anonymen Pulls pro IP und die Anzahl der authentifizierten Pulls pro kostenlosen Benutzer. Wenn Sie feststellen, dass Ihre Pulls von Docker Hub eingeschränkt sind, versuchen Sie, docker login auszuführen, wenn Sie nicht bereits angemeldet sind.

  1. Führen Sie den folgenden Befehl aus, um das Image zu erstellen:

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

  2. Testen Sie, ob der Build funktioniert, indem Sie den Docker-Container lokal ausführen:

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

    Dieser docker run Befehl gibt den Port mithilfe des -p Arguments an und enthält den Namen des Bilds. -it Sie können es mithilfe von STRG+C beenden.

    Tipp

    Wenn Sie unter Windows arbeiten und den Fehler *standard_init_linux.go:211: exec user process caused "no such file or directory" angezeigt wird, enthält die Datei init.sh CRLF-Zeilenenden anstelle der erwarteten LF-Endungen. Dieser Fehler tritt auf, wenn Sie Git zum Klonen des Beispielrepositorys verwendet haben, aber den Parameter --config core.autocrlf=input weggelassen haben. In diesem Fall klonen Sie das Repository erneut mit dem Argument --config. Der Fehler wird möglicherweise auch angezeigt, wenn Sie init.sh bearbeitet und mit CRLF-Zeilenenden gespeichert haben. Speichern Sie in diesem Fall die Datei nur mit LF-Zeilenenden erneut.

  3. Navigieren Sie zu http://localhost:8000, um zu bestätigen, dass die Web-App und der Container ordnungsgemäß funktionieren.

    Screenshot der Testergebnisse.

Benutzerzugewiesene verwaltete Identität erstellen

App Service kann entweder eine standardmäßige verwaltete Identität oder eine benutzerseitig zugewiesene verwaltete Identität verwenden, um sich bei einer Containerregistry zu authentifizieren. In diesem Tutorial verwenden Sie eine benutzerseitig zugewiesene verwaltete Identität.

  1. Führen Sie den Befehl az group create aus, um eine Ressourcengruppe zu erstellen:

    az group create --name msdocs-custom-container-tutorial --location westeurope

    Sie können den Wert --location ändern, um eine Region in Ihrer Nähe anzugeben.

  2. Erstellen Sie eine verwaltete Identität in der Ressourcengruppe:

    az identity create --name myID --resource-group msdocs-custom-container-tutorial

Erstellen einer Containerregistrierung

  1. Erstellen Sie mithilfe des folgenden az acr create-Befehls eine Container Registry. Ersetzen Sie <registry-name> durch einen eindeutigen Namen für Ihre Registry. Der Name darf nur Buchstaben und Ziffern enthalten und muss in Azure eindeutig sein.

    az acr create --name <registry-name> --resource-group msdocs-custom-container-tutorial --sku Basic --admin-enabled true

    Mit dem --admin-enabled Parameter können Sie Bilder mithilfe von Administratoranmeldeinformationen in die Registry übertragen.

  2. Rufen Sie die Administratoranmeldeinformationen ab, indem Sie den Befehl az credential acr show ausführen:

    az acr credential show --resource-group msdocs-custom-container-tutorial --name <registry-name>

    Die JSON-Ausgabe dieses Befehls enthält zwei Kennwörter sowie den Benutzernamen der Registry.

Übertragen Sie das Beispiel-Image in die Container Registry

In diesem Abschnitt übertragen Sie das Image an die Container Registry, die später von App Service verwendet wird.

  1. Verwenden Sie in dem lokalen Terminal, in dem Sie das Beispielimage erstellt haben, den Befehl docker login, um sich bei der Containerregistrierung anzumelden:

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

    Ersetzen Sie <registry-name> und <registry-username> durch die Werte aus den vorherigen Schritten. Geben Sie bei entsprechender Aufforderung eines der Kennwörter aus dem vorherigen Abschnitt ein.

    Verwenden Sie denselben Registrierungsnamen in allen verbleibenden Schritten dieses Abschnitts.

  2. Wenn die Anmeldung erfolgreich ist, taggen Sie Ihr lokales Docker-Image für die Registry:

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

  3. Pushen Sie das Image mithilfe des Befehls docker push in die Registry:

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

    Das erste Hochladen des Images kann einige Minuten dauern, da es das Basisimage enthält. Nachfolgende Uploads sind in der Regel schneller.

    Während Sie warten, können Sie die Schritte im nächsten Abschnitt ausführen, um App Service für die Bereitstellung über die Containerregistrierung zu konfigurieren.

Autorisieren Sie die verwaltete Identität für Ihre Registry

Die von Ihnen erstellte verwaltete Identität verfügt noch nicht über die Autorisierung zum Abrufen aus der Containerregistrierung. In diesem Schritt aktivieren Sie die Autorisierung.

  1. Rufen Sie die Prinzipal-ID für die verwaltete Identität ab:

    principalId=$(az identity show --resource-group msdocs-custom-container-tutorial --name myID --query principalId --output tsv)

  2. Rufen Sie die Ressourcen-ID für die Containerregistrierung ab:

    registryId=$(az acr show --resource-group msdocs-custom-container-tutorial --name <registry-name> --query id --output tsv)

  3. Erteilen Sie der verwalteten Identität die Berechtigung für den Zugriff auf die Container Registry:

    az role assignment create --assignee $principalId --scope $registryId --role "AcrPull"

    Weitere Informationen zu diesen Berechtigungen finden Sie unter Was ist die rollenbasierte Zugriffssteuerung in Azure?.

Web-App erstellen

  1. Erstellen Sie einen App Service-Plan mithilfe des az appservice plan create Befehls:

    az appservice plan create --name myAppServicePlan --resource-group msdocs-custom-container-tutorial --is-linux

    Ein App Service-Plan entspricht dem virtuellen Computer, der die Web-App hostet. Standardmäßig verwendet der vorherige Befehl einen preisgünstigen B1-Tarif, bei dem der erste Monat kostenlos ist. Sie können die Dienstebene mithilfe des Parameters --sku angeben.

  2. Erstellen Sie die Web-App mithilfe des Befehls az webapp create:

    az webapp create --resource-group msdocs-custom-container-tutorial --plan myAppServicePlan --name <app-name> --deployment-container-image-name <registry-name>.azurecr.io/appsvc-tutorial-custom-image:latest

    Ersetzen Sie <app-name> durch den Namen der Web-App. Der Name muss in ganz Azure eindeutig sein. Ersetzen Sie außerdem <registry-name> durch den Namen Ihrer Registry aus dem vorherigen Abschnitt.

    Tipp

    Sie können die Containereinstellungen der Web-App jederzeit mit dem Befehl az webapp config container show --name <app-name> --resource-group msdocs-custom-container-tutorialabrufen. Das Image wird in der Eigenschaft DOCKER_CUSTOM_IMAGE_NAME angegeben. Wenn die Web-App über Azure DevOps oder Azure Resource Manager-Vorlagen bereitgestellt wird, kann das Image auch in einer Eigenschaft mit dem Namen LinuxFxVersion angezeigt werden. Beide Eigenschaften dienen demselben Zweck. Sind beide in der Web-App-Konfiguration vorhanden, hat LinuxFxVersion Vorrang.

Web-App konfigurieren

In diesem Schritt konfigurieren Sie die Web-App wie folgt:

  • Konfigurieren Sie die App so, dass Anfragen an Port 8000 gesendet werden. Der Beispielcontainer lauscht auf Port 8000 auf Webanforderungen.
  • Konfigurieren Sie Ihre App so, dass die verwaltete Identität zum Abrufen von Bildern aus Ihrer Containerregistrierung verwendet wird.
  • Konfigurieren Sie die kontinuierliche Bereitstellung über die Containerregistrierung. (Jeder Push eines Images in die Registry veranlasst Ihre App, das neue Image abzurufen.) Dieser Schritt ist nicht erforderlich, um Ihre Web-App so zu konfigurieren, dass sie Images aus Ihrer Containerregistrierung abruft, aber er kann die Web-App benachrichtigen, wenn ein neues Image in die Registry gepusht wird. Wenn Sie diesen Schritt nicht abschließen, müssen Sie einen Bild-Pull manuell auslösen, indem Sie die Web-App neu starten.

  1. Verwenden Sie az webapp config appsettings set, um die Umgebungsvariable WEBSITES_PORT wie vom App-Code erwartet festzulegen:

    az webapp config appsettings set --resource-group msdocs-custom-container-tutorial --name <app-name> --settings WEBSITES_PORT=8000

    Ersetzen Sie <app-name> durch den Namen, den Sie im vorherigen Schritt verwendet haben.

  2. Aktivieren Sie die vom Benutzer zugewiesene verwaltete Identität in der Web-App mithilfe des az webapp identity assign Befehls:

    id=$(az identity show --resource-group msdocs-custom-container-tutorial --name myID --query id --output tsv)
az webapp identity assign --resource-group msdocs-custom-container-tutorial --name <app-name> --identities $id

    Ersetzen Sie <app-name> durch den Namen, den Sie im vorherigen Schritt verwendet haben.

  3. Konfigurieren Sie Ihre App so, dass sie mithilfe von verwalteten Identitäten aus Container Registry pullt.

    appConfig=$(az webapp config show --resource-group msdocs-custom-container-tutorial --name <app-name> --query id --output tsv)
az resource update --ids $appConfig --set properties.acrUseManagedIdentityCreds=True

    Ersetzen Sie <app-name> durch den Namen, den Sie im vorherigen Schritt verwendet haben.

  4. Legen Sie die Client-ID fest, die Ihre Web-App zum Abrufen aus der Containerregistrierung verwendet. Dieser Schritt ist nicht erforderlich, wenn Sie die vom System zugewiesene verwaltete Identität verwenden.

    clientId=$(az identity show --resource-group msdocs-custom-container-tutorial --name myID --query clientId --output tsv)
az resource update --ids $appConfig --set properties.AcrUserManagedIdentityID=$clientId

  5. CI/CD in App Service aktivieren

    cicdUrl=$(az webapp deployment container config --enable-cd true --name <app-name> --resource-group msdocs-custom-container-tutorial --query CI_CD_URL --output tsv)

    CI_CD_URL ist eine URL, die App Service für Sie generiert. Ihre Registry muss diese URL verwenden, um den App Service darüber zu informieren, dass ein Image gepusht wurde. Es erstellt den Webhook nicht wirklich für Sie.

  6. Erstellen Sie einen Webhook in Ihrer Containerregistrierung. Verwenden Sie die CI_CD_URL, die Sie im letzten Schritt erhalten haben.

    az acr webhook create --name appserviceCD --registry <registry-name> --uri $cicdUrl --actions push --scope appsvc-tutorial-custom-image:latest

  7. Um zu testen, ob Ihr Webhook ordnungsgemäß konfiguriert ist, pingen Sie den Webhook, und überprüfen Sie, ob Sie eine 200 OK-Antwort erhalten.

    eventId=$(az acr webhook ping --name appserviceCD --registry <registry-name> --query id --output tsv)
az acr webhook list-events --name appserviceCD --registry <registry-name> --query "[?id=='$eventId'].eventResponseMessage"

    Tipp

    Entfernen Sie den --query Parameter, um alle Informationen zu allen Webhook-Ereignissen anzuzeigen.

    Wenn Sie das Containerprotokoll streamen, sollten Sie nach dem Webhook-Ping eine Starting container for site-Meldung sehen, da der Webhook den Neustart der App auslöst.

Navigieren Sie zur Web-App

Um die App zu testen, browsen Sie zu https://<app-name>.azurewebsites.net. Ersetzen Sie <app-name> durch den Namen Ihrer Web-App.

Bei Ihrem ersten Zugriffsversuch auf die App kann es einige Zeit dauern, bis die App antwortet, da App Service das gesamte Image aus der Registrierung pullen muss. Aktualisieren Sie einfach die Seite, wenn im Browser eine Zeitüberschreitung auftritt. Nachdem das erste Image abgerufen wurde, werden nachfolgende Tests viel schneller ausgeführt.

Screenshot der Web-App, die in einem Browser ausgeführt wird.

Auf Diagnoseprotokolle zugreifen

Während Sie darauf warten, dass der App Service das Image abruft, ist es hilfreich, genau zu sehen, was App Service genau macht, indem Sie die Containerprotokolle in Ihr Terminal streamen.

  1. Aktivieren Sie die Containerprotokollierung:

    az webapp log config --name <app-name> --resource-group msdocs-custom-container-tutorial --docker-container-logging filesystem

  2. Aktivieren Sie den Protokolldatenstrom:

    az webapp log tail --name <app-name> --resource-group msdocs-custom-container-tutorial

    Falls Sie nicht sofort Konsolenprotokolle sehen, können Sie es nach 30 Sekunden noch einmal versuchen.

    Sie können die Protokolldateien auch über einen Browser überprüfen, indem Sie https://<app-name>.scm.azurewebsites.net/api/logs/docker aufrufen.

  3. Um das Protokollstreaming zu einem beliebigen Zeitpunkt zu beenden, wählen Sie STRG+Caus.

Ändern Sie den App-Code und stellen Sie ihn erneut bereit

In diesem Abschnitt ändern Sie den Web-App-Code, erstellen das Image neu und pushen es anschließend in Ihre Containerregistrierung. App Service pullt das aktualisierte Image dann automatisch aus der Registry, um die laufende Web-App zu aktualisieren.

  1. Öffnen Sie im lokalen Ordner docker-django-webapp-linux die Datei app/templates/app/index.html.

  2. Ändern Sie das erste HTML-Element entsprechend dem folgenden 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. Speichern Sie Ihre Änderungen.

  4. Wechseln Sie zum Ordner docker-django-webapp-linux , und erstellen Sie das Image neu:

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

  5. Aktualisieren Sie den Tag des Bildes auf latest:

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

    Ersetzen Sie <registry-name> durch den Namen Ihrer Registry.

  6. Übertragen Sie das Image per Push in die Registry:

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

  7. Sobald der Image-Push abgeschlossen ist, benachrichtigt der Webhook App Service über den Push, und App Service versucht, das aktualisierte Image zu pullen. Warten Sie ein paar Minuten, und überprüfen Sie dann, ob das Update bereitgestellt wurde, indem Sie zu https://<app-name>.azurewebsites.net gehen.

Stellen Sie mithilfe von SSH eine Verbindung mit dem Container her

Wenn der Container läuft, können Sie über den authentifizierten Kudu-Proxy von App Service mit dem neueren Browserterminal oder az webapp exec darauf zugreifen. Für diese Optionen musst du keinen SSH-Server im Image installieren oder starten.

Für Zugriffsvoraussetzungen und App- oder Slot-Steuerelemente siehe Eine Containershell (SSH) öffnen und Befehle ausführen.

Öffnen Sie die SSH-Verbindung zum Container

  1. Verwenden Sie Azure CLI 2.90.0 oder später und melden Sie sich bei Ihrem Azure-Konto an. Öffnen Sie eine interaktive Shell in Ihrem lokalen Terminal mit dem Vorschaubefehl az webapp exec :

    az webapp exec --resource-group msdocs-custom-container-tutorial --name <app-name>

  2. Untersuchen Sie die in der App laufenden Prozesse mithilfe von top, falls es im Image verfügbar ist.

Zum Ausführen von Befehlen im Hintergrund statt einer interaktiven Sitzung siehe Befehle ohne interaktive Sitzung ausführen. Die Annahme des Requests bestätigt nicht, dass ein Befehl erfolgreich ausgeführt wurde.

Ressourcen bereinigen

Die Ressourcen, die Sie in diesem Artikel erstellt haben, können laufende Kosten verursachen. Zum Bereinigen der Ressourcen müssen Sie nur die Ressourcengruppe löschen, in der die Ressourcen enthalten sind:

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

Nächste Schritte

Sie haben Folgendes gelernt:

  • Stellen Sie ein benutzerdefiniertes Image in einer privaten Containerregistrierung bereit.
  • Stellen Sie das benutzerdefinierte Image für App Service bereit.
  • Aktualisieren Sie das Image und stellen Sie es erneut bereit.
  • Greifen Sie auf Diagnoseprotokolle zu.
  • Stellen Sie eine Verbindung mit dem Container mittels SSH her.
  • Laden Sie ein benutzerdefiniertes Docker-Image in die Containerregistrierung hoch.
  • Stellen Sie das benutzerdefinierte Image für App Service bereit.
  • Konfigurieren Sie Umgebungsvariablen.
  • Ziehen Sie das Image mithilfe einer verwalteten Identität in App Service.
  • Greifen Sie auf Diagnoseprotokolle zu.
  • Aktivieren Sie CI/CD von Container Registry zu App Service.
  • Stellen Sie eine Verbindung mit dem Container mittels SSH her.

Wechseln Sie zum nächsten Lernprogramm:

  Bereitstellen von Sicherheit mit einer benutzerdefinierten Domäne und einem zertifikat

Oder schauen Sie sich andere Ressourcen an:

Benutzerdefinierten Container konfigurieren

Konfigurieren eines Sidecar-Containers für einen benutzerdefinierten Container in App Service

  • Zuletzt aktualisiert um