Implementación de una aplicación web Django de Python con PostgreSQL en Azure

En este tutorial, implementará una aplicación web python controlada por datos en Azure App Service que usa el servicio de base de datos relacional de Azure Database for PostgreSQL . Azure App Service admite Python en un entorno de servidor Linux. En este artículo se usa Django. Entre las alternativas se incluyen Flask o el tutorial de FastAPI.

En este tutorial, aprenderá a:

• Cree una arquitectura de App Service, PostgreSQL y Redis Cache segura de manera predeterminada.
• Asegure los secretos de conexión utilizando una identidad administrada y referencias de Key Vault.
• Implemente una aplicación de muestra de Python en App Service desde un repositorio de GitHub.
• Acceda a las cadenas de conexión de App Service y a la configuración de la aplicación en el código de la aplicación.
• Realice actualizaciones y vuelva a implementar el código de la aplicación.
• Genere el esquema de la base de datos mediante la ejecución de migraciones de bases de datos.
• Transmitir registros de diagnóstico desde Azure.
• Administrar la aplicación en Azure Portal.
• Aprovisione la misma arquitectura e impleméntela usando Azure Developer CLI.
• Optimice su flujo de trabajo de desarrollo con GitHub Codespaces y GitHub Copilot.

Requisitos previos

• Una cuenta de Azure con una suscripción activa. Si no tiene una cuenta de Azure, puede crearla gratis.
• Una cuenta de GitHub. También puede obtener una gratis.
• Conocimientos de Python con el desarrollo de Django.
• (Opcional) Para probar GitHub Copilot, una cuenta de GitHub Copilot. Hay disponible una evaluación gratuita de 30 días.

• 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 el desarrollo de Django.
• (Opcional) Para probar GitHub Copilot, una cuenta de GitHub Copilot. Hay disponible una evaluación gratuita de 30 días.

Ir al final

Si solo quiere ver la aplicación de ejemplo de este tutorial ejecutándose en Azure, ejecute los siguientes comandos en Azure Cloud Shell y siga las indicaciones.

mkdir msdocs-django-postgresql-sample-app
cd msdocs-django-postgresql-sample-app
azd init --template msdocs-django-postgresql-sample-app
azd up

Ejecución del ejemplo

Como punto de partida, configure una aplicación controlada por datos de ejemplo. Para lograr mayor comodidad, el repositorio de ejemplo incluye una configuración de contenedor de desarrollo. El contenedor de desarrollo tiene todo lo que necesita para desarrollar una aplicación, incluida la base de datos, la caché y todas las variables de entorno que necesita la aplicación de ejemplo. El contenedor de desarrollo se puede ejecutar en un espacio de código de GitHub, por lo que puede ejecutar el ejemplo en cualquier equipo con un explorador web.

Nota:

Si sigue este tutorial con su propia aplicación, consulte la descripción del archivo requirements.txt en README.md para ver los paquetes que necesita.

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/fork.
3. Anule la selección de Copiar solo la rama principal. Quiere todas las ramas.
4. Seleccione Crear bifurcación.

Paso 2: en el fork de GitHub:

1. Seleccione Principal>starter-no-infra para la rama de inicio. Esta rama contiene solo el proyecto de ejemplo y ninguna configuración ni archivo relacionados con Azure.
2. Seleccione Código>Crear codespace on starter-no-infra. El codespace tarda unos minutos en configurarse. Ejecuta pip install -r requirements.txt para tu repositorio. El archivo .env proporcionado ya contiene una variable ficticia SECRET_KEY que Django debe ejecutar localmente.

Paso 3: En el terminal de codespace:

1. Ejecute las migraciones de la base de datos con python manage.py migrate.
2. Ejecute la aplicación con python manage.py runserver.
3. Cuando vea la notificación Your application running on port 8000 is available., seleccione Abrir en explorador. Debería ver la aplicación de ejemplo en una nueva pestaña del explorador. Para detener la aplicación, escriba Ctrl+C.

Sugerencia

Puede preguntar a GitHub Copilot sobre este repositorio. Por ejemplo:

• @workspace ¿Qué hace este proyecto?
• @workspace ¿Qué hace la carpeta .devcontainer?

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

Creación de App Service, base de datos y caché

En este paso, cree los recursos de Azure. En este tutorial se crea un conjunto de recursos seguros de forma predeterminada que incluyen App Service, Azure Database for PostgreSQL y Azure Cache. En el proceso de creación, especifique lo siguiente:

• El Nombre de la aplicación web. Se usa como parte del nombre DNS de la aplicación.
• La región para ejecutar la aplicación físicamente en el mundo. También forma parte del nombre DNS de la aplicación.
• La pila en tiempo de ejecución para la aplicación. Seleccione la versión de Python que se va a usar para la aplicación.
• El plan de hospedaje para la aplicación. El plan de tarifa 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 le permite agrupar todos los recursos de Azure necesarios para la aplicación en un contenedor lógico.

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

Paso 1: En el portal Azure:

1. En la parte superior de Azure Portal, en el cuadro de búsqueda, escriba base de datos de aplicación web.
2. En el encabezado Marketplace , seleccione el elemento con la etiqueta Aplicación web y base de datos. También puede ir directamente a Crear aplicación web .

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 escriba msdocs-django-postgres-tutorial.
2. Región: cualquier región de Azure cercana a usted.
3. Nombre: msdocs-python-postgres-XYZ.
4. Pila en runtime: Python 3.14.
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.
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 Ir al recurso. La implementación crea los siguientes recursos:

• Grupo de recursos: contenedor para todos los recursos creados.
• Plan de App Service: define los recursos de proceso de App Service. Esta instancia es 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 back-end.
• Punto de conexión privado: punto de conexión de acceso para Redis Cache en la red virtual.
• Interfaces de red: direcciones IP privadas, una para cada uno de los puntos de conexión privados.
• Servidor flexible de Azure Database for PostgreSQL: accesible solo desde dentro de la red virtual. La implementación crea una base de datos y un usuario en el servidor.
• Azure Cache for Redis: accesible solo desde su red privada.
• Zonas DNS privadas: habilitar la resolución DNS del servidor de base de datos y Redis Cache en la red virtual.

Protección de secretos de conexión y adición de SECRET_KEY

El proceso de implementación genera las variables de conectividad para usted como configuración de la aplicación. El procedimiento recomendado de seguridad es mantener completamente los secretos fuera de App Service. Mueva sus secretos a un almacén de claves y cambie la configuración de su aplicación a referencias de Key Vault con la ayuda de los conectores de servicio.

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

1. En el menú izquierdo de la página de 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 de Postgres y a la caché de Redis protegida detrás de puntos de conexión privados. Los secretos se guardan directamente en la aplicación de App Service, que no es el mejor enfoque. Vas a cambiar esta configuración. También agregas una SECRET_KEY configuración, que requiere tu aplicación de Django.

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 key vault y, a continuación, seleccione Marketplace>Key Vault.
2. En Grupo de recursos, seleccione msdocs-python-postgres-tutorial.
3. En Nombre de la bóveda de claves, escriba un nombre que solo contenga letras y números.
4. En Región, seleccione la misma ubicación que el grupo de recursos.

Paso 3: Asegura la bóveda 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 el cuadro de diálogo, en Ubicación, seleccione la misma ubicación que la aplicación de App Service.
6. En Nombre, escriba msdocs-python-postgres-XYZVaultEndpoint.
7. En Red virtual, seleccione msdocs-python-postgres-XYZVnet.
8. En Subred, msdocs-python-postgres-XYZSubnet.
9. Seleccione Aceptar.
10. Seleccione Revisar y crear y, luego, Crear. Espere a que finalice la implementación del almacén de claves. Debería ver que la implementación está completa.

Paso 4: Configuración del conector de PostgreSQL

1. En la barra de búsqueda superior, escriba msdocs-python-postgres y seleccione el recurso de App Service msdocs-python-postgres-XYZ.
2. En la página App Service , en el menú de la izquierda, seleccione Configuración>del conector de servicio. Ya hay dos conectores, que el proceso de creación de la aplicación ha creado automáticamente.
3. Active la casilla situada junto al conector de PostgreSQL y seleccione Editar.
4. En Tipo de cliente, seleccione Django. El tipo de cliente Django del conector del servicio PostgreSQL proporciona variables de base de datos en configuraciones independientes en lugar de una cadena de conexión. Las variables independientes son más fáciles de usar en la configuración de la base de datos de Django.
5. Seleccione 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. Esta acción abre un cuadro de diálogo Crear conexión sobre el 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 PostgreSQL

1. Vuelve al cuadro de diálogo de edición de defaultConnector. En Autenticación, espere a que se cree el conector del almacén de claves. 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: Configuración del conector de Redis para usar secretos de Key Vault

1. En la página Conectores de servicio, active la casilla situada junto al conector cache for Redis y, a continuación, seleccione Editar.
2. Seleccione Autenticación.
3. Seleccione Almacenar secreto en Key Vault.
4. En Conexión de Key Vault, seleccione el almacén de claves que creó.
5. Seleccione Siguiente: Redes.
6. Seleccione Configurar reglas de firewall para habilitar el acceso al servicio de destino. El proceso de creación de la aplicación ya ha protegido la base de datos SQL con un punto de conexión privado.
7. Seleccione Guardar. Espere hasta que aparezca la Actualización correcta notificación.

Paso 8: Comprobar 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_PASSWORD, seleccione Mostrar valor. El valor debe ser @Microsoft.KeyVault(...), lo que significa que es una referencia al almacén de claves porque ahora el secreto se gestiona en el almacén de claves.
3. Para comprobar la cadena de conexión de Redis, seleccione Mostrar valor junto a AZURE_REDIS_CONNECTIONSTRING.

Paso 9: La aplicación de ejemplo lee la variable de entorno SECRET_KEY para establecer la configuración de SECRET_KEY necesaria. Se crea como una configuración de aplicación en este paso.

1. En la pestaña Configuración de la aplicación, seleccione + Agregar.
2. Establezca Nombre en SECRET_KEY.
3. Establezca Valor en una cadena aleatoria larga.
4. Seleccione Aplicar y, a continuación, Vuelva a aplicar y, a continuación, Confirme.

En resumen, el proceso para asegurar los secretos de conexión incluye:

• Recuperar los secretos de conexión de las variables de entorno de la aplicación de App Service.
• Creación de un almacén de claves.
• Creación de una conexión de Key Vault con la identidad administrada asignada por el sistema.
• Actualizar los conectores de servicio para almacenar los secretos en el almacén de claves.

Nota:

Lo ideal es que la configuración de la aplicación SECRET_KEY se configure también como una referencia del almacén de claves, que es un proceso de varios pasos. Para obtener más información, consulte ¿Cómo cambio la configuración de la aplicación de SECRET_KEY a una referencia de Key Vault?

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

---

Implementación de código de ejemplo

En esta sección, configure la implementación de GitHub mediante Acciones de GitHub. Es una de las muchas maneras de realizar la implementación en App Service. Es una excelente manera de tener integración continua en el proceso de implementación. De forma predeterminada, cada git push en tu repositorio de GitHub inicia la acción de construir e implementar.

Paso 1: En el menú de la izquierda, seleccione Implementación>Centro de implementación.

Paso 2: 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 starter-no-infra. Esta rama es la misma en la que ha trabajado con la aplicación de ejemplo, sin archivos ni configuraciones relacionados con Azure.
6. En Tipo de autenticación, seleccione Identidad asignada por el usuario.
7. En el menú superior, elija Guardar. App Service realiza un commit de un archivo de flujo de trabajo en el repositorio de GitHub en el directorio .github/workflows. De manera predeterminada, el centro de implementación crea una identidad asignada por el usuario para que el flujo de trabajo se autentique mediante Microsoft Entra (autenticación OIDC). Para ver otras opciones de autenticación, consulte Implementación en App Service mediante Acciones de GitHub.

Paso 3: De nuevo en el espacio de código de GitHub de la bifurcación de muestra, ejecute git pull origin starter-no-infra. Este comando extrae el archivo de flujo de trabajo recién confirmado en el espacio de código.

Paso 4 (Opción 1: con GitHub Copilot):

1. Inicie una nueva sesión de chat al seleccionar la vista Chat y, después, seleccionar +.
2. Pregunte: "@workspace ¿Cómo se conecta la aplicación a la base de datos y a Redis?". Copilot puede darle una explicación sobre cómo se configuran las opciones en azureproject/development.py y azureproject/production.py.
3. Pregunte: "@workspace En modo de producción, mi aplicación se ejecuta en una aplicación web de App Service, que usa Azure Service Connector para conectarse a un servidor flexible de PostgreSQL mediante el tipo de cliente Django. ¿Cuáles son los nombres de las variables de entorno que necesito usar?" Copilot puede proporcionarle una sugerencia de código similar a la de la opción 2: sin los pasos de GitHub Copilot siguientes e incluso indicarle que realice el cambio en el archivo azureproject/production.py .
4. Abra azureproject/production.py en el explorador y agregue la sugerencia de código.
5. Pregunte: "@workspace Mi aplicación App Service también usa Azure Service Connector para conectarse a una instancia de Cache for Redis mediante el tipo de cliente Django. ¿Cuáles son los nombres de las variables de entorno que necesito usar?" Copilot puede proporcionarle una sugerencia de código similar a la de la opción 2: sin los pasos de GitHub Copilot siguientes e incluso indicarle que realice el cambio en el archivo azureproject/production.py .
6. Agregue la sugerencia de código. GitHub Copilot no proporciona la misma respuesta cada vez. Las respuestas no siempre son correctas. Es posible que tenga que formular más preguntas para ajustar su respuesta. Para obtener sugerencias, consulte ¿Qué puedo hacer con GitHub Copilot en mi espacio de código?.

Paso 4 (Opción 2: sin GitHub Copilot):

1. Abra azureproject/production.py en el explorador.
2. Busque el código comentado (líneas 29-48) y quite la marca de comentario. Este código crea conexiones de PostgreSQL y Redis mediante AZURE_POSTGRESQL_USER, AZURE_POSTGRESQL_PASSWORD, AZURE_POSTGRESQL_HOST, AZURE_POSTGRESQL_NAMEy AZURE_REDIS_CONNECTIONSTRING.

Paso 5:

1. Seleccione la extensión Control de código fuente.
2. En el cuadro de texto, escriba un mensaje de confirmación, por ejemplo, Configure Azure database and cache connections. O bien, seleccione y deje que GitHub Copilot genere un mensaje de confirmación de manera automática.
3. Seleccione Confirmar y, a continuación, confirme con Sí.
4. Seleccione Sincronización de cambios 1 y confirme con Aceptar.

Paso 6: De nuevo en el Centro de implementación en Azure Portal:

1. Seleccione Registros y, a continuación, seleccione Actualizar para ver la nueva ejecución de implementación.
2. En el elemento de registro de la ejecución de implementación, seleccione la entrada Registros de compilación/implementación con la marca de tiempo más reciente.

Paso 7: Se le lleva al repositorio de GitHub. 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 el proceso de GitHub muestre un estado de Éxito. Tardará unos 5 minutos.

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

Generar esquema de 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 Django es mediante una sesión SSH con el contenedor de Linux en App Service.

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

1. Seleccione Herramientas de desarrollo>SSH.
2. Seleccione Ir.

Paso 2: En la sesión SSH, ejecute python manage.py migrate. Si se realiza correctamente, App Service se conecta a la base de datos.

Sugerencia

En la sesión SSH, solo los cambios en los archivos de /home pueden persistir más allá de los reinicios de la aplicación. Los cambios efectuados fuera de /home no se conservan.

La sesión SSH es útil para ejecutar comandos python manage.py comunes, como la creación de usuarios con python manage.py createsuperuser. Para obtener más información, consulte django django-admin y manage.py. Use la cuenta de superusuario para acceder a la parte /admin del sitio web.

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

Navegación hasta la aplicación

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.

Paso 2: agregue algunos restaurantes a la lista. ¡Felicidades! Está ejecutando una aplicación web en Azure App Service, con conectividad segura a Azure Database for PostgreSQL.

Transmisión de registros de diagnóstico

Azure App Service captura todos los registros de consola para ayudarle a diagnosticar problemas con la aplicación. La aplicación de ejemplo incluye print() declaraciones para demostrar esta funcionalidad.

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 Supervisión>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.

Para más información sobre el registro en aplicaciones de Python, consulte Configuración de Azure Monitor para la aplicación python.

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. Para confirmar la eliminación, escriba el nombre del grupo de recursos.
2. Seleccione Eliminar.

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

En esta sección, cree los recursos de Azure e implemente 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 manera predeterminada que incluyen App Service, Azure Database for PostgreSQL y Azure Cache for Redis.

El contenedor de desarrollo ya tiene Azure Developer CLI (AZD).

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

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

2. 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>"?	S
   ¿Qué quiere hacer con estos archivos?	Mantener mis archivos existentes sin cambios
   Escribir un nuevo nombre de entorno	Escriba un nombre único. La plantilla de AZD usa este nombre como parte del nombre DNS de la aplicación web en Azure (<app-name>-<hash>.azurewebsites.net). Se permiten caracteres alfanuméricos y guiones.

3. Inicie sesión en Azure mediante la ejecución del comando azd auth login y siga la solicitud:

   azd auth login
   

4. Cree los recursos de Azure necesarios con el comando azd provision. Siga la solicitud para seleccionar la suscripción y la ubicación deseadas para los recursos de Azure.

   azd provision
   

   El azd provision comando tarda unos 15 minutos en completarse. La caché de Redis tarda más tiempo. Más adelante, modifique el código para que funcione con App Service e implemente los cambios con azd deploy. Mientras se ejecuta, el comando proporciona mensajes sobre el proceso de aprovisionamiento e implementación. La salida incluye un vínculo a la implementación en Azure.

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

   • Grupo de recursos: contenedor para todos los recursos creados.
   • Plan de App Service: define los recursos de proceso de App Service. 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 back-end.
   • Puntos de conexión privados: Puntos de acceso para el almacén de claves y la memoria caché de Redis en la red virtual.
   • Interfaces de red: direcciones IP privadas, una para cada uno de los puntos de conexión privados.
   • Servidor flexible de Azure Database for PostgreSQL: accesible solo desde en la red virtual. Crea una base de datos y un usuario en el servidor.
   • Zona DNS privada: habilita la resolución DNS del servidor 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.
   • Azure Cache for Redis: accesible solo desde detrás de su punto de conexión privado.
   • Almacén de claves: accesible solo desde detrás de su punto de conexión privado. Se usa para administrar secretos para la aplicación de App Service.

   Una vez que el comando termine de crear recursos e implementar el código de la aplicación la primera vez, la aplicación de ejemplo implementada aún no funciona. Debe realizar pequeños cambios para conectarse a la base de datos en Azure.

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

Utilice la cadena de conexión de la base de datos

La plantilla de AZD que usaste generó las variables de conectividad como configuración de la aplicación. Los envía al terminal. 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 de AZD, busque los valores AZURE_POSTGRESQL_USER, AZURE_POSTGRESQL_PASSWORD, AZURE_POSTGRESQL_HOST, AZURE_POSTGRESQL_NAME y AZURE_REDIS_CONNECTIONSTRING. Para mantener los secretos seguros, solo se muestran los nombres de configuración. Tienen este aspecto en la salida de AZD:

    App Service app has the following connection settings:
            - AZURE_POSTGRESQL_NAME
            - AZURE_POSTGRESQL_HOST
            - AZURE_POSTGRESQL_USER
            - AZURE_POSTGRESQL_PASSWORD
            - AZURE_REDIS_CONNECTIONSTRING
            - AZURE_KEYVAULT_RESOURCEENDPOINT
            - AZURE_KEYVAULT_SCOPE
    

2. Para mayor comodidad, la plantilla de AZD muestra el vínculo directo a la página de configuración de la aplicación. Busque el vínculo y ábralo en una nueva pestaña del explorador.

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

Modificación del código de ejemplo y reimplementación

Con GitHub Copilot

1. En el espacio de código de GitHub, inicie una nueva sesión de chat; para ello, seleccione la vista Chat y, a continuación, seleccione +.

2. Pregunte: "@workspace ¿Cómo se conecta la aplicación a la base de datos?". Copilot puede proporcionar una explicación sobre cómo se configuran las opciones de conexión en azureproject/development.py y azureproject/production.py.

3. Pregunte: "@workspace En modo de producción, mi aplicación se ejecuta en una aplicación web de App Service, que usa Azure Service Connector para conectarse a un servidor flexible de PostgreSQL mediante el tipo de cliente Django. ¿Cuáles son los nombres de las variables de entorno que necesito usar?" Copilot puede proporcionarle una sugerencia de código similar a la de la opción 2: sin los pasos de GitHub Copilot siguientes e incluso indicarle que realice el cambio en el archivo azureproject/production.py .

4. Abra azureproject/production.py en el explorador y agregue la sugerencia de código.

   GitHub Copilot no proporciona la misma respuesta cada vez. Las respuestas no siempre son correctas. Es posible que tenga que formular más preguntas para ajustar su respuesta. Para obtener sugerencias, consulte ¿Qué puedo hacer con GitHub Copilot en mi espacio de código?.

5. En el terminal, ejecute azd deploy.

   azd deploy
   

Sin GitHub Copilot

1. Debe usar las cinco configuraciones de la aplicación para la conectividad en el servicio de aplicaciones. Abra azureproject/production.py, descomente las siguientes líneas (líneas 29-48) y guarde el archivo:

   DATABASE_URI = 'postgresql+psycopg2://{dbuser}:{dbpass}@{dbhost}/{dbname}'.format(
       dbuser=os.getenv('AZURE_POSTGRESQL_USER'),
       dbpass=os.getenv('AZURE_POSTGRESQL_PASSWORD'),
       dbhost=os.getenv('AZURE_POSTGRESQL_HOST'),
       dbname=os.getenv('AZURE_POSTGRESQL_NAME')
   )
   
   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.

   ---

2. En el terminal, ejecute azd deploy.

   azd deploy
   

Nota:

Si ejecuta azd up, combina azd package, azd provision y azd deploy. La razón por la que no lo hizo al principio fue porque aún no tenía la configuración de conexión de PostgreSQL para modificar el código. Si se ejecuta azd up entonces, la fase de implementación se detendría porque el servidor Gunicorn no podría iniciar la aplicación sin una configuración de conexión válida. Pero en general, puede volver a ejecutar estos comandos al realizar cambios en la plantilla de AZD o en el código.

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

Generar esquema de 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 Django es mediante una sesión SSH con el contenedor de Linux en App Service.

1. En la salida de AZD, busque la dirección URL de la sesión SSH y vaya a ella en el explorador. Parece así en los resultados.

   Open SSH session to App Service container at: <URL>
   

2. En la sesión SSH, ejecute python manage.py migrate. Si el comando se realiza correctamente, App Service se conecta correctamente 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.

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

Navegación hasta la aplicación

1. En la salida de 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: <URL>
   

2. Agregue algunos restaurantes a la lista.

   

   ¡Felicidades! Está ejecutando una aplicación web en Azure App Service, con conectividad segura a Azure Database for PostgreSQL.

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

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 de AZD ya ha habilitado el registro en el sistema de archivos local y está enviando los registros 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.

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 de AZD, busque el vínculo para transmitir registros de App Service y vaya a él en el explorador.

Stream App Service logs at: <URL>

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.

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

Limpieza de recursos

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

azd down

Solución de problemas

Estos son los problemas que pueden surgir al intentar trabajar con este tutorial y pasos para resolverlos.

No puedo conectarme a la sesión de SSH

Si no se puede conectar a la sesión SSH, la propia aplicación no se puede iniciar. Compruebe los registros de diagnóstico para obtener más información. Por ejemplo, si ve un error como KeyError: 'AZURE_POSTGRESQL_HOST', puede significar que falta la variable de entorno. Es posible que haya quitado la 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 o eliminado los valores de configuración de la aplicación (AZURE_POSTGRESQL_USER, AZURE_POSTGRESQL_PASSWORD, AZURE_POSTGRESQL_HOST y AZURE_POSTGRESQL_NAME). 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?
• ¿Cómo cambio la configuración de la aplicación SECRET_KEY a una referencia de Key Vault?
• ¿Cómo se depuran los errores durante la implementación de Acciones de GitHub?
• No tengo permisos para crear una identidad asignada por el usuario
• ¿Qué puedo hacer con GitHub Copilot en mi codespace?

• ¿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?
• ¿Cómo se depuran los errores durante la implementación de Acciones de GitHub?
• No tengo permisos para crear una identidad asignada por el usuario
• ¿Qué puedo hacer con GitHub Copilot en mi codespace?

¿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, salvo que configures funcionalidades adicionales, como 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 con 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?

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',
  

  Luego, la configuración de archivos estáticos se aplica 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.

¿Cómo cambio la configuración de la aplicación SECRET_KEY a una referencia de Key Vault?

En los pasos descritos en Azure Portal, puede cambiar SECRET_KEY a una referencia de Key Vault mediante la ejecución de los siguientes comandos de la CLI de Azure en Cloud Shell:

# Change the following variables to match your environment
SUBSCRIPTION_ID=<subscription-id>
RESOURCE_GROUP=<resource-group-name>
KEY_VAULT_NAME=<key-vault-name>
APP_SERVICE_NAME=<app-name>
SECRET_NAME=djangoSecretKey

# Set the subscription ID
az account set --subscription $SUBSCRIPTION_ID

# Assign 'Key Vault Secrets Officer' role to your user at the scope of the key vault
az role assignment create \
  --assignee $(az ad signed-in-user show --query id -o tsv) \
  --role $(az role definition list --name "Key Vault Secrets Officer" --query "[].id" -o tsv) \
  --scope $(az keyvault show --name $KEY_VAULT_NAME --resource-group $RESOURCE_GROUP --query id --output tsv)

# Add the secret to the key vault
az keyvault secret set \
  --vault-name $KEY_VAULT_NAME \
  --name $SECRET_NAME \
  --value $(python -c 'import secrets; print(secrets.token_hex())')

# Add Key Vault reference to the App Service configuration
az webapp config appsettings set \
  --resource-group $RESOURCE_GROUP \
  --name $APP_SERVICE_NAME \
  --settings "SECRET_KEY=@Microsoft.KeyVault(SecretUri=https://$KEY_VAULT_NAME.vault.azure.net/secrets/$SECRET_NAME)"

También puede hacer lo mismo en el portal. Para más información, vea:

• Asignación de roles del ámbito de Key Vault
• Incorporación de un secreto a Key Vault
• Recuperar un secreto del almacén de claves
• Configuración de aplicaciones

¿Cómo se depuran los errores durante la implementación de Acciones de GitHub?

Si falla un paso en el archivo de flujo de trabajo generado automáticamente de GitHub, procure modificar el comando fallido para generar una salida más detallada. Por ejemplo, puede obtener más resultados del comando python agregando la opción -d. Confirme e inserte los cambios para desencadenar otra implementación en App Service.

No tengo permisos para crear una identidad asignada por el usuario

Vea Configurar la implementación de GitHub Actions desde el Deployment Center.

¿Qué puedo hacer con GitHub Copilot en mi codespace?

La vista de chat de GitHub Copilot ya estaba ahí cuando creaste el espacio de desarrollo. Para mayor comodidad, incluimos la extensión de chat de GitHub Copilot en la definición del contenedor (consulte .devcontainer/devcontainer.json). Sin embargo, necesita una cuenta de GitHub Copilot (versión de prueba gratuita de 30 días disponible).

Algunas sugerencias para usted al hablar con GitHub Copilot:

• En una sola sesión de chat, las preguntas y respuestas se basan entre sí y puede ajustar sus preguntas para ajustar la respuesta que obtenga.
• De forma predeterminada, GitHub Copilot no tiene acceso a ningún archivo del repositorio. Para formular preguntas sobre un archivo, abra primero el archivo en el editor.
• Para permitir que GitHub Copilot tenga acceso a todos los archivos del repositorio al preparar sus respuestas, comience la pregunta con @workspace. Para obtener más información, vea Use the @workspace agent.
• En la sesión de chat, GitHub Copilot puede sugerir cambios y (con @workspace) incluso dónde hacer los cambios, pero no tiene permitido hacer los cambios por ti. Es necesario agregar los cambios sugeridos y probarlos.

Contenido relacionado

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

O bien, obtenga información sobre cómo App Service ejecuta una aplicación de Python:

• Configuración de una aplicación de Python en Linux para Azure App Service