Erstellen einer containerisierten Python-Web-App in der Cloud

Azure CLI-Befehle können in der Azure Cloud Shell oder auf einer Arbeitsstation ausgeführt werden, auf der die Azure CLIinstalliert ist. Wenn die Ausführung in Cloud Shell erfolgt, überspringen Sie Schritt 3.

1. Erstellen Sie mithilfe des Befehls az group create eine Ressourcengruppe, falls erforderlich. Wenn Sie in Teil 2. Lokales Erstellen und Testen des Containers dieses Tutorials bereits ein Konto für Azure Cosmos DB for MongoDB eingerichtet haben, legen Sie die Umgebungsvariable RESOURCE_GROUP_NAME auf den Namen der Ressourcengruppe fest, die Sie für dieses Konto verwendet haben, und fahren Sie mit dem nächsten Schritt fort.

   RESOURCE_GROUP_NAME='msdocs-web-app-rg'
   LOCATION='eastus'
   
   az group create -n $RESOURCE_GROUP_NAME -l $LOCATION
   

   LOCATION sollte ein Azure-Standortwert sein. Wählen Sie einen Ort in Ihrer Nähe aus. Sie können Azure-Standortwerte mit dem folgenden Befehl auflisten: az account list-locations -o table.

2. Erstellen Sie eine Container-Registrierung mit dem Befehl az acr create.

   REGISTRY_NAME='<your Azure Container Registry name>'
   
   az acr create -g $RESOURCE_GROUP_NAME -n $REGISTRY_NAME --sku Basic
   

   REGISTRY_NAME müssen in Azure eindeutig sein und 5-50 alphanumerische Zeichen enthalten.

   Suchen Sie in der JSON-Ausgabe des Befehls nach dem wert loginServer, bei dem es sich um den vollqualifizierten Registrierungsnamen (alle Kleinbuchstaben) handelt und der den von Ihnen angegebenen Registrierungsnamen enthalten soll.

3. Wenn Sie die Azure CLI lokal ausführen, melden Sie sich mit dem Befehl az acr login beim Registry an.

   az acr login -n $REGISTRY_NAME
   

   Der Befehl fügt „azurecr.io“ an den Namen an, um den voll qualifizierten Registrierungsnamen zu erstellen. Bei erfolgreicher Ausführung wird die Meldung "Anmeldung erfolgreich" angezeigt.

   Anmerkung

   Der Befehl az acr login wird in Cloud Shell nicht benötigt oder unterstützt.

Für diese Schritte ist die Docker-Erweiterung für VS Code erforderlich.

1. Wählen Sie F1 oder Strg+Umschalt+P, um die Befehlspalette zu öffnen. Geben Sie dann "registry" ein, und wählen Sie die Aufgabe Azure Container Registry: Registrierung erstellen aus.

   Alternativ können Sie im Abschnitt REGISTRIERUNGEN der Docker-Erweiterung mit der rechten Maustaste auf Ihr Abonnement klicken und Registrierung erstellenauswählen. Diese Aktion der Benutzeroberfläche startet denselben Registrierungserstellungsvorgang.

2. Folgen Sie den Eingabeaufforderungen, und geben Sie die folgenden Werte ein:

   • Registrierungsname: Der Registrierungsname muss in Azure eindeutig sein und 5-50 alphanumerische Zeichen enthalten.

   • Produktnummer → Wählen Sie Standard.

   • Ressourcengruppe: Verwenden Sie eine vorhandene Gruppe, oder erstellen Sie eine neue Gruppe.

   • Speicherort: Wenn Sie eine vorhandene Ressourcengruppe verwenden, wählen Sie den passenden Speicherort aus. Andernfalls entspricht der Standort dem Ort, an dem die Ressourcengruppe erstellt wird, die die Registrierung enthält.

   

3. Suchen Sie in der Docker-Erweiterung im Abschnitt REGISTRIERUNGEN die von Ihnen erstellte Registrierung, klicken Sie mit der rechten Maustaste, und wählen Sie Eigenschaften anzeigen aus.

   Suchen Sie in der Ausgabe nach dem Schlüssel-Wert-Paar loginServer. Der Wert ist der vollqualifizierte Name der Registrierung.

   

Melden Sie sich beim Azure-Portal an, und führen Sie die folgenden Schritte aus, um eine Azure-Containerregistrierung zu erstellen.

1. Suchen Sie nach "Containerregistrierung" und wählen Sie Containerregistrierung unter Marketplace in den Suchergebnissen aus.

2. Geben Sie unter der Registerkarte Grundlagen im Formular Containerregistrierung erstellen die folgenden Werte ein:

   • Ressourcengruppe: Verwenden Sie eine vorhandene Gruppe, oder erstellen Sie eine neue Gruppe.
   • Registrierungsname: Der Registrierungsname muss in Azure eindeutig sein und 5-50 alphanumerische Zeichen enthalten.
   • Speicherort: Wenn Sie eine vorhandene Ressourcengruppe verwenden, wählen Sie den passenden Speicherort aus. Andernfalls entspricht der Standort dem Ort, an dem die Ressourcengruppe erstellt wird, die die Registrierung enthält.
   • Produktnummer → Wählen Sie Standard.

   

   Wählen Sie Überprüfen und erstellen aus, wenn Sie fertig sind. Wählen Sie nach Abschluss der Validierung Erstellen aus.

3. Gehen Sie nach Abschluss der Bereitstellung zur neuen Registrierung und suchen Sie den vollqualifizierten Namen.

   1. Wählen Sie im Menü Dienst die Option Übersicht.
   2. Kopieren Sie den Wert desAnmeldeservers. Es sollte ein vollqualifizierter Name mit "azurecr.io" sein.

   

4. Das Administratorkonto ist erforderlich, um ein Container-Image aus einer Registry in Azure Web Apps für Container bereitzustellen.

   1. Wählen Sie im Dienstmenü die Option Zugriffsschlüssel aus.
   2. Wählen Sie Aktiviert für den Admin-Benutzer.

   

   Das Administratorkonto der Registrierung, ist erforderlich, wenn Sie das Azure-Portal verwenden, um ein Containerimage bereitzustellen, wie in diesem Tutorial gezeigt. Das Administratorkonto wird nur während der Erstellung des App-Diensts verwendet. Nachdem der App-Dienst erstellt wurde, wird die verwaltete Identität verwendet, um Bilder aus der Registrierung abzurufen, und das Administratorkonto kann deaktiviert werden.

Azure CLI-Befehle können auf einer Workstation mit installierter Azure CLI oder in Azure Cloud Shell ausgeführt werden. Wenn Sie in Cloud Shell arbeiten, überspringen Sie Schritt 1.

1. Wenn Sie die Azure CLI lokal ausführen, melden Sie sich im Registry an, falls Sie dies noch nicht mit dem Befehl "az acr login" getan haben.

   az acr login -n $REGISTRY_NAME
   

   Wenn Sie auf das Register aus einem anderen Abonnement zugreifen als dem, in dem das Register erstellt wurde, verwenden Sie die Option --suffix.

   Anmerkung

   Der Befehl az acr login wird nicht benötigt und wird in Cloud Shell nicht unterstützt.

2. Erstellen Sie das Image mit dem Befehl az acr build.

   az acr build -r $REGISTRY_NAME -g $RESOURCE_GROUP_NAME -t msdocspythoncontainerwebapp:latest .
   

   In diesem Befehl:

   • Der Punkt (".") am Ende des Befehls gibt den Speicherort des zu erstellenden Quellcodes an. Wenn Sie diesen Befehl nicht im Stammverzeichnis der Beispiel-App ausführen, geben Sie den Pfad zum Code an.

     Anstatt einen Pfad zum Code in Ihrer Umgebung anzugeben, können Sie optional einen Pfad zum GitHub-Beispiel-Repository angeben: https://github.com/Azure-Samples/msdocs-python-django-container-web-app oder https://github.com/Azure-Samples/msdocs-python-flask-container-web-app.

   • Wenn Sie die Option „-t“ (wie „--image“) weglassen, stellt der Befehl einen lokalen Kontext-Build in die Warteschlange, ohne ihn in die Registrierung zu stellen. Erstellen ohne Pushen kann nützlich sein, um zu überprüfen, ob das Image erstellt wird.

3. Bestätigen Sie, dass das Container-Image erstellt wurde mit dem Befehl az acr repository list.

   az acr repository list -n $REGISTRY_NAME
   

Für diese Schritte ist die Docker-Erweiterung für VS Code erforderlich. VS Code muss im Arbeitsordner Ihrer Web-App geöffnet werden.

1. Wechseln Sie in der Docker-Erweiterung zu REGISTRIES, und stellen Sie eine Verbindung mit Azure her.

   

2. Wählen Sie F1 oder STRG+UMSCHALT+P aus, um die Befehlspalette zu öffnen, geben Sie "Registrierung" ein, und wählen Sie die Aufgabe Azure Container Registry: Image in Azure erstellen aus.

   Wenn die Aufgabe nicht sichtbar ist, stellen Sie sicher, dass Azure unter REGISTRIERUNGEN in der Docker-Erweiterung angezeigt wird. Sie können auch mit der rechten Maustaste auf die Dockerfile klicken und Image in Azure erstellen auswählen, um die Aufgabe auszuführen.

3. Folgen Sie den Anweisungen, und geben Sie die folgenden Werte ein, um das Image zu erstellen.

   • Tag für Bild: Verwenden Sie den Bildnamen "msdocspythoncontainerwebapp:latest".
   • Register: Wählen Sie das oben erstellte Register oder ein Register aus, auf das Sie Zugriff haben.
   • Betriebssystem-Basisimage: Wählen Sie Linux aus.

   

   Überprüfen Sie das AUSGABEFENSTER auf Fortschritt und Informationen zum Build. Wenn Sie einen Anmeldeinformationsfehler erhalten, klicken Sie im Abschnitt REGISTRIERUNGEN der Docker-Erweiterung mit der rechten Maustaste auf den Registrierungseintrag und wählen Sie Aktualisieren aus.

4. Bestätigen Sie das Image im Azure Container Registry.

   1. Suchen Sie in der Docker-Erweiterung im Abschnitt REGISTRIERUNGEN das erstellte Containerimage.

   2. Bestätigen Sie den Namen und den Tag "latest" ("neueste").

   

Melden Sie sich beim Azure-Portal an, um die folgenden Schritte abzuschließen.

1. Öffnen Sie Azure Cloud Shell.

   

2. Erstellen Sie das Image mit dem Befehl az acr build.

   az acr build \
     -r <registry-name> \
     -g <resource-group> \
     -t msdocspythoncontainerwebapp:latest \
     <repo-path>
   

   Das letzte Argument im Befehl ist der vollqualifizierte Pfad zum Repository. Verwenden Sie https://github.com/Azure-Samples/msdocs-python-django-container-web-app.git für die Django-Beispiel-App und https://github.com/Azure-Samples/msdocs-python-flask-container-web-app.git für die Flask-Beispiel-App.

3. Bestätigen Sie, dass das Container-Image erstellt wurde mit dem Befehl az acr repository list.

   az acr repository list -n <registry-name>