Migrieren benutzerdefinierter Software zu Azure App Service mithilfe eines benutzerdefinierten Containers

Azure App Service stellt vordefinierte Anwendungsstapel unter Windows wie ASP.NET oder Node.js bereit (ausgeführt unter IIS). Durch die vorkonfigurierte Windows-Umgebung werden beim Betriebssystem folgende Dinge verhindert:

• Administratorzugriff
• Softwareinstallationen
• Änderungen am globalen Assemblycache

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

Sie können ein speziell konfiguriertes Windows-Image über Visual Studio bereitstellen, um die für Ihre App erforderlichen Betriebssystemänderungen vorzunehmen. Daher ist es einfach, eine lokale App zu migrieren, für die eine benutzerdefinierte Betriebssystem- und Softwarekonfiguration erforderlich ist. 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 aus Visual Studio in der Azure Container Registry bereit und führen es dann in App Service aus.

Voraussetzungen

Für dieses Tutorial benötigen Sie Folgendes:

• Registrierung für ein Docker-Hub-Konto
• Installieren Sie Docker für Windows.
• Wechseln Sie Docker, um Windows-Container auszuführen.
• Installieren Sie Visual Studio 2022 mit den Workloads ASP.NET und Webentwicklung und Azure-Entwicklung. Sie haben Visual Studio 2022 bereits installiert:
  • Installieren Sie in Visual Studio die neuesten Updates, indem Sie Hilfe>Nach Updates suchen auswählen.
  • Fügen Sie in Visual Studio die Workloads hinzu, indem Sie Tools>Tools und Features abrufen auswählen.

Lokales Einrichten der App

Herunterladen des Beispiels

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

• Laden Sie das Beispielprojekt herunter.
• Extrahieren (Entzippen) Sie die Datei custom-font-win-container-master.zip.

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 Projekt ist jedoch ein Beispiel für eine App, die im zugrunde liegenden Betriebssystem integriert ist. Um eine solche App zu App Service zu migrieren, strukturieren Sie entweder Ihren Code neu, um die Integration zu entfernen, oder Sie migrieren sie unverändert zu einem benutzerdefinierten Windows-Container.

Installieren der Schriftart

Navigieren Sie in 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.

Ausführen der App

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

Geben Sie Ctrl+F5 ein, um die App ohne Debuggen auszuführen. Die App wird im Standardbrowser angezeigt.

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

Konfigurieren des Windows-Containers

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.

Wählen Sie Docker Compose>OK aus.

Ihr Projekt ist jetzt für die Ausführung in einem Windows-Container eingerichtet. Eine 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, übergeordnetes 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 gestartet wird.

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 er Images verwendet, die in Azure Container Registry gehostet werden.

Öffnen des Veröffentlichungs-Assistenten

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

Erstellen der Registrierung und Veröffentlichen

Wählen Sie im Veröffentlichungs-Assistenten Container Registry>Neue Azure Container Registry-Instanz erstellen>Veröffentlichen aus.

Anmelden mit Azure-Konto

Wählen Sie im Dialogfeld Neue Azure Container Registry-Instanz erstellen die Option Konto hinzufügen aus, und melden Sie sich bei Ihrem Azure-Abonnement an. Falls Sie bereits angemeldet sind, können Sie in der Dropdownliste das Konto mit dem gewünschten Abonnement auswählen.

Konfigurieren der Registrierung

Konfigurieren Sie die neue Containerregistrierung, basierend auf den in der folgenden Tabelle vorgeschlagenen Werten. Wählen Sie abschließend Erstellen aus.

Einstellung	Vorgeschlagener Wert	Weitere Informationen finden Sie unter
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 klicken Sie auf OK.
SKU	Basic	Tarife
Registrierungsstandort	Europa, Westen

Ein Terminalfenster wird geöffnet, worin der Status der Imagebereitstellung angezeigt wird. Warten Sie, bis die Bereitstellung abgeschlossen ist.

Anmelden bei Azure

Melden Sie sich beim Azure-Portal an.

Erstellen einer Web-App

Wählen Sie im linken Menü Ressource erstellen>Web>Web-App für Container aus.

Konfigurieren der grundlegenden App-Einstellungen

Konfigurieren Sie auf der Registerkarte Grundlagen die Einstellungen entsprechend der folgenden Tabelle, und wählen Sie dann Weiter: Docker aus.

Einstellung	Vorgeschlagener Wert	Weitere Informationen finden Sie unter
Abonnement	Vergewissern Sie sich, dass das richtige Abonnement ausgewählt ist.
Ressourcengruppe	Wählen Sie Neu erstellen aus, geben Sie myResourceGroup ein, und klicken Sie auf OK.
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	Docker-Container
Betriebssystem	Windows
Region	Europa, Westen
Windows-Plan	Wählen Sie Neu erstellen aus, geben Sie myAppServicePlan ein, und wählen Sie dann OK aus.

Die Registerkarte Grundlagen sollte wie folgt aussehen:

Konfigurieren des Windows-Containers

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

Einstellung	Vorgeschlagener Wert
Imagequelle	Azure-Containerregistrierung
Registrierung	Wählen Sie die zuvor erstellte Registrierung aus.
Image	customfontsample
Tag	latest

Abschließen der App-Erstellung

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

Navigieren zur Web-App

Wenn der Azure-Vorgang abgeschlossen ist, wird ein Benachrichtigungsfeld angezeigt.

1. Wählen Sie Zu Ressource wechseln aus.

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

Die folgende neue Browserseite wird geöffnet:

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

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

Anzeigen der Startprotokolle des Containers

Das Laden des Windows-Containers kann eine Weile dauern. Wenn Sie den Status anzeigen möchten, navigieren Sie zur folgenden URL. Ersetzen Sie dabei <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

Für Azure App Service wird die Containertechnologie von Docker genutzt, um sowohl integrierte als auch benutzerdefinierte Images zu hosten. Führen Sie zum Anzeigen einer Liste der integrierten Images 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

Container sollte auf die x86-x64-Architektur abzielen, ARM64 wird nicht unterstützt.

In diesem Tutorial lernen Sie Folgendes:

• Das Übertragen eines Docker-Images an Azure Container Registry mithilfe eines Push-Vorgangs
• Das Ausführen des benutzerdefinierten Images in App Service
• Konfigurieren von Umgebungsvariablen
• Abrufen eines Images in App Service mithilfe einer verwalteten Identität
• Zugreifen auf Diagnoseprotokolle
• Das Aktivieren von CI/CD für App Service aus der Azure Container Registry
• Herstellen einer Verbindung mit dem Container per SSH

Bei diesem Tutorial fällt in Ihrem Azure-Konto eine geringfügige Gebühr für die Containerregistrierung an. Wird der Container länger als einen Monat gehostet, können weitere Kosten anfallen.

Einrichten der anfänglichen Umgebung

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.

• Sie benötigen ein Azure-Konto mit einem aktiven Abonnement. Sie können kostenlos ein Konto erstellen.

• Verwenden Sie die Bash-Umgebung in Azure Cloud Shell. Weitere Informationen finden Sie unter Schnellstart für Bash in Azure Cloud Shell.

  

• Wenn Sie CLI-Referenzbefehle lieber lokal ausführen, installieren Sie die Azure CLI. Wenn Sie Windows oder macOS ausführen, sollten Sie die Azure CLI in einem Docker-Container ausführen. Weitere Informationen finden Sie unter Ausführen der Azure CLI in einem Docker-Container.

  • Wenn Sie eine lokale Installation verwenden, melden Sie sich mithilfe des Befehls az login bei der Azure CLI an. Führen Sie die in Ihrem Terminal angezeigten Schritte aus, um den Authentifizierungsprozess abzuschließen. Informationen zu anderen Anmeldeoptionen finden Sie unter Anmelden mit der Azure CLI.

  • Installieren Sie die Azure CLI-Erweiterung beim ersten Einsatz, wenn Sie dazu aufgefordert werden. Weitere Informationen zu Erweiterungen finden Sie unter Verwenden von Erweiterungen mit der Azure CLI.

  • Führen Sie az version aus, um die installierte Version und die abhängigen Bibliotheken zu ermitteln. Führen Sie az upgrade aus, um das Upgrade auf die aktuelle Version durchzuführen.

• 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 Herunterladen der Beispiel-App

Das Beispiel für dieses Tutorial können Sie herunterladen oder mithilfe von „Git Clone“ klonen.

Klonen mit Git

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 anschließend zum folgenden Ordner:

cd docker-django-webapp-linux

Von GitHub herunterladen

Statt „Git Clone“ zu verwenden, können Sie zu https://github.com/Azure-Samples/docker-django-webapp-linux navigieren und dann Klonen und ZIP herunterladen auswählen.

Entpacken Sie die ZIP-Datei in einem Ordner mit dem Namen docker-django-webapp-linux.

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

(Optional) Untersuchen der Docker-Datei

Die Datei im Beispiel mit dem Namen Dockerfile, die das Docker-Image beschreibt und Konfigurationsanweisungen enthält:

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

• Mit der ersten Gruppe von Befehlen werden die erforderlichen Komponenten der App in der Umgebung installiert.
• Mit der zweiten Gruppe von Befehlen wird ein SSH-Server für eine sichere Kommunikation zwischen dem Container und dem Host erstellt.
• Mit der letzten Zeile (ENTRYPOINT ["init.sh"]) wird init.sh aufgerufen, um den SSH-Dienst und den Python-Server zu starten.

Lokales Erstellen und Testen des Images

Hinweis

Docker Hub verfügt über Kontingente für die Anzahl anonymer Pullvorgänge pro IP-Adresse und die Anzahl authentifizierter Pullvorgänge pro Free-Benutzer (siehe Datenübertragungen). Wenn Sie bemerken, dass die Pullvorgänge aus Docker Hub eingeschränkt sind, probieren Sie docker login aus, falls 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
   

   Mit diesem docker run-Befehl wird mit dem Argument -p der Port gefolgt vom Namen des Images angegeben. Sie könnenCtrl+C mit -it beenden.

   Tipp

   Wenn Sie Windows verwenden und der Fehler „standard_init_linux.go:211: exec user process caused "Datei oder Verzeichnis nicht vorhanden"“ angezeigt wird, enthält die Datei init.sh CRLF-Zeilenenden anstelle der erwarteten LF-Zeilenenden. Dieser Fehler tritt auf, wenn Sie Git zum Klonen des Beispielrepositorys verwendet, aber den Parameter --config core.autocrlf=input ausgelassen 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. Rufen Sie http://localhost:8000 auf, um zu überprüfen, ob Web-App und Container ordnungsgemäß funktionieren.

   

I. Erstellen einer benutzerseitig zugewiesenen verwalteten Identität

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

Azure-Befehlszeilenschnittstelle

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
   

Azure portal

I.A. Im Azure-Portal:

1. Geben Sie in der Suchleiste oben im Azure-Portal „Verwaltete Identitäten“ ein.
2. Wählen Sie unter der Überschrift Dienste das Element mit der Bezeichnung Verwaltete Identitäten aus.
3. Klicken Sie auf Erstellen. Sie können auch direkt zum Erstellungs-Assistenten navigieren.

I.B. Im Erstellungs-Assistenten:

1. Wählen Sie unter Abonnement das Abonnement aus, in dem Sie Ihre Ressourcen erstellen möchten.
2. Wählen Sie unter Ressourcengruppe die Option Neu erstellen aus, geben Sie den Namen msdocs-custom-container-tutorial für die Ressourcengruppe ein, und geben Sie dann OK ein.
3. Wählen Sie unter Region die Option Europa, Westen oder eine Region in Ihrer Nähe aus.
4. Geben Sie in Name den Wert myID ein.

I.C.

1. Wählen Sie die Registerkarte Überprüfen + erstellen aus.
2. Klicken Sie auf Erstellen.

I.D. Wenn die Erstellung der Identität abgeschlossen ist, können Sie die zugehörige Verwaltungsseite öffnen, indem Sie Zu Ressource wechseln auswählen.

II. Erstellen einer Containerregistrierung

Azure-Befehlszeilenschnittstelle

1. Erstellen Sie eine Containerregistrierung mit dem Befehl az acr create, und ersetzen Sie <registry-name> durch einen eindeutigen Namen für Ihre Registrierung. 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 Parameter --admin-enabled können Sie Images mithilfe eines Satzes von Administratoranmeldeinformationen in die Registrierung pushen.

2. Rufen Sie die Administratoranmeldeinformationen ab, indem Sie den Befehl az 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 Registrierung.

Azure portal

II.A. Führen Sie im Azure-Portal die folgenden Schritte aus:

1. Geben Sie oben im Azure-Portal in der Suchleiste „Containerregistrierungen“ ein.
2. Wählen Sie unter der Überschrift Dienste das Element mit der Bezeichnung Containerregistrierungen aus.
3. Klicken Sie auf Erstellen. Sie können auch direkt zum Erstellungs-Assistenten navigieren.

II.B. Im Erstellungs-Assistenten:

1. Wählen Sie unter Abonnement das zuvor verwendete Abonnement aus.
2. Wählen Sie unter Ressourcengruppe die Option msdocs-custom-container-tutorial aus.
3. Geben Sie unter Registrierungsname einen eindeutigen Namen für Ihre Containerregistrierung ein.
4. Wählen Sie unter Standort die Option Europa, Westen oder dieselbe Region wie die Ihrer verwalteten Identität aus.
5. Wählen Sie in SKUBasic aus.

II.C.

1. Wählen Sie die Registerkarte Überprüfen + erstellen aus.
2. Klicken Sie auf Erstellen.

II.D. Wenn die Erstellung der Containerregistrierung abgeschlossen ist, öffnen Sie die zugehörige Verwaltungsseite, indem Sie Zu Ressource wechseln auswählen.

II.E. Im linken Navigationsmenü:

1. Wählen Sie Zugriffsschlüssel aus.
2. Wählen Sie unter Administratorbenutzer die Option Aktiviert aus.
3. Kopieren Sie die Werte für Anmeldeserver, Benutzername und Kennwort. Diese verwenden Sie im nächsten Schritt, um sich bei der Registrierung anzumelden und ein Docker-Image zu pushen.

III. Pushen des Beispielimages in die Azure Container Registry

In diesem Abschnitt pushen Sie das Image in die Azure 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 Schritt ein.

   Sie verwenden in allen verbleibenden Schritten dieses Abschnitts denselben Registrierungsnamen.

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

   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 Registrierung:

   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 Registrierung zu konfigurieren.

IV. Autorisieren der verwalteten Identität für Ihre Registrierung

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

Azure-Befehlszeilenschnittstelle

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 Containerregistrierung:

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

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

Azure portal

IV.A. Zurück auf der Verwaltungsseite für die Containerregistrierung:

1. Wählen Sie im linken Navigationsmenü Zugriffssteuerung (IAM) aus.
2. Wählen Sie Rollenzuweisung hinzufügen aus.

IV.B. Wählen Sie in der Liste AcrPull aus.

IV.C.:

1. Wählen Sie die Registerkarte Mitglieder aus.
2. Wählen Sie unter Zugriff zuweisen an die Option Verwaltete Identität aus.
3. Wählen Sie unter Mitglieder die Option Mitglieder auswählen aus.

IV.D.

1. Wählen Sie unter Verwaltete Identität die Option Benutzerseitig zugewiesene verwaltete Identität aus.
2. Wählen Sie unter Auswählen die Option myID aus.

IV.E.

1. Wählen Sie die Registerkarte Überprüfen + Zuweisen aus.
2. Wählen Sie am unteren Rand Überprüfen + zuweisen aus.

V. Erstellen der Web-App

Azure-Befehlszeilenschnittstelle

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

   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 den preisgünstigen B1-Tarif, bei dem der erste Monat kostenlos ist. Sie können den Tarif mit dem Parameter --sku steuern.

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 einen Namen für die Web-App, der innerhalb von Azure eindeutig sein muss. Ersetzen Sie außerdem <registry-name> durch den Namen Ihrer Registrierung 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.

Azure portal

V.A. Im Azure-Portal:

1. Geben Sie in der Suchleiste oben im Azure-Portal „App“ ein.
2. Wählen Sie unter der Überschrift Dienste das Element mit der Bezeichnung App Services aus.
3. Klicken Sie auf Erstellen. Sie können auch direkt zum Erstellungs-Assistenten navigieren.

V.B. Im Erstellungs-Assistenten:

1. Wählen Sie unter Abonnement das zuvor verwendete Abonnement aus.
2. Wählen Sie unter Ressourcengruppe die Option msdocs-custom-container-tutorial aus.
3. Geben Sie in Name einen eindeutigen App-Namen ein, der im Standardhostname Ihrer App verwendet wird: <app-name>.azurewebsites.net.
4. Wählen Sie unter Veröffentlichen die Option Docker-Container aus.
5. Wählen Sie unter Betriebssystem die Option Linux aus.
6. Wählen Sie unter Region die Option Europa, Westen oder eine Region in Ihrer Nähe aus.
7. Wählen Sie unter Linux-Plan (Europa, Westen) die Option Neu erstellen aus, geben Sie einen Plannamen ein, und wählen Sie OK aus.
8. Wählen Sie unter Tarif die Option Größe ändern aus.

V.C. In der Spezifikationsauswahl:

1. Wählen Sie Dev/Test aus.
2. Wählen Sie B1 aus.
3. Wählen Sie Übernehmen.

V.D. Zurück im Assistenten zum Erstellen von Web-Apps:

1. Wählen Sie die Registerkarte Docker aus.
2. Wählen Sie unter Imagequelle die Option Azure Container Registry aus.
3. Wählen Sie unter Registrierung die zuvor erstellte Containerregistrierung aus.
4. Wählen Sie unter Image die Option appsvc-tutorial-custom-image aus.
5. Wählen Sie unter Tag die Option Neueste aus.

V.E.

1. Wählen Sie die Registerkarte Überprüfen + erstellen aus.
2. Klicken Sie auf Erstellen.

V.F. Wenn die Erstellung der Web-App abgeschlossen ist, können Sie die zugehörige Verwaltungsseite öffnen, indem Sie Zu Ressource wechseln auswählen.

VI. Konfigurieren der Web-App

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

• Der Beispielcontainer lauscht an Port 8000 auf Webanforderungen, und Sie konfigurieren die App so, dass sie Anforderungen an Port 8000 sendet.
• Weisen Sie Ihre App an, die verwaltete Identität zum Pullen von Images aus Ihrer Containerregistrierung zu verwenden.
• Konfigurieren Sie Continuous Deployment aus der Containerregistrierung (sonst löst jeder Imagepush in die Registrierung Ihre App aus, um das neue Image zu pullen). Dieser Teil ist nicht erforderlich, damit Ihre Web-App aus Ihrer Containerregistrierung pullen kann, aber er kann Ihre Web-App darüber informieren, wenn ein neues Image in die Registrierung gepusht wird. Ohne ihn müssen Sie einen Imagepull manuell auslösen, indem Sie die Web-App neu starten.

Azure-Befehlszeilenschnittstelle

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.

   Weitere Informationen zu dieser Umgebungsvariablen finden Sie in der Infodatei im GitHub-Repository des Beispiels.

2. Aktivieren Sie die benutzerseitig zugewiesene verwaltete Identität in der Web-App mit dem Befehl az webapp identity assign:

   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 verwalteter Identitäten aus der Azure 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 Pullen aus der Azure Container Registry verwendet. Dieser Schritt ist nicht erforderlich, wenn Sie die systemseitig 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. Aktivieren Sie CI/CD in dem App Service.

   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 den App Service für Sie generiert. Ihre Registrierung muss diese URL verwenden, um den App Service darüber zu informieren, dass ein Image gepusht wurde. Der Webhook wird nicht tatsächlich für Sie erstellt.

6. Erstellen Sie einen Webhook in Ihrer Containerregistrierung unter der Verwendung der 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 an, und überprüfen Sie, ob Sie die Antwort „200 OK“ 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, sollte diese Meldung nach dem Webhook-Ping angezeigt werden: Starting container for site, da der Webhook den Neustart der App auslöst.

Azure portal

VI.A. Wählen Sie auf der Verwaltungsseite Ihrer Web-App die Option Konfiguration aus.

VI.B. Auf der Seite „Konfiguration“:

1. Klicken Sie auf Neue Anwendungseinstellung.
2. Geben Sie in Name den Wert WEBSITES_PORT ein.
3. Geben Sie in Wert die Zeichenfolge 8000 ein.
4. Klicken Sie auf OK.
5. Wählen Sie im oberen Menü Speichern und dann Weiter aus. Die WEBSITES_PORT-Einstellung gibt den Containerport an, an den Webanforderungen weitergeleitet werden sollen. Weitere Informationen finden Sie unter App-Einstellungen für benutzerdefinierte Container.

VI.C. Wählen Sie im linken Navigationsbereich Identität aus. Führen Sie dann Folgendes auf der Seite „Identität“ aus:

1. Wählen Sie die Registerkarte Benutzerseitig zugewiesen aus.
2. Wählen Sie Hinzufügen.

VI.D.

1. Wählen Sie myID aus.
2. Wählen Sie Hinzufügen.

VI.E. Wählen Sie im linken Navigationsbereich Bereitstellungscenter aus. Führen Sie dann Folgendes auf der Seite „Bereitstellungscenter“ aus:

1. Wählen Sie unter Authentifizierung die Option Verwaltete Identität aus.
2. Wählen Sie unter Identität die Option myID aus.
3. Wählen Sie unter Continuous Deployment die Option Ein aus.
4. Wählen Sie im oberen Menü Speichern aus. Wenn Sie Continuous Deployment in eine Containerregistrierung aktivieren, wird der Registrierung für Ihre Web-App automatisch ein Webhook hinzugefügt.

VI.F. Wählen Sie auf der Seite „Bereitstellungscenter“ die Registerkarte Protokolle aus. Hier werden Protokollmeldungen zum Pullen des Images und zum Starten des Containers angezeigt. Später erfahren Sie, wie Sie eine Konsolennachricht anzeigen, die im Container generiert wurde.

VII. Navigieren zur Web-App

Azure-Befehlszeilenschnittstelle

Navigieren Sie zum Testen der App zu https://<app-name>.azurewebsites.net, und ersetzen Sie <app-name> durch den Namen Ihrer Web-App.

Azure portal

VII.A. Auf der App Service-Seite:

1. Wählen Sie im linken Navigationsmenü Übersicht aus.
2. Wählen Sie unter URL den Link aus.

Beim ersten Zugriff kann es einige Zeit dauern, bis die App antwortet, da App Service das gesamte Image aus der Registrierung abrufen muss. Aktualisieren Sie einfach die Seite, wenn für den Browser eine Zeitüberschreitung eintritt. Nach dem Pullen des anfänglichen Images werden nachfolgende Tests wesentlich schneller ausgeführt.

VIII. Zugreifen auf Diagnoseprotokolle

Azure-Befehlszeilenschnittstelle

Während Sie darauf warten, dass der App Service das Image abruft, ist es hilfreich, genau zu sehen, was der App Service durchführt, indem Sie die Containerprotokolle an 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 im Browser unter https://<app-name>.scm.azurewebsites.net/api/logs/docker untersuchen.

3. Um das Protokollstreaming jederzeit zu beenden, geben Sie Ctrl+C ein.

Azure portal

Auf der Seite „Bereitstellungscenter“ werden bereits die Protokollmeldungen zum Pullen und Starten des Containers angezeigt. In diesem Schritt können Sie die Protokollierung der Konsolenausgabe aus dem Container aktivieren.

VIII.A. Auf der App Service-Seite:

1. Wählen Sie im linken Navigationsmenü App Service-Protokolle aus.
2. Wählen Sie unter Anwendungsprotokollierung die Option Dateisystem aus.
3. Wählen Sie Speichern aus.

VIII.B. Wählen Sie im linken Navigationsmenü Protokollstream aus. Die Konsolenausgabe des Containers sollte nun im Protokollstream angezeigt werden.

IX. Ändern des App-Codes und erneutes Bereitstellen

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 Registrierung, um die ausgeführte 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 die Änderungen.

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

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

5. Aktualisieren Sie das Tag des Images auf den neuesten Stand:

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

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

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

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

7. Sobald der Image-Push abgeschlossen ist, benachrichtigt der Webhook den App Service über den Push, und App Service versucht, das aktualisierte Image per Pull zu abzurufen. Warten Sie einige Minuten, und überprüfen Sie dann, ob die Aktualisierung bereitgestellt wurde, indem Sie zu https://<app-name>.azurewebsites.net navigieren.

X. Herstellen einer Verbindung mit dem Container per SSH

SSH ermöglicht die sichere Kommunikation zwischen einem Container und einem Client. Zum Aktivieren der SSH-Verbindung mit Ihrem Container muss Ihr benutzerdefiniertes Image dafür konfiguriert werden. Sobald der Container ausgeführt wird, können Sie eine SSH-Verbindung öffnen.

Konfigurieren des Containers für SSH

Die in diesem Tutorial verwendete Beispiel-App verfügt bereits über die notwendige Konfiguration im Dockerfile, das den SSH-Server installiert und außerdem die Anmeldeinformationen festlegt. Dieser Abschnitt dient nur zu Informationszwecken. Fahren Sie mit dem nächsten Abschnitt fort, um eine Verbindung mit dem Container herzustellen.

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 

Hinweis

Diese Konfiguration erlaubt keine externen Verbindungen zum Container. SSH ist nur über die Kudu/SCM-Website verfügbar. Die Authentifizierung für die Kudu/SCM-Website wird über Ihr Azure-Konto durchgeführt. root:Docker! darf nicht in SSH geändert werden. SCM/KUDU verwendet Ihre Anmeldeinformationen im Azure-Portal. Wenn Sie diesen Wert ändern, tritt bei Verwenden von SSH ein Fehler auf.

Das Dockerfile kopiert außerdem die Datei sshd_config in den Ordner /etc/ssh/ und macht Port 2222 für den Container verfügbar:

COPY sshd_config /etc/ssh/

# ...

EXPOSE 8000 2222

Port 2222 ist ein interner Port, auf den nur von Containern innerhalb des Brückennetzwerks eines privaten virtuellen Netzwerks zugegriffen werden kann.

Mit dem Eingangsskript init.sh wird der SSH-Server schließlich gestartet.

#!/bin/bash
service ssh start

Öffnen einer SSH-Verbindung mit einem Container

Azure-Befehlszeilenschnittstelle

1. Navigieren Sie zu https://<app-name>.scm.azurewebsites.net/webssh/host, und melden Sie sich mit Ihrem Azure-Konto an. Ersetzen Sie <app-name> durch den Namen Ihrer Web-App.

2. Nachdem Sie sich angemeldet haben, werden Sie auf eine Informationsseite für die Web-App umgeleitet. Wählen Sie oben auf der Seite SSH aus, um die Shell zu öffnen und Befehle zu verwenden.

   Beispielsweise können Sie mithilfe des Befehls top die Prozesse untersuchen, die darin ausgeführt werden.

Azure portal

X.A. Auf der Seite „App Service“:

1. Wählen Sie im linken Navigationsmenü SSH aus.
2. Klicken Sie auf Starten.

X.B. Die SSH-Sitzung wird in einer neuen Browserregisterkarte geöffnet. Warten Sie, bis in der Statusleiste unten in Grün SSH CONNECTION ESTABLISHED angezeigt wird. Sie können dann Befehle aus dem Container heraus ausführen. Konfigurationsänderungen, die an Ihrem Container vorgenommen werden, bleiben über App-Neustarts hinaus nicht erhalten.

XI. Bereinigen von Ressourcen

Azure-Befehlszeilenschnittstelle

In diesem Artikel erstellte Ressourcen 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

Azure portal

XI.A. In der Suchleiste oben im Azure-Portal:

1. Geben Sie den Ressourcengruppennamen ein.
2. Wählen Sie die Ressourcengruppe aus.

XI.B. Wählen Sie auf der Seite „Ressourcengruppe“ die Option Ressourcengruppe löschen aus.

XI.C.

1. Geben Sie den Namen der Ressourcengruppe ein, um Ihre Löschung zu bestätigen.
2. Klicken Sie auf Löschen.

:

Nächste Schritte

Sie haben Folgendes gelernt:

• Bereitstellen eines benutzerdefinierten Images in einer privaten Containerregistrierung
• Bereitstellen des benutzerdefinierten Images in App Service
• Aktualisieren und erneutes Bereitstellen des Images
• Zugreifen auf Diagnoseprotokolle
• Herstellen einer Verbindung mit dem Container per SSH

• Das Übertragen eines Docker-Images an Azure Container Registry mithilfe eines Push-Vorgangs
• Das Ausführen des benutzerdefinierten Images in App Service
• Konfigurieren von Umgebungsvariablen
• Abrufen eines Images in App Service mithilfe einer verwalteten Identität
• Zugreifen auf Diagnoseprotokolle
• Das Aktivieren von CI/CD für App Service aus der Azure Container Registry
• Herstellen einer Verbindung mit dem Container per SSH

Im nächsten Tutorial erfahren Sie, wie Sie Ihre App mit einer benutzerdefinierten Domäne und einem Zertifikat schützen.

 Schützen mit benutzerdefinierter Domäne und einem Zertifikat

Oder sehen Sie sich weitere Ressourcen an:

Konfigurieren eines benutzerdefinierten Containers

Konfigurieren von Sidecar

Tutorial: Konfigurieren eines Sidecar-Containers für benutzerdefinierte Container in Azure App Service (Preview)