Compilare e distribuire un'app Web Python con App Azure Container e PostgreSQL

Articolo
01/31/2024

Questo articolo fa parte di un'esercitazione su come inserire e distribuire un'app Web Python in App Contenitore di Azure. App contenitore consente di distribuire app in contenitori senza gestire un'infrastruttura complessa.

In questa parte dell'esercitazione si apprenderà come inserire e distribuire un'app Web di esempio Python (Django o Flask). In particolare, si compila l'immagine del contenitore nel cloud e la si distribuisce in App Azure Container. Si definiscono le variabili di ambiente che consentono all'app contenitore di connettersi a un'istanza del server flessibile Database di Azure per PostgreSQL, in cui l'app di esempio archivia i dati.

Questo diagramma dei servizi illustra i componenti illustrati in questo articolo: compilazione e distribuzione di un'immagine del contenitore.

Ottenere l'app di esempio

Creare una copia tramite fork e clonare il codice di esempio nell'ambiente di sviluppo.

Passaggio 1: Passare al repository GitHub dell'app di esempio (Django o Flask) e selezionare Fork.

Seguire la procedura per creare una copia tramite fork della directory nell'account GitHub. È anche possibile scaricare il repository di codice direttamente nel computer locale senza creare fork o un account GitHub, ma non sarà possibile configurare CI/CD descritto più avanti nell'esercitazione.

Passaggio 2. Usare il comando git clone per clonare il repository con fork nella cartella python-container :

# Django
git clone https://github.com/$USERNAME/msdocs-python-django-azure-container-apps.git python-container

# Flask
# git clone https://github.com/$USERNAME/msdocs-python-flask-azure-container-apps.git python-container

Passaggio 3. Modificare la directory.

cd python-container

Creare un'immagine del contenitore dal codice dell'app Web

Dopo aver seguito questi passaggi, si avrà un Registro Azure Container che contiene un'immagine del contenitore Docker compilata dal codice di esempio.

I comandi dell'interfaccia della riga di comando di Azure possono essere eseguiti in Azure Cloud Shell o in una workstation con l'interfaccia della riga di comando di Azure installata.

Passaggio 1: Creare un gruppo di risorse con il comando az group create.

az group create \
--name pythoncontainer-rg \
--location <location>

<location> è uno dei valori del nome della posizione di Azure dall'output del comando az account list-locations -o table.

Passaggio 2. Creare un registro contenitori con il comando az acr create .

az acr create \
--resource-group pythoncontainer-rg \
--name <registry-name> \
--sku Basic \
--admin-enabled

<il nome> del registro deve essere univoco in Azure e contenere 5-50 caratteri alfanumerici.

È possibile visualizzare le credenziali create per l'amministratore con:

az acr credential show \
--name <registry-name> \
--resource-group pythoncontainer-rg

Passaggio 3. Accedere al Registro di sistema usando il comando az acr login .

az acr login --name <registry-name>

Il comando aggiunge "azurecr.io" al nome per creare il nome completo del Registro di sistema. In caso di esito positivo, verrà visualizzato il messaggio "Login Succeeded". Se si accede al Registro di sistema da una sottoscrizione diversa da quella in cui è stato creato il Registro di sistema, usare l'opzione --suffix .

Passaggio 4. Compilare l'immagine con il comando az acr build .

az acr build \
--registry <registry-name> \
--resource-group pythoncontainer-rg \
--image pythoncontainer:latest .

Tenere presente quanto segue:

Il punto (".") alla fine del comando indica il percorso del codice sorgente da compilare. Se non si esegue questo comando nella directory radice dell'app di esempio, specificare il percorso del codice.
Se si esegue il comando in Azure Cloud Shell, usare git clone prima di tutto per eseguire il pull del repository nell'ambiente Cloud Shell e modificare la directory nella radice del progetto in modo che il punto (".") venga interpretato correttamente.
Se si esce dall'opzione -t (uguale --imagea ), il comando accoda una compilazione di contesto locale senza eseguirne il push nel Registro di sistema. La compilazione senza push può essere utile per verificare che l'immagine venga compilata.

Passaggio 5. Verificare che l'immagine del contenitore sia stata creata con il comando az acr repository list .

az acr repository list --name <registry-name>

Questi passaggi richiedono l'estensione Docker per VS Code.

Passaggio 1: Creare un Registro Azure Container.

Avviare l'attività Crea registro:

Selezionare F1 o CTRL+MAIUSC+P per aprire il riquadro comandi.
Digitare "Registro Azure Container".
Selezionare l'attività Registro Azure Container: Crea registro.

Seguire le istruzioni per creare un registro e un gruppo di risorse:

Nome del Registro di sistema → Il nome del Registro di sistema deve essere univoco in Azure e contenere 5-50 caratteri alfanumerici.
Selezionare uno SKU → Selezionare Basic.
Creare un nuovo gruppo di risorse → Selezionare questa opzione per creare un gruppo di risorse.
Gruppo di risorse → Creare un nuovo gruppo di risorse denominato pythoncontainer-rg.
Percorso → Selezionare un percorso e attendere fino a quando non viene creata la notifica che indica che il Registro di sistema è stato creato.

Passaggio 2. Compilare l'immagine.

Avviare l'attività Compila immagine in Azure:

Selezionare F1 o CTRL+MAIUSC+P per aprire il riquadro comandi.
Digitare "Registro Azure Container".
Selezionare l'attività Registro Azure Container: Crea immagine in Azure.

In alternativa, fare clic con il pulsante destro del mouse sul Dockerfile e scegliere Compila immagine in Azure. Questa azione dell'interfaccia utente avvia la stessa attività per compilare l'immagine. Se non viene visualizzata l'attività Compila immagine di Azure , verificare se si è connessi ad Azure.

Seguire le istruzioni per compilare l'immagine.

Contrassegna l'immagine come → Immettere pythoncontainer:latest.
Provider del Registro di sistema → Selezionare Azure.
Registro di sistema → Selezionare il registro Contenitori dall'elenco.
Selezionare OS → Selezionare Linux.

Se viene visualizzato un errore nella finestra Output , vedere la sezione Risoluzione dei problemi.

Passaggio 3. Verificare che il Registro di sistema sia stato creato.

Selezionare l'estensione Docker e nella sezione Registries .Select the Docker extension and to the Registries section. Espandere il nodo di Azure per trovare il nuovo Registro Azure Container.

Passaggio 4. Usare il comando az acr update per abilitare l'account utente amministratore per il Registro di sistema. È possibile eseguire il comando nella finestra del terminale di Visual Studio Code o in Azure Cloud Shell.

az acr update --name <registry-name> \
--resource-group pythoncontainer-rg \
--admin-enabled true

In alternativa, selezionare il Registro di sistema nell'estensione Docker, fare clic con il pulsante destro del mouse e selezionare Apri nel portale per abilitare l'account utente amministratore. Vedere le istruzioni int la scheda del portale di questo articolo.

È possibile visualizzare le credenziali create per l'amministratore con:

az acr credential show \
--name  <registry-name> \
--resource-group pythoncontainer-rg

Passaggio 1: Nella portale di Azure cercare "registri contenitori" e selezionare il servizio Registri contenitori nei risultati.

Passaggio 2. Selezionare + Crea per avviare il processo di creazione.

Passaggio 3. Compilare il modulo e specificare.

Gruppo di risorse → Crearne uno nuovo denominato pythoncontainer-rg.
Nome del Registro di sistema → Il nome del Registro di sistema deve essere univoco in Azure e contenere 5-50 caratteri alfanumerici.
Posizione → Selezionare una posizione.
SKU → Selezionare Standard.

Al termine, selezionare Rivedi e crea. Al termine della convalida, selezionare Crea.

Passaggio 4. Abilitare l'account utente amministratore.

Nel Registro Contenitori appena creato passare alla risorsa Chiavi di accesso.
Selezionare Abilitato per l'utente amministratore.

Passaggio 5. Selezionare l'icona di Azure Cloud Shell nella barra dei menu superiore per completare la configurazione e compilare un'immagine.

È anche possibile passare direttamente ad Azure Cloud Shell.

Passaggio 6. Usare il comando az acr build per compilare l'immagine dal repository.

az acr build --registry <registry-name> \
--resource-group pythoncontainer-rg \ 
--image pythoncontainer:latest <repo-path>

Specificare <il nome> del Registro di sistema come nome del Registro di sistema creato. Per <repository-path>, scegliere il percorso del repository Django o Flask .

Al termine del comando, passare alla risorsa Repository del Registro di sistema e verificare che l'immagine venga visualizzata.

Creare un'istanza del server flessibile PostgreSQL

L'app di esempio (Django o Flask) archivia i dati delle revisioni dei ristoranti in un database PostgreSQL. In questi passaggi viene creato il server che conterrà il database.

I comandi dell'interfaccia della riga di comando di Azure possono essere eseguiti in Azure Cloud Shell o in una workstation con l'interfaccia della riga di comando di Azure installata.

Passaggio 1: Usare il comando az postgres flexible-server create per creare il server PostgreSQL in Azure. Non è insolito che questo comando venga eseguito per alcuni minuti.

az postgres flexible-server create \
   --resource-group pythoncontainer-rg \
   --name <postgres-server-name>  \
   --location <location> \
   --admin-user <admin-username> \
   --admin-password <admin-password> \
   --sku-name Standard_D2s_v3 \
   --public-access 0.0.0.0

"pythoncontainer-rg" → Il nome del gruppo di risorse usato in questa esercitazione. Se è stato usato un nome diverso, modificare questo valore.
<postgres-server-name> → Il nome del server di database PostgreSQL. Questo nome deve essere univoco in tutto Azure. L'endpoint server è "https://< postgres-server-name.postgres.database.azure.com>". I caratteri consentiti sono "A"-"Z", "0"-"9" e "-".
<posizione> → Usare la stessa posizione usata per l'app Web. <location> è uno dei valori del nome della posizione di Azure dall'output del comando az account list-locations -o table.
<admin-username → Nome utente> per l'account amministratore. Non può essere "azure_superuser", "admin", "administrator", "root", "guest" o "public". Usare "demoadmin" per questa esercitazione.
<> password amministratore dell'utente amministratore. Deve contenere da 8 a 128 caratteri di tre delle categorie seguenti: lettere maiuscole, lettere minuscole, numeri e caratteri non alfanumerici.

Importante

Quando si creano nomi utente o password non si usa il carattere "$". Successivamente si creano variabili di ambiente con questi valori in cui il carattere "$" ha un significato speciale all'interno del contenitore Linux usato per eseguire app Python.
<sku-name> → Il nome del piano tariffario e della configurazione di calcolo, ad esempio "Standard_D2s_v3". Per altre informazioni, vedere Piano tariffario di Database di Azure per PostgreSQL. Per elencare gli SKU disponibili, usare az postgres flexible-server list-skus --location <location>.
<public-access> → usare "0.0.0.0", che consente l'accesso pubblico al server da qualsiasi servizio di Azure, ad esempio App contenitore.

Nota

Se si prevede di usare il server PostgreSQL dalla workstation locale con strumenti diversi dall'interfaccia della riga di comando di Azure, è necessario aggiungere una regola del firewall con il comando az postgres flexible-server firewall-rule create .

Questi passaggi richiedono l'estensione Database di Azure per VS Code.

Passaggio 1: Avviare l'attività di creazione di PostgreSQL.

Selezionare F1 o CTRL+MAIUSC+P per aprire il riquadro comandi.
Digitare "Database di Azure".
Selezionare l'attività Database di Azure: Crea server.

In alternativa, selezionare l'estensione di Azure , RISORSE ed espandere la sottoscrizione. Assicurarsi di visualizzare le risorse in baseRaggruppa per tipo di risorsa. Fare quindi clic con il pulsante destro del mouse su Server PostgreSQL e scegliere Crea server. Questa azione dell'interfaccia utente avvia la stessa attività di creazione del server.

Passaggio 2. Una serie di richieste illustra il processo di creazione del database. Compilare le informazioni come indicato di seguito.

Selezionare un server di database di Azure → Selezionare server flessibile PostgreSQL.
Nome server → Specificare un nome per il server. Immettere un nome per il server di database univoco in tutti gli Azure (l'URL del server di database diventa https://<server-name>.postgres.database.azure.com). I caratteri consentiti sono A-Z, 0-9 e -. Ad esempio: postgres-db-unique-id><.
Selezionare lo SKU Postgres e le opzioni → Selezionare lo SKU basic B1ms (1 vCore, 2 GiB memory, 5 GB di archiviazione).
Nome utente amministratore → Creare un nome utente amministratore. Nome per un account amministratore nel server di database. Registrare il nome e la password in quanto saranno necessari più avanti in questa esercitazione.
Password amministratore → Creare una password per l'amministratore e confermarla.
Selezionare un gruppo di risorse per le nuove risorse → Selezionare un gruppo di risorse in cui inserire il database. Usare lo stesso gruppo di risorse in cui è stato creato il servizio app.
Selezionare un percorso per le nuove risorse → Selezionare la stessa posizione del gruppo di risorse e servizio app.

Passaggio 3. Dopo aver creato il database, configurare l'accesso dall'ambiente locale al server Database di Azure per PostgreSQL.

Prima di tutto, verificare che il database sia stato creato controllando la finestra Azure: Log attività. Quando si è certi che il database esista, procedere come:

Aprire il riquadro comandi (F1 o CTRL + MAIUSC + P).
Cercare e selezionare PostgreSQL: Configura firewall. Se richiesto, selezionare una sottoscrizione.
Selezionare il database creato nel passaggio precedente. Se il nome del database non viene visualizzato nell'elenco, è probabile che non sia stato creato.
Selezionare Sì nella finestra di dialogo per aggiungere l'indirizzo IP alle regole del firewall del server PostgreSQL.

Passaggio 4. Aggiungere una regola per consentire all'app Web di accedere al server flessibile PostgreSQL.

È anche necessario configurare il firewall del server di database per accettare connessioni da tutte le risorse di Azure. Per completare questo passaggio in VS Code, aprire un'istanza di Azure Cloud Shell in VS Code oppure passare ad Azure Cloud Shell e seguire le istruzioni dell'interfaccia della riga di comando di Azure. In alternativa, usare le istruzioni portale di Azure.

Passaggio 1: In portale di Azure cercare "postgres flexible" e selezionare il servizio server flessibile Database di Azure per PostgreSQL nei risultati.

Passaggio 2. Selezionare + Crea per avviare il processo di creazione.

Passaggio 3. Compilare le impostazioni di base come indicato di seguito:

Gruppo di risorse → Il gruppo di risorse usato in questa esercitazione "pythoncontainer-rg".
Nome server → Immettere un nome per il server di database univoco in tutto Azure. L'URL del server di database diventa https://<server-name>.postgres.database.azure.com. I caratteri consentiti sono A-Z, 0-9 e -. Ad esempio: postgres-db-unique-id><.
Area → La stessa area usata per il gruppo di risorse.
Nome utente amministratore → Usare demoadmin.
Password e Conferma password → Una password che verrà usata in un secondo momento per connettere l'app contenitore a questo database.

Per tutte le altre impostazioni, lasciare le impostazioni predefinite. Al termine, selezionare Rete per passare alla pagina di rete.

Passaggio 4. Compilare le impostazioni di rete come indicato di seguito:

Metodo di connettività → Selezionare Accesso pubblico.
Consenti l'accesso pubblico da qualsiasi servizio di Azure → Selezionare la casella di controllo, ovvero consentire l'accesso.
Aggiungere l'indirizzo IP client corrente → Selezionare (aggiungi) se si prevede di accedere al database dal server locale.

Per tutte le altre impostazioni, lasciare le impostazioni predefinite. Selezionare Rivedi + crea per continuare.

Passaggio 5. Esaminare le informazioni e, in caso di soddisfazione, selezionare Crea.

Creare un database nel server

A questo punto, si dispone di un server PostgreSQL. In questa sezione viene creato un database nel server.

È possibile usare il terminale interattivo PostgreSQL psql nell'ambiente locale o in Azure Cloud Shell, accessibile anche nella portale di Azure. Quando si usa psql, è spesso più facile usare Cloud Shell perché tutte le dipendenze sono incluse nella shell.

Passaggio 1: Connettersi al database con psql.

psql --host=<postgres-server-name>.postgres.database.azure.com \
     --port=5432 \
     --username=demoadmin@<postgres-server-name> \
     --dbname=postgres

Dove <postgres-server-name> è il nome del server PostgreSQL. Il comando richiederà la password di amministratore.

In caso di problemi di connessione, riavviare il database e riprovare. Se ci si connette dall'ambiente locale, l'indirizzo IP deve essere aggiunto all'elenco delle regole del firewall per il servizio di database.

Passaggio 2. Creare il database.

postgres=> Al prompt digitare:

CREATE DATABASE restaurants_reviews;

Il punto e virgola (";") alla fine del comando è necessario. Per verificare che il database sia stato creato correttamente, usare il comando \c restaurants_reviews. Digitare \? per visualizzare la Guida o \q uscire.

È possibile usare l'interfaccia della riga di comando di Azure ovunque sia installata, inclusa Azure Cloud Shell.

Passaggio 1 Usare il comando az postgres flexible-server db create per creare un database "restaurants_reviews".

az postgres flexible-server db create \
   --resource-group pythoncontainer-rg \
   --server-name <postgres-server-name> \
   --database-name restaurants_reviews

Dove:

"pythoncontainer-rg" → Il nome del gruppo di risorse usato in questa esercitazione. Se è stato usato un nome diverso, modificare questo valore.
<postgres-server-name> → Nome del server PostgreSQL.

È anche possibile usare il comando az postgres flexible-server connect per connettersi al database e quindi usare i comandi psql . Quando si usa psql, spesso è più facile usare Azure Cloud Shell perché tutte le dipendenze sono incluse nella shell.

È anche possibile connettersi al server flessibile postgreSQL di Azure e creare un database usando Azure Data Studio o qualsiasi altro IDE che supporta PostgreSQL.

Distribuire l'app Web in App contenitore

Le app contenitore vengono distribuite in ambienti di app contenitore, che fungono da limite sicuro. Nei passaggi seguenti si crea l'ambiente, un contenitore all'interno dell'ambiente e si configura il contenitore in modo che il sito Web sia visibile esternamente.

Passaggio 1: Accedere ad Azure ed eseguire l'autenticazione, se necessario.

az login

Passaggio 2. Installare o aggiornare l'estensione per App Azure Container con il comando az extension add .

az extension add --name containerapp --upgrade

Passaggio 3. Creare un ambiente di App contenitore con il comando az containerapp env create .

az containerapp env create \
--name python-container-env \
--resource-group pythoncontainer-rg \
--location <location>

<location> è uno dei valori del nome della posizione di Azure dall'output del comando az account list-locations -o table.

Passaggio 4. Ottenere le credenziali di accesso per il Registro Azure Container.

az acr credential show -n <registry-name>

Usare il nome utente e una delle password restituite dall'output del comando.

Passaggio 5. Creare un'app contenitore nell'ambiente con il comando az containerapp create .

az containerapp create \
--name python-container-app \
--resource-group pythoncontainer-rg \
--image <registry-name>.azurecr.io/pythoncontainer:latest \
--environment python-container-env \
--ingress external \
--target-port 8000 \
--registry-server <registry-name>.azurecr.io \
--registry-username <registry-username> \
--registry-password <registry-password> \
--env-vars <env-variable-string>
--query properties.configuration.ingress.fqdn

<env-variable-string> è una stringa composta da valori separati da spazi nel formato key="value" con i valori seguenti.

AZURE_POSTGRESQL_HOST=<postgres-server-name.postgres.database.azure.com>
AZURE_POSTGRESQL_DATABASE=restaurants_reviews
AZURE_POSTGRESQL_USERNAME=demoadmin
AZURE_POSTGRESQL_PASSWORD=<db-password>
RUNNING_IN_PRODUCTION=1
AZURE_SECRET_KEY=<YOUR-SECRET-KEY>

Generare AZURE_SECRET_KEY valore usando l'output di python -c 'import secrets; print(secrets.token_hex())'.

Ecco un esempio: --env-vars AZURE_POSTGRESQL_HOST="my-postgres-server.postgres.database.azure.com" AZURE_POSTGRESQL_DATABASE="restaurants_reviews" AZURE_POSTGRESQL_USERNAME="demoadmin" AZURE_POSTGRESQL_PASSWORD="somepassword" RUNNING_IN_PRODUCTION="1" AZURE_SECRET_KEY=asdfasdfasdf.

Passaggio 7. Solo per Django, eseguire la migrazione e creare lo schema del database. Nell'app di esempio Flask viene eseguita automaticamente ed è possibile ignorare questo passaggio.

Connettersi con il comando az containerapp exec :

az containerapp exec \
--name python-container-app \
--resource-group pythoncontainer-rg

Quindi, al prompt dei comandi della shell digitare python manage.py migrate.

Non è necessario eseguire la migrazione per le revisioni del contenitore.

Passaggio 8. Testare il sito Web.

Il az containerapp create comando immesso in precedenza restituisce un URL dell'applicazione che è possibile usare per passare all'app. L'URL termina in "azurecontainerapps.io". Passare all'URL in un browser. In alternativa, è possibile usare il comando az containerapp browse .

Questi passaggi richiedono l'estensione App Azure Container per VS Code.

Passaggio 1: Creare un file con estensione env a cui si farà riferimento durante la creazione dell'app contenitore.

Nel repository di esempio è presente un file con estensione env.example da cui è possibile iniziare. Creare il file con estensione env con i valori seguenti:

AZURE_POSTGRESQL_HOST=<postgres-server-name>.postgres.database.azure.com
AZURE_POSTGRESQL_DATABASE=restaurants_reviews
AZURE_POSTGRESQL_USERNAME=demoadmin
AZURE_POSTGRESQL_PASSWORD=<db-password>
RUNNING_IN_PRODUCTION=1* 
AZURE_SECRET_KEY=<YOUR-SECRET-KEY>

Generare AZURE_SECRET_KEY valore usando l'output di python -c 'import secrets; print(secrets.token_hex())'.

Passaggio 2. Creare un ambiente app contenitore.

Avviare l'attività di creazione dell'ambiente delle app contenitore:

Selezionare F1 o CTRL+MAIUSC+P per aprire il riquadro comandi.
Digitare "apps containers".
Selezionare l'attività App Contenitore di Azure: Creare un ambiente di app contenitore

In alternativa, è possibile aprire l'estensione di Azure e selezionare + l'icona nella sezione Risorse .

Seguire le istruzioni per creare l'ambiente dell'app contenitore:

Immettere un nome di ambiente per le app contenitore → Immettere un nome.
Selezionare un percorso per le nuove risorse → Scegliere la stessa posizione creata in precedenza.

La creazione dell'ambiente richiederà alcuni istanti. Una notifica mostra lo stato di avanzamento dell'operazione. Cercare "Il nuovo ambiente app contenitore è stato creato correttamente" prima di andare al passaggio successivo. L'ambiente verrà creato in un gruppo di risorse con lo stesso nome "python-container-env".

Passaggio 3. Dopo aver creato l'ambiente, creare un'app contenitore individuando l'attività App contenitore di Azure: Crea app contenitore nel riquadro comandi. Seguire quindi le istruzioni per creare l'app contenitore:

Selezionare un ambiente di app contenitore → Selezionare l'ambiente creato nel passaggio precedente.
Immettere un nome per la nuova app contenitore → immettere python-container-app.
Selezionare un'origine immagine per l'app contenitore → Selezionare Usa immagine dal registro.
Selezionare un registro contenitori → Selezionare Registro Azure Container.
Selezionare un Registro Azure Container → Selezionare il nome del Registro di sistema creato in precedenza.
Selezionare un repository → Selezionare pythoncontainer.
Selezionare un tag → Selezionare la versione più recente.
Impostare con il file delle variabili di ambiente → Selezionare il file con estensione env creato nel passaggio 1.
Abilitare l'ingresso per le applicazioni → Selezionare Abilita.
Selezionare il traffico HTTP che l'endpoint accetterà → Selezionare esterno.
Convertire il contenitore in ascolto su → Impostare su 8000 (Django) o 5000 (Flask).

Per avviare l'attività contenitore, è anche possibile passare alla sezione Estensione Azure, App contenitore, selezionare l'ambiente, fare clic con il pulsante destro del mouse e selezionare Crea app contenitore.

Passaggio 4. Solo per Django, eseguire la migrazione e creare lo schema del database. Nell'app di esempio Flask viene eseguita automaticamente ed è possibile ignorare questo passaggio.

Passare all'estensione Azure, espandere la sezione App contenitore, trovare ed espandere l'ambiente contenitore e fare clic con il pulsante destro del mouse sull'app contenitore creata e selezionare Apri console nel portale.
Scegliere un comando di avvio e selezionare Connetti.
Al prompt della shell digitare python manage.py migrate.

Non è necessario eseguire la migrazione per le revisioni del contenitore.

Passaggio 5. Testare il sito Web.

Al termine dell'attività di creazione del contenitore, verrà visualizzata una notifica con un pulsante Sfoglia per passare al sito Web.

Se si perde la notifica, passare all'estensione azure , espandere la sezione App contenitore, trovare ed espandere l'ambiente del contenitore e fare clic con il pulsante destro del mouse sull'app contenitore e selezionare Sfoglia.

Passaggio 1: Nel portale cercare nella parte superiore della schermata cercare "app contenitore" e selezionare il servizio App contenitore nei risultati.

Passaggio 2. Selezionare + Crea per avviare il processo di creazione.

Passaggio 3. Nella pagina Informazioni di base specificare la configurazione di base dell'app contenitore.

Gruppo di risorse → Usare il gruppo creato in precedenza e contiene il Registro Azure Container.
Nome dell'app contenitore → python-container-app.
Area → Usare la stessa area/località del gruppo di risorse.
Ambiente app contenitore → Selezionare Crea nuovo per creare un nuovo ambiente denominato python-container-env.

Selezionare Avanti: Impostazioni app per continuare la configurazione.

Passaggio 4. Nella pagina Impostazioni app continuare a configurare l'app contenitore.

Usare l'immagine di avvio rapido → deselezionare la casella di controllo.
Nome → python-container-app.
Origine immagine → Selezionare Registro Azure Container.
Registro di sistema → Selezionare il nome del Registro di sistema creato in precedenza.
Nome immagine → Selezionare pythoncontainer (nome dell'immagine compilata).
Tag immagine → Selezionare la versione più recente.
Http Ingress → Selezionare la casella di controllo (abilitata).
Traffico in ingresso → Selezionare Accettazione del traffico da qualsiasi posizione.
Porta di destinazione→ Impostare su 8000 per Django o 5000 per Flask.

Selezionare Rivedi e crea per passare alla pagina di revisione. Dopo aver esaminato le impostazioni, selezionare Crea per avviare la distribuzione.

Passaggio 5. Al termine della distribuzione, selezionare Vai alla risorsa.

Passaggio 6. Creare una revisione del contenitore che contiene variabili di ambiente.

Selezionare la risorsa Contenitori del contenitore appena creato.
Selezionare quindi Modifica e distribuzione.
Nella pagina Crea e distribuisci nuova revisione selezionare il nome dell'immagine del contenitore, in questo caso python-container-app.
Nella pagina Modifica contenitore creare variabili di ambiente come illustrato di seguito e quindi selezionare Salva.
Nella pagina Crea e distribuisci nuova revisione selezionare Crea.

Ecco le variabili di ambiente seguenti da creare:

AZURE_POSTGRESQL_HOST=<postgres-server-name.postgres.database.azure.com>
AZURE_POSTGRESQL_DATABASE=restaurants_reviews
AZURE_POSTGRESQL_USERNAME=demoadmin
AZURE_POSTGRESQL_PASSWORD=<admin-password>
RUNNING_IN_PRODUCTION=1
AZURE_SECRET_KEY=<YOUR-SECRET-KEY>

Generare AZURE_SECRET_KEY valore usando l'output di python -c 'import secrets; print(secrets.token_hex())'.

Suggerimento

Anziché definire le variabili di ambiente come illustrato in precedenza, è possibile usare Service Connector. Service Connector consente di connettersi ai servizi di calcolo di Azure ad altri servizi di backup configurando le informazioni di connessione e generando e archiviando automaticamente le variabili di ambiente. Se si usa un connettore di servizio, assicurarsi di sincronizzare le variabili di ambiente nel codice di esempio con le variabili di ambiente create con Service Connector.

Passaggio 7. Solo Django, eseguire la migrazione e creare lo schema del database. Nell'app di esempio Flask viene eseguita automaticamente ed è possibile ignorare questo passaggio.

Passare alla risorsa Console di monitoraggio - dell'app contenitore.
Scegliere un comando di avvio e selezionare Connetti.
Al prompt della shell digitare python manage.py migrate.

Non è necessario eseguire la migrazione per le revisioni del contenitore.

Passaggio 8. Testare il sito Web.

Passare alla risorsa Panoramica dell'app contenitore.
In Informazioni di base selezionare URL applicazione per aprire il sito Web in un browser.

Ecco un esempio del sito Web di esempio dopo aver aggiunto un ristorante e due recensioni.

Risolvere i problemi di distribuzione

L'URL dell'applicazione è stato dimenticato per accedere al sito Web.
- Nella portale di Azure passare alla pagina Panoramica dell'app contenitore e cercare l'URL dell'applicazione.
- In VS Code passare alla visualizzazione di Azure (CTRL+MAIUSC+A) ed espandere la sottoscrizione in uso. Espandere il nodo App contenitore, quindi espandere l'ambiente gestito e fare clic con il pulsante destro del mouse su python-container-app e scegliere Sfoglia. Verrà aperto il browser con l'URL dell'applicazione.
- Nell'interfaccia della riga di comando di Azure usare il comando az containerapp show -g pythoncontainer-rg -n python-container-app --query properties.configuration.ingress.fqdn.
In VS Code l'attività Compila immagine in Azure restituisce un errore.
- Se viene visualizzato il messaggio "Errore: impossibile scaricare il contesto. Controllare se l'URL non è corretto." nella finestra Output di VS Code aggiornare il Registro di sistema nell'estensione Docker. Per aggiornare, selezionare l'estensione Docker, passare alla sezione Registries (Registri), individuare il Registro di sistema e selezionarlo.
- Se si esegue di nuovo l'attività Compila immagine in Azure , verificare se il Registro di sistema da un'esecuzione precedente esiste e, in tal caso, usarlo.
Nel portale di Azure durante la creazione di un'app contenitore viene visualizzato un errore di accesso che contiene "Impossibile accedere al Registro Azure Container '<name.azurecr.io>'".
- Questo errore si verifica quando le credenziali di amministratore nel Registro Azure Container sono disabilitate. Per controllare lo stato dell'amministratore nel portale, passare al Registro Azure Container, selezionare la risorsa Chiavi di accesso e assicurarsi che l'utente amministratore sia abilitato.
L'immagine del contenitore non viene visualizzata nella Registro Azure Container.
- Controllare l'output del comando dell'interfaccia della riga di comando di Azure o dell'output di VS Code e cercare i messaggi per confermare l'esito positivo.
- Verificare che il nome del Registro di sistema sia stato specificato correttamente nel comando di compilazione con l'interfaccia della riga di comando di Azure o nei prompt delle attività di VS Code.
- Assicurarsi che le credenziali non siano scadute. Ad esempio, in VS Code trovare il Registro di sistema di destinazione nell'estensione Docker e aggiornare. Nell'interfaccia della riga di comando di Azure eseguire az login.
Il sito Web restituisce "Richiesta non valida (400)".
- Controllare le variabili di ambiente PostgreSQL passate al contenitore. L'errore 400 indica spesso che il codice Python non è in grado di connettersi all'istanza di PostgreSQL.
- Il codice di esempio usato in questa esercitazione verifica l'esistenza della variabile RUNNING_IN_PRODUCTIONdi ambiente contenitore , che può essere impostata su qualsiasi valore come "1".
Il sito Web restituisce "Not Found (404)".
- Controllare l'URL dell'applicazione nella pagina Panoramica per il contenitore. Se l'URL dell'applicazione contiene la parola "internal", l'ingresso non viene impostato correttamente.
- Controllare l'ingresso del contenitore. Ad esempio, in portale di Azure passare alla risorsa Ingress del contenitore e assicurarsi che l'opzione Ingresso HTTP sia abilitata e Accettazione del traffico da qualsiasi posizione sia selezionata.
Il sito Web non viene avviato, viene visualizzato il "timeout del flusso" o non viene restituito nulla.
- Controllare i log.
  - Nel portale di Azure passare alla risorsa di gestione delle revisioni dell'app contenitore e controllare lo stato del provisioning del contenitore.
    - Se "Provisioning", attendere il completamento del provisioning.
    - Se "Failed", selezionare la revisione e visualizzare i log della console. Scegliere l'ordine delle colonne per visualizzare "Time Generated", "Stream_s" e "Log_s". Ordinare i log in base alla prima più recente e cercare i messaggi stderr e stdout Python nella colonna "Stream_s". L'output di Python 'print' sarà stdout messages.
  - Con l'interfaccia della riga di comando di Azure usare il comando az containerapp logs show .
- Se si usa il framework Django, verificare se le tabelle restaurants_reviews sono presenti nel database. In caso contrario, usare una console per accedere al contenitore ed eseguire python manage.py migrate.

Passaggio successivo

Configurare la distribuzione continua

Condividi tramite

Compilare e distribuire un'app Web Python con App Azure Container e PostgreSQL

Ottenere l'app di esempio

Creare un'immagine del contenitore dal codice dell'app Web

Creare un'istanza del server flessibile PostgreSQL

Creare un database nel server

Distribuire l'app Web in App contenitore

Risolvere i problemi di distribuzione

Passaggio successivo

Commenti e suggerimenti

Risorse aggiuntive