Een in een container geplaatste Python-web-app bouwen in de cloud

Dit artikel maakt deel uit van een zelfstudie over het in een container zetten en implementeren van een Python-web-app in Azure App Service. Met App Service kunt u in containers geplaatste web-apps uitvoeren en implementeren via mogelijkheden voor continue integratie/continue implementatie (CI/CD) met Docker Hub, Azure Container Registry en Visual Studio Team Services. In dit deel van de zelfstudie leert u hoe u de in een container geplaatste Python-web-app in de cloud bouwt.

Het vorige optionele deel van deze zelfstudie bevatte het bouwen en lokaal uitvoeren van een containerafbeelding. In dit deel van de zelfstudie bouwt u daarentegen een Python-web-app tot een Docker-image rechtstreeks in Azure Container Registry. Het bouwen van de installatiekopieën in Azure is doorgaans sneller en eenvoudiger dan lokaal bouwen en vervolgens de installatiekopieën naar een register pushen. Voor het bouwen in de cloud hoeft Docker ook niet in uw ontwikkelomgeving te worden uitgevoerd.

Zodra de Docker-installatiekopie zich in Azure Container Registry bevindt, kan deze worden geïmplementeerd in Azure App Service.

Dit servicediagram markeert de onderdelen die in dit artikel worden behandeld.

Een Azure Container Registry maken

Als u al een Azure Container Registry hebt die u kunt gebruiken, gaat u naar de volgende stap. Als u dat niet doet, maakt u er een.

Azure CLI

Azure CLI-opdrachten kunnen worden uitgevoerd in de Azure Cloud Shell- of op een werkstation waarop de Azure CLI is geïnstalleerd. Sla stap 3over wanneer u in Cloud Shell werkt.

1. Maak indien dit nodig is een resourcegroep met de opdracht az group create. Als u al een Azure Cosmos DB voor MongoDB-account hebt ingesteld in deel 2. Bouw en test de container lokaal van deze zelfstudie, stel de omgevingsvariabele RESOURCE_GROUP_NAME in op de naam van de resourcegroep die u voor dat account hebt gebruikt en ga verder met de volgende stap.

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

   LOCATION moet een Azure-locatiewaarde zijn. Kies een locatie bij u in de buurt. U kunt Azure-locatiewaarden weergeven met de volgende opdracht: az account list-locations -o table.

2. Maak een containerregister met de opdracht az acr create.

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

   REGISTRY_NAME moet uniek zijn binnen Azure en 5-50 alfanumerieke tekens bevatten.

   Zoek in de JSON-uitvoer van de opdracht naar de loginServer waarde. Dit is de volledig gekwalificeerde registernaam (alle kleine letters) en die de registernaam moet bevatten die u hebt opgegeven.

3. Als u de Azure CLI lokaal uitvoert, meldt u zich aan bij het register met behulp van de opdracht az acr login.

   az acr login -n $REGISTRY_NAME
   

   Met de opdracht wordt 'azurecr.io' toegevoegd aan de naam om de volledig gekwalificeerde registernaam te maken. Als dit lukt, ziet u het bericht 'Aanmelden voltooid'.

   Notitie

   De opdracht az acr login is niet nodig of wordt niet ondersteund in Cloud Shell.

VS Code

Voor deze stappen is de Docker-extensie voor VS Code vereist.

1. Selecteer F1 of Ctrl+Shift+P om het opdrachtenpalet te openen. Typ vervolgens 'registerbeheer' en selecteer de Azure Container Registry: Register maken taak.

   U kunt ook in de sectie Docker-extensie registers met de rechtermuisknop op uw abonnement klikken en Register-maken selecteren. Deze UI-actie start dezelfde registry-taak.

2. Volg de aanwijzingen en voer de volgende waarden in:

   • registernaam: de registernaam moet uniek zijn binnen Azure en moet 5-50 alfanumerieke tekens bevatten.

   • SKU-: Selecteer Standard-.

   • Resourcegroep: Gebruik een bestaande groep of maak een nieuwe aan.

   • Locatie: als u een bestaande resourcegroep gebruikt, selecteert u de locatie die u wilt vergelijken. Anders is de locatie waar de resourcegroep die het register bevat wordt gemaakt.

   

3. Zoek in de Docker-extensie in de sectie REGISTERS het register dat u hebt gemaakt, klik met de rechtermuisknop en selecteer Eigenschappen weergeven.

   Zoek naar het loginServer sleutelwaardepaar in de uitvoer. De waarde is de volledig gekwalificeerde naam van het register.

   

Azure Portal

Meld u aan bij de Azure-portal en volg deze stappen om een Azure Container Registry te maken.

1. Zoek naar 'containerregister' en selecteer Container Registry- onder Marketplace- in de resultaten.

2. Voer op het tabblad Basisbeginselen in het formulier Container register maken de volgende waarden in:

   • Resourcegroep: gebruik een bestaande groep of maak een nieuwe.
   • registernaam: de registernaam moet uniek zijn binnen Azure en moet 5-50 alfanumerieke tekens bevatten.
   • Locatie: als u een bestaande resourcegroep gebruikt, selecteert u de locatie die u wilt vergelijken. In andere gevallen is de locatie waar de resourcegroep wordt gemaakt die het register bevat.
   • SKU-: Selecteer Standard-.

   

   Wanneer u klaar bent, selecteert u Beoordelen enmaken. Nadat de validatie is voltooid, selecteert u en kies "Maken".

3. Nadat de implementatie is voltooid, gaat u naar het nieuwe register en zoekt u de volledig gekwalificeerde naam.

   1. Selecteer in het servicemenu, Overzicht.
   2. Kopieer de aanmeldingsserver waarde. Dit moet een volledig gekwalificeerde naam zijn met 'azurecr.io'.

   

4. Het beheerdersaccount is verplicht om een containerafbeelding van een register naar Azure Web Apps for Containers te implementeren.

   1. Selecteer toegangssleutelsin het servicemenu.
   2. Selecteer Ingeschakeld voor de Beheerder.

   

   Het beheerdersaccount van register is nodig wanneer u de Azure Portal gebruikt om een containerafbeelding te implementeren, zoals in deze handleiding wordt weergegeven. Het beheerdersaccount wordt alleen gebruikt tijdens het maken van de App Service. Nadat de App Service is gemaakt, wordt de beheerde identiteit gebruikt om afbeeldingen uit het register op te halen en kan het beheerdersaccount worden uitgeschakeld.

Een image maken in Azure Container Registry

U kunt containerimages op verschillende manieren rechtstreeks in Azure bouwen. Eerst kunt u de Azure Cloud Shell gebruiken, waarmee de installatiekopieën worden gebouwd zonder dat u uw lokale omgeving hoeft te gebruiken. U kunt ook de containerinstallatiekopieën in Azure bouwen vanuit uw lokale omgeving met behulp van VS Code of de Azure CLI. Voor het bouwen van het image in de cloud hoeft Docker niet op uw lokale omgeving te draaien. Als dat nodig is, kunt u de instructies volgen in Kloon of de voorbeeld-app downloaden in deel 2 van deze zelfstudie om de voorbeeld-Flask- of Django-web-app op te halen.

Azure CLI

Azure CLI-opdrachten kunnen worden uitgevoerd op een werkstation waarop de Azure CLI is geïnstalleerd of in Azure Cloud Shell-. Als u in Cloud Shell werkt, slaat u stap 1over.

1. Als u de Azure CLI lokaal uitvoert, meldt u zich aan bij het register als u dit nog niet hebt gedaan met de opdracht az acr login.

   az acr login -n $REGISTRY_NAME
   

   Als u het register opent vanuit een ander abonnement dan het abonnement waarin het register is gemaakt, gebruikt u de --suffix-switch.

   Notitie

   De opdracht az acr login is niet nodig en wordt niet ondersteund in Cloud Shell.

2. Bouw de image met de opdracht az acr build.

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

   In deze opdracht:

   • De punt (".") aan het einde van de opdracht geeft de locatie aan van de broncode die moet worden gebouwd. Als u deze opdracht niet uitvoert in de hoofdmap van de voorbeeld-app, geeft u het pad naar de code op.

     In plaats van een pad naar de code in uw omgeving kunt u desgewenst een pad opgeven naar de GitHub-voorbeeldopslagplaats: https://github.com/Azure-Samples/msdocs-python-django-container-web-app of https://github.com/Azure-Samples/msdocs-python-flask-container-web-app.

   • Als u de optie -t (hetzelfde als --image) weglaat, plaatst de opdracht een lokale context build in de wachtrij zonder deze naar het register te pushen. Bouwen zonder pushen kan handig zijn om te controleren of de afbeeldingen worden aangemaakt.

3. Controleer of de containerafbeelding is gemaakt met de opdracht az acr repository list.

   az acr repository list -n $REGISTRY_NAME
   

VS Code

Voor deze stappen is de Docker-extensie voor VS Code vereist. VS Code moet worden geopend in de werkmap van uw web-app.

1. Ga in de Docker-extensie naar registers en maak verbinding met Azure.

   

2. Selecteer F1 of Ctrl+Shift+P om het opdrachtenpalet te openen, typ 'register' en selecteer de Azure Container Registry: Build Image in Azure taak.

   Als u de taak niet ziet, controleert u of Azure wordt weergegeven onder registers in de Docker-extensie. U kunt ook met de rechtermuisknop op de Dockerfile klikken en afbeelding bouwen in Azure selecteren om de taak uit te voeren.

3. Volg de aanwijzingen en voer de volgende waarden in om de afbeelding te maken.

   • Tag image: Gebruik de afbeeldingsnaam "msdocspythoncontainerwebapp:latest".
   • Register: selecteer het register dat u hierboven hebt gemaakt of een register waarvoor u toegang hebt.
   • basisafbeelding van het besturingssysteem: Selecteer Linux.

   

   Controleer het venster OUTPUT op voortgang en informatie over de build. Als u een fout met inloggegevens krijgt, klikt u met de rechtermuisknop op het register in de sectie registers van de Docker-extensie en selecteert u Vernieuwen.

4. Bevestig de image in de Azure Container Registry.

   1. Zoek in de Docker-extensie, in de sectie registries, de gemaakte containerafbeelding.

   2. Bevestig de naam en tag 'latest'.

   

Azure Portal

Meld u aan bij de Azure Portal om deze stappen uit te voeren.

1. Open Azure Cloud Shell-.

   

2. Bouw de image met de opdracht az acr build.

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

   Het laatste argument in de opdracht is het volledig gekwalificeerde pad naar de repository. Gebruik https://github.com/Azure-Samples/msdocs-python-django-container-web-app.git voor de Django-voorbeeld-app en https://github.com/Azure-Samples/msdocs-python-flask-container-web-app.git voor de Flask-voorbeeld-app.

3. Controleer of de container-image is gemaakt met de opdracht az acr repository list.

   az acr repository list -n <registry-name>
   

Volgende stap

Web-app implementeren