Implementación de una aplicación web Python (Django o Flask) con PostgreSQL en Azure

En este tutorial, implementará una aplicación web de Python controlada por datos (Django o Flask) en Azure App Service con el servicio de base de datos relacional Azure Database for PostgreSQL. Azure App Service admite Python en un entorno de servidor Linux.

Para completar este tutorial, necesita:

• Una cuenta de Azure con una suscripción activa. Si no tiene una cuenta de Azure, puede crearla gratis.
• Conocimientos de Python con desarrollo de Flask o Python con desarrollo de Django

• Una cuenta de Azure con una suscripción activa. Si no tiene una cuenta de Azure, puede crearla gratis.
• Azure Developer CLI instalado. Puede seguir los pasos con Azure Cloud Shell porque ya tiene instalado Azure Developer CLI.
• Conocimientos de Python con desarrollo de Flask o Python con desarrollo de Django

Ir al final

Flask

Con Azure Developer CLI instalado, puede implementar una aplicación de ejemplo totalmente configurada, que se muestra en este tutorial, y verla en ejecución en Azure. Solo tiene que ejecutar los siguientes comandos en un directorio de trabajo vacío:

azd auth login
azd init --template msdocs-flask-postgresql-sample-app
azd up

Django

Con Azure Developer CLI instalado, puede ir directamente al final del tutorial ejecutando los siguientes comandos en un directorio de trabajo vacío:

azd auth login
azd init --template msdocs-django-postgresql-sample-app
azd up

Aplicación de ejemplo

Se proporcionan aplicaciones de Python de ejemplo que usan el marco Flask y Django para ayudarle a seguir este tutorial. Para implementarlas sin ejecutarlas localmente, omita esta parte.

Para ejecutar la aplicación localmente, asegúrese de que tiene Python 3.7 o posterior y PostgreSQL instalados localmente. A continuación, clone la rama starter-no-infra del repositorio de ejemplo y cambie a la raíz del repositorio.

Flask

git clone -b starter-no-infra https://github.com/Azure-Samples/msdocs-flask-postgresql-sample-app
cd msdocs-flask-postgresql-sample-app

Cree un archivo .env como se ve a continuación, con el archivo .env.sample como guía. Establezca el valor de DBNAME en el nombre de una base de datos existente en la instancia de PostgreSQL local. Establezca los valores de DBHOST, DBUSER y DBPASS según corresponda para la instancia de PostgreSQL local.

DBNAME=<database name>
DBHOST=<database-hostname>
DBUSER=<db-user-name>
DBPASS=<db-password>

Django

git clone -b starter-no-infra https://github.com/Azure-Samples/msdocs-django-postgresql-sample-app
cd msdocs-django-postgresql-sample-app

Cree un archivo .env como se ve a continuación, con el archivo .env.sample como guía. Establezca el valor de DBNAME en el nombre de una base de datos existente en la instancia de PostgreSQL local. Establezca los valores de DBHOST, DBUSER y DBPASS según corresponda para la instancia de PostgreSQL local.

DBNAME=<database name>
DBHOST=<database-hostname>
DBUSER=<db-user-name>
DBPASS=<db-password>

Cree un valor de SECRET_KEY para la aplicación mediante la ejecución del siguiente comando en un símbolo del sistema del terminal: python -c 'import secrets; print(secrets.token_hex())'.

Establezca el valor devuelto como el valor de SECRET_KEY en el archivo .env.

SECRET_KEY=<secret-key>

Cree un entorno virtual para la aplicación:

Windows

py -m venv .venv
.venv\scripts\activate

macOS y Linux

python3 -m venv .venv
source .venv/bin/activate

Instale las dependencias:

pip install -r requirements.txt

Ejecute la aplicación de ejemplo con los comandos siguientes:

Flask

# Run database migration
flask db upgrade
# Run the app at http://127.0.0.1:5000
flask run

Django

# Run database migration
python manage.py migrate
# Run the app at http://127.0.0.1:8000
python manage.py runserver

1. Creación de una instancia de App Service y PostgreSQL

En este paso, creará los recursos de Azure. Los pasos que se usan en este tutorial crean un conjunto de recursos seguros de forma predeterminada que incluyen App Service y Azure Database for PostgreSQL. En el proceso de creación especificará lo siguiente:

• El Nombre de la aplicación web. Es el nombre que se usa como parte del nombre DNS de la aplicación web en el formato https://<app-name>.azurewebsites.net.
• La región para ejecutar la aplicación físicamente en el mundo.
• La pila en tiempo de ejecución para la aplicación. Es donde se selecciona la versión de Python que se va a usar para la aplicación.
• El plan de hospedaje para la aplicación. Es el plan de tarifa que incluye el conjunto de características y la capacidad de escalado de la aplicación.
• El Grupo de recursos de la aplicación. Un grupo de recursos permite agrupar (en un contenedor lógico) todos los recursos de Azure necesarios para la aplicación.

Inicie sesión en Azure Portal y siga estos pasos para crear los recursos de Azure App Service.

Flask

Paso 1: En el portal Azure:

1. Escriba "base de datos de aplicación web" en la barra de búsqueda de la parte superior de Azure Portal.
2. Seleccione el elemento denominado Aplicación web + base de datos en el encabezado Marketplace. También puede ir directamente al asistente de creación.

Paso 2: In the páginaCrear aplicación web + base de datos, rellene el formulario de la siguiente manera.

1. Grupo de recursos → seleccione Crear nuevo y use el nombre msdocs-python-postgres-tutorial.
2. Región → Cualquier región de Azure cercana.
3. Nombre → msdocs-python-postgres-XYZ, donde XYZ son tres caracteres aleatorios. Este nombre debe ser único en Azure.
4. Pila en tiempo de ejecución → Python 3.10.
5. Base de datos → PostgreSQL: servidor flexible está seleccionado de manera predeterminada como motor de base de datos. El nombre del servidor y el nombre de la base de datos también se establecen de manera predeterminada en los valores adecuados.
6. Plan de hospedaje → Básico. Cuando esté listo, puede escalar verticalmente a un plan de tarifa de producción más adelante.
7. Seleccione Revisar + crear.
8. Una vez completada la validación, seleccione Crear.

Step 3:La implementación tarda unos minutos en completarse. Una vez completada la implementación, seleccione el botón Ir al recurso. Se le dirigirá directamente a la aplicación App Service, pero se crean los siguientes recursos:

• Grupo de recursos → Contenedor de todos los recursos creados.
• Plan de App Service → Define los recursos de proceso de App Service. Se crea un plan de Linux en el nivel Básico.
• App Service → Representa su aplicación y se ejecuta en el plan de App Service.
• Red virtual → Se integra con la aplicación App Service y aísla el tráfico de red de back-end.
• Servidor flexible de Azure Database for PostgreSQL → Accesible solo desde la red virtual. Una base de datos y un usuario se crean automáticamente en el servidor.
• Zona DNS privada → Habilita la resolución DNS del servidor de PostgreSQL en la red virtual.

Django

Paso 1: En el portal Azure:

1. Escriba "base de datos de aplicación web" en la barra de búsqueda de la parte superior de Azure Portal.
2. Seleccione el elemento denominado Aplicación web + base de datos en el encabezado Marketplace. También puede ir directamente al asistente de creación.

Paso 2: In the páginaCrear aplicación web + base de datos, rellene el formulario de la siguiente manera.

1. Grupo de recursos → seleccione Crear nuevo y use el nombre msdocs-python-postgres-tutorial.
2. Región → Cualquier región de Azure cercana.
3. Nombre → msdocs-python-postgres-XYZ, donde XYZ son tres caracteres aleatorios. Este nombre debe ser único en Azure.
4. Pila en tiempo de ejecución → Python 3.12.
5. Base de datos → PostgreSQL: servidor flexible está seleccionado de manera predeterminada como motor de base de datos. El nombre del servidor y el nombre de la base de datos también se establecen de manera predeterminada en los valores adecuados.
6. Agregar Azure Cache for Redis? → Sí.
7. Plan de hospedaje → Básico. Cuando esté listo, puede escalar verticalmente a un plan de tarifa de producción más adelante.
8. Seleccione Revisar + crear.
9. Una vez completada la validación, seleccione Crear.

Step 3:La implementación tarda unos minutos en completarse. Una vez completada la implementación, seleccione el botón Ir al recurso. Se le dirigirá directamente a la aplicación App Service, pero se crean los siguientes recursos:

• Grupo de recursos → Contenedor de todos los recursos creados.
• Plan de App Service → Define los recursos de proceso de App Service. Se crea un plan de Linux en el nivel Básico.
• App Service → Representa su aplicación y se ejecuta en el plan de App Service.
• Red virtual → Se integra con la aplicación App Service y aísla el tráfico de red de back-end.
• Servidor flexible de Azure Database for PostgreSQL → Accesible solo desde la red virtual. Una base de datos y un usuario se crean automáticamente en el servidor.
• Azure Cache for Redis → Accesible solo desde la red virtual.
• Zona DNS privada → Habilita la resolución DNS del servidor de PostgreSQL y el servidor de Redis en la red virtual.

2. Protección de secretos de conexión

El asistente para la creación ha generado la cadena de conectividad de forma automática como configuración de la aplicación. Sin embargo, el procedimiento recomendado de seguridad es mantener completamente los secretos fuera de App Service. Los secretos se mueven a un almacén de claves y se cambia la configuración de la aplicación a una referencia de Key Vault con la ayuda de los conectores de servicios.

Paso 1: Recuperación de la cadena de conexión existente

1. En el menú de la izquierda de la página App Service, seleccione Configuración > Variables de entorno.
2. Seleccione AZURE_POSTGRESQL_CONNECTIONSTRING.
3. En Agregar o editar configuración de aplicación, en el campo Valor, busque la parte password= al final de la cadena.
4. Copie la cadena de contraseña después de Password= para usarla más adelante. Esta configuración de aplicación le permite conectarse a la base de datos Postgres protegida tras un punto de conexión privado. Sin embargo, el secreto se guarda directamente en la aplicación de App Service, que no es lo mejor. Cambiará esto.

Paso 2: Creación de un almacén de claves para la administración segura de secretos

1. En la barra de búsqueda superior, escriba "almacén de claves" y, a continuación, seleccione Marketplace>Key Vault.
2. En Grupo de recursos, seleccione msdocs-python-postgres-tutorial.
3. En Nombre del almacén de claves, escriba un nombre que consta de solo letras y números.
4. En Región, establézcalo en la misma ubicación que el grupo de recursos.

Paso 3: Protección del almacén de claves con un punto de conexión privado

1. Seleccione la pestaña Redes.
2. Anule la selección de Habilitar acceso público.
3. Seleccione Crear un punto de conexión privado.
4. En Grupo de recursos, seleccione msdocs-python-postgres-tutorial.
5. En Nombre, escriba un nombre para el punto de conexión privado que conste de solo letras y números.
6. En Región, establézcalo en la misma ubicación que el grupo de recursos.
7. En el cuadro de diálogo, en Ubicación, seleccione la misma ubicación que la aplicación de App Service.
8. En Grupo de recursos, seleccione msdocs-python-postgres-tutorial.
9. En Nombre, escriba msdocs-python-postgres-XYZVaultEndpoint.
10. En Red virtual, seleccione msdocs-python-postgres-XYZVnet.
11. En Subred, msdocs-python-postgres-XYZSubnet.
12. Seleccione Aceptar.
13. Seleccione Revisar y crear y, luego, Crear. Espere a que finalice la implementación del almacén de claves. Debería ver "La implementación está completa".

Paso 4: Configuración del conector de servicio

1. En la barra de búsqueda superior, escriba msdocs-python-postgres y, a continuación, seleccione el recurso de App Service denominado msdocs-python-postgres-XYZ.
2. En la página App Service, en el menú de la izquierda, seleccione Configuración > Conector de servicio. Ya hay un conector, que el asistente para la creación de aplicaciones ha creado automáticamente.
3. Active la casilla situada junto al conector y seleccione Editar.
4. En la pestaña Aspectos básicos, en Base de datos PostgreSQL seleccione la base de datos PostgreSQL que se creó.
5. Seleccione la pestaña Autenticación.
6. En Contraseña, pegue la contraseña que copió anteriormente.
7. Seleccione Almacenar secreto en Key Vault.
8. En Conexión de Key Vault, seleccione Crear nuevo. Se abre un cuadro de diálogo Crear conexión encima del cuadro de diálogo de edición.

Paso 5: Establecimiento de la conexión de Key Vault

1. En el cuadro de diálogo Crear conexión para la conexión de Key Vault, en Key Vault, seleccione el almacén de claves que ha creado antes.
2. Seleccione Revisar + crear.
3. Cuando se complete la validación, seleccione Crear.

Paso 6: Finalización de la configuración del conector de servicio

1. Vuelve al cuadro de diálogo de edición de defaultConnector. En la pestaña Autenticación, espere a que se cree el conector del almacén de claves. Cuando haya terminado, la lista desplegable Conexión de Key Vault la selecciona automáticamente.
2. Seleccione Siguiente: Redes.
3. Seleccione Guardar. Espere hasta que aparezca la Actualización correcta notificación.

Paso 7: Comprobación de la integración de Key Vault

1. En el menú de la izquierda, vuelva a seleccionar Configuración > Variables de entorno.
2. Junto a AZURE_POSTGRESQL_CONNECTIONSTRING, seleccione Mostrar valor. El valor debe ser @Microsoft.KeyVault(...), lo que significa que es un referencia del almacén de claves porque el secreto ahora se administra en el almacén de claves.

En resumen, el proceso ha implicado recuperar la cadena de conexión de PostgreSQL de las variables de entorno de App Service, crear una instancia de Azure Key Vault para proteger la administración de secretos con acceso privado y actualizar el conector de servicio para almacenar la contraseña en el almacén de claves. Se ha establecido una conexión segura entre la aplicación de App Service y el almacén de claves mediante una identidad administrada asignada por el sistema y la configuración se ha comprobado mediante la confirmación de que la cadena de conexión usa una referencia de Key Vault.

¿Tiene problemas? Consulte la sección Solución de problemas.

---

3. Implementación del código de ejemplo

En este paso, configurará la implementación de GitHub mediante Acciones de GitHub. Es solo una de las muchas maneras de implementar en App Service, pero también una excelente manera de disponer de integración continua en el proceso de implementación. De forma predeterminada, cada uno de los repositorios git push de GitHub iniciará la acción de compilación e implementación.

Flask

Paso 1: En una nueva ventana del navegador:

1. Inicie sesión en su cuenta de GitHub.
2. Vaya a https://github.com/Azure-Samples/msdocs-flask-postgresql-sample-app.
3. Seleccione Bifurcación.
4. Seleccione Crear bifurcación.

Paso 2: En la página de GitHub, abre Visual Studio Code en el navegador pulsando la tecla ..

Paso 3: en el explorador de Visual Studio Code, abra azureproject/production.py. Consulte las variables de entorno que se usan en el entorno de producción, incluida la configuración de la aplicación que vio en la página de configuración.

Paso 4: De nuevo en la página App Service, en el menú de la izquierda, seleccione Centro de implementación.

Paso 5: En la página Centro de implementación:

1. En Origen, seleccione GitHub. De forma predeterminada, Acciones de GitHub está seleccionado como proveedor de compilación.
2. Inicie sesión en su cuenta de GitHub y siga las indicaciones para autorizar a Azure.
3. En Organización, seleccione su cuenta.
4. En Repositorio, seleccione msdocs-flask-postgresql-sample-app.
5. En Rama, seleccione main.
6. Mantenga la opción predeterminada seleccionada para Agregar un flujo de trabajo.
7. En Tipo de autenticación, seleccione Identidad asignada por el usuario.
8. En el menú superior, elija Guardar. App Service confirma un archivo de flujo de trabajo en el repositorio de GitHub escogido, en el directorio .github/workflows.

Paso 6: En la página Centro de implementación:

1. Seleccione Registros. Ya hay iniciada una ejecución de implementación.
2. En el elemento de registro de la ejecución de implementación, seleccione Compilar o implementar registros.

Paso 7: Se le llevará al repositorio de GitHub, donde ve que la acción de GitHub se está ejecutando. El archivo de flujo de trabajo define dos fases independientes: compilación e implementación. Espere a que la ejecución de GitHub muestre el estado Completado. Tardará unos 5 minutos.

Django

Paso 1: En una nueva ventana del navegador:

1. Inicie sesión en su cuenta de GitHub.
2. Vaya a https://github.com/Azure-Samples/msdocs-django-postgresql-sample-app.
3. Seleccione Bifurcación.
4. Seleccione Crear bifurcación.

Paso 2: En la página de GitHub, abre Visual Studio Code en el navegador pulsando la tecla ..

Paso 3: en el explorador de Visual Studio Code, abra azureproject/production.py. Consulte las variables de entorno que se usan en el entorno de producción, incluida la configuración de la aplicación que vio en la página de configuración.

Paso 4: De nuevo en la página App Service, en el menú de la izquierda, seleccione Centro de implementación.

Paso 5: En la página Centro de implementación:

1. En Origen, seleccione GitHub. De forma predeterminada, Acciones de GitHub está seleccionado como proveedor de compilación.
2. Inicie sesión en su cuenta de GitHub y siga las indicaciones para autorizar a Azure.
3. En Organización, seleccione su cuenta.
4. En Repositorio, seleccione msdocs-django-postgresql-sample-app.
5. En Rama, seleccione main.
6. En el menú superior, elija Guardar. App Service confirma un archivo de flujo de trabajo en el repositorio de GitHub escogido, en el directorio .github/workflows.

Paso 6: En la página Centro de implementación:

1. Seleccione Registros. Ya hay iniciada una ejecución de implementación.
2. En el elemento de registro de la ejecución de implementación, seleccione Compilar o implementar registros.

Paso 7: Se le llevará al repositorio de GitHub, donde ve que la acción de GitHub se está ejecutando. El archivo de flujo de trabajo define dos fases independientes: compilación e implementación. Espere a que la ejecución de GitHub muestre el estado Completado. Tardará unos 5 minutos.

¿Tiene problemas? Consulte la Guía de solución de problemas.

4. Generación del esquema de la base de datos

Flask

Con la base de datos PostgreSQL protegida por la red virtual, la manera más fácil de ejecutar migraciones de base de datos de Flask es mediante una sesión SSH con el contenedor de App Service.

Paso 1: De vuelta en la página App Service, en el menú de la izquierda,

1. Seleccione SSH.
2. Seleccione Ir.

Paso 2: en el terminal SSH, ejecute flask db upgrade. Si se realiza correctamente, App Service se conecta a la base de datos. Cuando la aplicación se reinicie, solo persisten los cambios realizados en los archivos ubicados en /home. Los cambios efectuados fuera de /home no se conservan.

Django

Con la base de datos PostgreSQL protegida por la red virtual, la manera más fácil de ejecutar migraciones de base de datos de Django es mediante una sesión SSH con el contenedor de App Service.

Paso 1: De vuelta en la página App Service, en el menú de la izquierda,

1. Seleccione SSH.
2. Seleccione Ir.

Paso 2: en el terminal SSH, ejecute python manage.py migrate. Si se realiza correctamente, App Service se conecta a la base de datos. Cuando la aplicación se reinicie, solo persisten los cambios realizados en los archivos ubicados en /home. Los cambios efectuados fuera de /home no se conservan.

Sugerencia

En una sesión SSH, para Django puede crear usuarios con el comando python manage.py createsuperuser como lo haría con una aplicación típica de Django. Para obtener más información, consulte la documentación de django django-admin y manage.py. Use la cuenta de superusuario para acceder a la parte /admin del sitio web. Para Flask, use una extensión como Flask-admin para proporcionar la misma funcionalidad.

5. Navegación hasta la aplicación

Flask

Paso 1. En la página App Service:

1. En el menú de la izquierda, seleccione Información general.
2. Seleccione la dirección URL de la aplicación. También puede navegar directamente a https://<app-name>.azurewebsites.net.

Paso 2: agregue algunos restaurantes a la lista. Enhorabuena, ya está ejecutando una aplicación web en Azure App Service, con conectividad protegida a Azure Database for PostgreSQL.

Django

Paso 1. En la página App Service:

1. En el menú de la izquierda, seleccione Información general.
2. Seleccione la dirección URL de la aplicación. También puede navegar directamente a https://<app-name>.azurewebsites.net.

Paso 2: agregue algunos restaurantes a la lista. Enhorabuena, ya está ejecutando una aplicación web en Azure App Service, con conectividad protegida a Azure Database for PostgreSQL.

La página principal muestra que el nombre del último restaurante visitado y los datos se guardan en la memoria caché de Azure y se recuperan desde ella. Recuerde que la aplicación de ejemplo usa la cadena de conexión AZURE_REDIS_CONNECTIONSTRING, que el asistente creó automáticamente.

6. Transmisión de registros de diagnóstico

Azure App Service captura toda la salida de mensajes hacia la consola, para ayudarle a diagnosticar problemas de la aplicación. La aplicación de ejemplo incluye instrucciones print() para demostrar esta funcionalidad, como se muestra a continuación.

Flask

@app.route('/', methods=['GET'])
def index():
    print('Request for index page received')
    restaurants = Restaurant.query.all()
    return render_template('index.html', restaurants=restaurants)

Django

def index(request):
    print('Request for index page received')
    restaurants = Restaurant.objects.annotate(avg_rating=Avg('review__rating')).annotate(review_count=Count('review'))
    lastViewedRestaurant = request.session.get("lastViewedRestaurant", False)

Paso 1. En la página App Service:

1. En el menú de la izquierda, seleccione Registros de App Service.
2. En Registro de aplicaciones, seleccione Sistema de archivos.
3. En el menú superior, elija Guardar.

Paso 2: En el menú de la izquierda, seleccione Flujo de registro. Verá los registros de la aplicación, incluidos los registros de plataforma y los registros de dentro del contenedor.

Obtenga más información sobre cómo iniciar sesión en aplicaciones de Python en la serie sobre cómo configurar Azure Monitor para la aplicación Python.

7. Limpieza de recursos

Cuando acabe, puede eliminar todos los recursos de la suscripción de Azure mediante la eliminación del grupo de recursos.

Paso 1:En la barra de búsqueda de la parte superior de Azure Portal:

1. Escriba el nombre del grupo de recursos.
2. Seleccione el grupo de recursos.

Paso 2: En la página del grupo de recursos, seleccione Borrar grupo de recursos.

Paso 3:

1. Escriba el nombre del grupo de recursos para confirmar la eliminación.
2. Seleccione Eliminar.

:

1. Creación de recursos de Azure e implementación de una aplicación de ejemplo

En este paso, creará los recursos de Azure e implementará una aplicación de ejemplo en App Service en Linux. Los pasos que se usan en este tutorial crean un conjunto de recursos seguros de forma predeterminada que incluyen App Service y Azure Database for PostgreSQL.

1. Si aún no lo ha hecho, clone la rama starter-no-infra del repositorio de ejemplo en un terminal local.

   Flask

   git clone -b starter-no-infra https://github.com/Azure-Samples/msdocs-flask-postgresql-sample-app
   cd msdocs-flask-postgresql-sample-app
   

   Django

   git clone -b starter-no-infra https://github.com/Azure-Samples/msdocs-django-postgresql-sample-app
   cd msdocs-django-postgresql-sample-app
   

   Esta rama clonada es el punto de partida. Contiene una aplicación Flask de unidad de datos simple.

2. Desde la raíz del repositorio, ejecute azd init.

   azd init --template python-app-service-postgresql-infra
   

3. Cuando se le solicite, proporcione las siguientes respuestas:

   Pregunta	Respuesta
   El directorio actual no está vacío. ¿Desea inicializar un proyecto aquí en "<su directorio>"?	Y
   ¿Qué quiere hacer con estos archivos?	Mantener mis archivos existentes sin cambios
   Escribir un nuevo nombre de entorno	Escriba un nombre único. La plantilla azd usa este nombre como parte del nombre DNS de la aplicación web en Azure (<app-name>.azurewebsites.net). Se permiten caracteres alfanuméricos y guiones.

4. Ejecute el comando azd up para aprovisionar los recursos de Azure necesarios e implementar el código de la aplicación. Si aún no ha iniciado sesión en Azure, el explorador se iniciará y le pedirá que inicie sesión. El comando azd up también le pedirá que seleccione la suscripción y la ubicación deseadas para la implementación.

   azd up
   

   El comando azd up puede tardar unos minutos en completarse. También compila e implementa el código de la aplicación, pero modificará el código más adelante para trabajar con App Service. Mientras se ejecuta, el comando proporciona mensajes sobre el proceso de aprovisionamiento e implementación, incluido un vínculo a la implementación en Azure. Cuando termina, el comando también muestra un vínculo a la aplicación implementada.

   Esta plantilla de azd contiene archivos (azure.yaml y el directorio infra) que generarán una arquitectura segura de forma predeterminada con los siguientes recursos de Azure:

   Flask

   • Grupo de recursos → Contenedor de todos los recursos creados.
   • Plan de App Service → Define los recursos de proceso de App Service. Se especifica un plan de Linux en el nivel B1.
   • App Service → Representa su aplicación y se ejecuta en el plan de App Service.
   • Red virtual → Se integra con la aplicación App Service y aísla el tráfico de red de back-end.
   • Servidor flexible de Azure Database for PostgreSQL → Accesible solo desde la red virtual. Una base de datos y un usuario se crean automáticamente en el servidor.
   • Zona DNS privada → Habilita la resolución DNS del servidor de PostgreSQL en la red virtual.
   • Área de trabajo de Log Analytics → Actúa como contenedor de destino para que su aplicación envíe sus registros, donde también puede consultar los registros.

   Django

   • Grupo de recursos → Contenedor de todos los recursos creados.
   • Plan de App Service → Define los recursos de proceso de App Service. Se especifica un plan de Linux en el nivel B1.
   • App Service → Representa su aplicación y se ejecuta en el plan de App Service.
   • Red virtual → Se integra con la aplicación App Service y aísla el tráfico de red de back-end.
   • Servidor flexible de Azure Database for PostgreSQL → Accesible solo desde la red virtual. Una base de datos y un usuario se crean automáticamente en el servidor.
   • Azure Cache for Redis → Accesible solo desde la red virtual.
   • Zona DNS privada → Habilita la resolución DNS del servidor de PostgreSQL en la red virtual.
   • Área de trabajo de Log Analytics → Actúa como contenedor de destino para que su aplicación envíe sus registros, donde también puede consultar los registros.

2. Uso de la cadena de conexión de base de datos

La plantilla azd que usa ya le ha generado las variables de conectividad como configuración de la aplicación y las envía al terminal para mayor comodidad. La configuración de la aplicación es una forma de mantener los secretos de conexión fuera del repositorio de código.

1. En la salida azd, busque la configuración de la aplicación y visualice los ajustes AZURE_POSTGRESQL_CONNECTIONSTRING y AZURE_REDIS_CONNECTIONSTRING. Para mantener los secretos seguros, solo se muestran los nombres de configuración. Tienen este aspecto en la salida azd:

    App Service app has the following settings:
   
            - AZURE_POSTGRESQL_CONNECTIONSTRING
            - AZURE_REDIS_CONNECTIONSTRING
            - FLASK_DEBUG
            - SCM_DO_BUILD_DURING_DEPLOYMENT
            - SECRET_KEY
    

2. AZURE_POSTGRESQL_CONNECTIONSTRING contiene la cadena de conexión a la base de datos de Postgres en Azure y AZURE_REDIS_CONNECTIONSTRING contiene la cadena de conexión a la memoria caché de Redis en Azure. Debe usarlos en el código para conectarse a él. Abra azureproject/production.py, quite la marca de comentario de las líneas siguientes y guarde el archivo:

   Flask

   conn_str = os.environ['AZURE_POSTGRESQL_CONNECTIONSTRING']
   conn_str_params = {pair.split('=')[0]: pair.split('=')[1] for pair in conn_str.split(' ')}
   DATABASE_URI = 'postgresql+psycopg2://{dbuser}:{dbpass}@{dbhost}/{dbname}'.format(
       dbuser=conn_str_params['user'],
       dbpass=conn_str_params['password'],
       dbhost=conn_str_params['host'],
       dbname=conn_str_params['dbname']
   )
   

   El código de la aplicación ahora está configurado para conectarse a la base de datos postgreSQL en Azure. Si lo desea, abra app.py y vea cómo se usa la variable de entorno DATABASE_URI.

   Django

   conn_str = os.environ['AZURE_POSTGRESQL_CONNECTIONSTRING']
   conn_str_params = {pair.split('=')[0]: pair.split('=')[1] for pair in conn_str.split(' ')}    
   DATABASES = {
       'default': {
           'ENGINE': 'django.db.backends.postgresql',
           'NAME': conn_str_params['dbname'],
           'HOST': conn_str_params['host'],
           'USER': conn_str_params['user'],
           'PASSWORD': conn_str_params['password'],
       }
   }
   
   CACHES = {
           "default": {  
               "BACKEND": "django_redis.cache.RedisCache",
               "LOCATION": os.environ.get('AZURE_REDIS_CONNECTIONSTRING'),
               "OPTIONS": {
                   "CLIENT_CLASS": "django_redis.client.DefaultClient",
                   "COMPRESSOR": "django_redis.compressors.zlib.ZlibCompressor",
           },
       }
   }
   

   El código de la aplicación ahora está configurado para conectarse a la base de datos postgreSQL y la memoria caché de Redis en Azure.

3. En el terminal, ejecute azd deploy.

   azd deploy
   

4. Generación del esquema de la base de datos

Con la base de datos PostgreSQL protegida por la red virtual, la manera más fácil de ejecutar migraciones de base de datos de Flask es mediante una sesión SSH con el contenedor de App Service.

Flask

1. En la salida azd, busque la dirección URL de la sesión SSH y vaya a ella en el explorador. Se parece a esto en la salida:

    Open SSH session to App Service container at: https://<app-name>.scm.azurewebsites.net/webssh/host
    

2. En el terminal de SSH, ejecute flask db upgrade. Si se realiza correctamente, App Service se conecta a la base de datos.

   

   Nota:

   Cuando la aplicación se reinicie, solo persisten los cambios realizados en los archivos ubicados en /home. Los cambios efectuados fuera de /home no se conservan.

Django

1. En la salida azd, busque la dirección URL de la sesión SSH y vaya a ella en el explorador. Se parece a esto en la salida:

    Open SSH session to App Service container at: https://<app-name>.scm.azurewebsites.net/webssh/host
    

2. En el terminal de SSH, ejecute python manage.py migrate. Si se realiza correctamente, App Service se conecta a la base de datos.

   

   Nota:

   Cuando la aplicación se reinicie, solo persisten los cambios realizados en los archivos ubicados en /home. Los cambios efectuados fuera de /home no se conservan.

5. Navegación hasta la aplicación

1. En la salida azd, busque la dirección URL de la aplicación y vaya a ella en el explorador. La dirección URL tiene este aspecto en la salida de AZD:

    Deploying services (azd deploy)
   
      (✓) Done: Deploying service web
      - Endpoint: https://<app-name>.azurewebsites.net/
    

2. Agregue algunos restaurantes a la lista.

   Flask

   

   Django

   

   Enhorabuena, ya está ejecutando una aplicación web en Azure App Service, con conectividad protegida a Azure Database for PostgreSQL.

6. Transmisión de registros de diagnóstico

Azure App Service puede capturar registros de consola para ayudarle a diagnosticar problemas con la aplicación. Para mayor comodidad, la plantilla azd ya ha habilitado el registro en el sistema de archivos local, así como el envío a un área de trabajo de Log Analytics.

La aplicación de ejemplo incluye instrucciones print() para demostrar esta funcionalidad, como se muestra en el siguiente fragmento de código.

Flask

@app.route('/', methods=['GET'])
def index():
    print('Request for index page received')
    restaurants = Restaurant.query.all()
    return render_template('index.html', restaurants=restaurants)

Django

def index(request):
    print('Request for index page received')
    restaurants = Restaurant.objects.annotate(avg_rating=Avg('review__rating')).annotate(review_count=Count('review'))
    lastViewedRestaurant = request.session.get("lastViewedRestaurant", False)

En la salida azd, busque el vínculo para transmitir registros de App Service y vaya a él en el explorador. El vínculo tiene este aspecto en la salida azd:

Stream App Service logs at: https://portal.azure.com/#@/resource/subscriptions/<subscription-guid>/resourceGroups/<group-name>/providers/Microsoft.Web/sites/<app-name>/logStream

Obtenga más información sobre cómo iniciar sesión en aplicaciones de Python en la serie sobre cómo configurar Azure Monitor para la aplicación Python.

7. Limpieza de recursos

Para eliminar todos los recursos de Azure en el entorno de implementación actual, ejecute azd down.

azd down

Solucionar problemas

A continuación se indican los problemas que pueden surgir al intentar trabajar con este tutorial y los pasos para resolverlos.

No puedo conectarme a la sesión de SSH

Si no puede conectarse a la sesión SSH, significa que no se pudo iniciar la propia aplicación. Compruebe los registros de diagnóstico para obtener más información. Por ejemplo, si ve un error como KeyError: 'AZURE_POSTGRESQL_CONNECTIONSTRING', puede significar que falta la variable de entorno (es posible que haya quitado el valor de configuración de la aplicación).

Recibo un error al ejecutar migraciones de base de datos

Si encuentra algún error relacionado con la conexión a la base de datos, compruebe si se han cambiado los valores de configuración de la aplicación (AZURE_POSTGRESQL_CONNECTIONSTRING). Sin esa cadena de conexión, el comando de migración no se puede comunicar con la base de datos.

Preguntas más frecuentes

• ¿Cuánto cuesta esta configuración?
• ¿Cómo me conecto al servidor de PostgreSQL protegido tras la red virtual con otras herramientas?
• ¿Cómo funciona el desarrollo de aplicaciones locales con Acciones de GitHub?
• ¿Cómo está configurado el ejemplo de Django para ejecutarse en Azure App Service?

¿Cuánto cuesta esta configuración?

Los precios por los recursos creados son los siguientes:

• El plan de App Service se crea en el nivel Básico y puede escalar o reducirse verticalmente. Consulte Precios de App Service.
• PostgreSQL, servidor flexible se crea en el nivel ampliable más bajo (Standard_B1ms), con el tamaño de almacenamiento mínimo, que se puede escalar o reducir verticalmente. Consulte los precios de Azure Database for PostgreSQL.
• La red virtual no incurre en cargo alguno, a menos que se configure alguna funcionalidad extra, como, por ejemplo, el emparejamiento. Vea Precios de Azure Virtual Network.
• La zona DNS privada conlleva un pequeño cargo. Vea Precios de Azure DNS.

¿Cómo me conecto al servidor de PostgreSQL protegido tras la red virtual con otras herramientas?

• Para tener un acceso básico desde una herramienta de línea de comandos, puede ejecutar psql desde el terminal de SSH de la aplicación.
• Para conectarse desde una herramienta de escritorio, la máquina debe estar en la red virtual. Por ejemplo, podría ser una máquina virtual de Azure conectada a una de las subredes, o una máquina de una red local que tenga una conexión VPN de sitio a sitio a la red virtual de Azure.
• También puede integrar Azure Cloud Shell en la red virtual.

¿Cómo funciona el desarrollo de aplicaciones locales con Acciones de GitHub?

Tomando como ejemplo el archivo de flujo de trabajo generado automáticamente de App Service: cada git push inicia una nueva ejecución de compilación e implementación. Desde un clon local del repositorio de GitHub, realiza las actualizaciones deseadas y las inserta en GitHub. Por ejemplo:

git add .
git commit -m "<some-message>"
git push origin main

¿Cómo está configurado el ejemplo de Django para ejecutarse en Azure App Service?

Nota

Si sigue este tutorial con su propia aplicación, examine la descripción del archivo requirements.txt en el archivo README.md de cada proyecto (Flask, Django) para ver los paquetes que necesitará.

La aplicación de ejemplo de Django configura los valores en el archivo azureproject/production.py para que se pueda ejecutar en Azure App Service. Estos cambios son comunes a la implementación de Django en producción y no son específicos de App Service.

• Django valida el encabezado HTTP_HOST en las solicitudes entrantes. El código de ejemplo usa la variable de entorno WEBSITE_HOSTNAME en App Service para agregar el nombre de dominio de la aplicación al valor de ALLOWED_HOSTS de Django.

  # Configure the domain name using the environment variable
  # that Azure automatically creates for us.
  ALLOWED_HOSTS = [os.environ['WEBSITE_HOSTNAME']] if 'WEBSITE_HOSTNAME' in os.environ else []
  

• Django no admite servir archivos estáticos en producción. En este tutorial se usa WhiteNoise para permitir servir los archivos. El paquete WhiteNoise ya se instaló con requirements.txt y su middleware se ha agregado a la lista.

  
  # WhiteNoise configuration
  MIDDLEWARE = [
      'django.middleware.security.SecurityMiddleware',
      # Add whitenoise middleware after the security middleware
      'whitenoise.middleware.WhiteNoiseMiddleware',
  

  Los valores del archivo estático se configuran según la documentación de Django.

  SESSION_ENGINE = "django.contrib.sessions.backends.cache"
  STATICFILES_STORAGE = 'whitenoise.storage.CompressedManifestStaticFilesStorage'
  

Para obtener más información, consulte Configuración de producción para aplicaciones de Django.

Pasos siguientes

Pase al tutorial siguiente para aprender a proteger la aplicación con un dominio personalizado y un certificado.

 Protección con un certificado y dominio personalizado

Obtenga información sobre cómo App Service ejecuta una aplicación de Python:

Configuración de una aplicación de Python