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

Paso 1: En el portal Azure:

1. En la parte superior de Azure Portal, escriba la base de datos de la aplicación web en la barra de búsqueda.
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 use un nombre de msdocs-flask-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?: no.
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.

Paso 3: La implementación tarda unos minutos. 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. La implementación 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.
• Interfaces de red: representa 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. Una base de datos y un usuario se crean automáticamente en el servidor.
• Zonas DNS privadas: Permite la resolución DNS del almacén de claves y del servidor de base de datos en la red virtual.

Paso 1: Recupere 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 la aplicación, en el campo Valor , busque 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. El secreto se guarda directamente en la aplicación de App Service, que no es el procedimiento recomendado. Más adelante, cambiarás esta configuración.

Paso 2: Cree 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: Proteja la bóveda de claves con un punto de conexión privado:

1. Seleccionar 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, seleccione 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: Configure el conector de PostgreSQL:

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>del conector de servicio. Ya hay un conector que el proceso de implementación ha creado para ti.
3. Active la casilla situada junto al conector PostgreSQL y seleccione Editar.
4. En Tipo de cliente, seleccione Django. Aunque tiene una aplicación de Flask, el tipo de cliente Django en el conector del servicio PostgreSQL proporciona variables de base de datos en una configuración independiente en lugar de una cadena de conexión. Las variables independientes son más fáciles de usar en el código de aplicación, que usa SQLAlchemy para conectarse a la base de datos.
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. Se abre un cuadro de diálogo Crear conexión en la parte superior del cuadro de diálogo de edición.

Paso 5: Establezca 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: Finalizar la configuración del conector de PostgreSQL:

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 finalice la creación, 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 nuevamente.
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. El secreto ahora se administra en el almacén de claves.

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-flask-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 confirma un archivo de flujo de trabajo en el repositorio de GitHub escogido, 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 entorno de programación de GitHub de la bifurcación de ejemplo, 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 seleccionando 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 SQLAlchemy, como cómo se configura su URI 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 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 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 codespace?

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

1. Abra azureproject/production.py en el explorador.
2. Busque el código comentado (líneas 3-8) y quite la marca de comentario. Este cambio crea una cadena de conexión para SQLAlchemy mediante AZURE_POSTGRESQL_USER, AZURE_POSTGRESQL_PASSWORD, AZURE_POSTGRESQL_HOSTy AZURE_POSTGRESQL_NAME.

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 connection. 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 vuelta en la página 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 la ejecución en GitHub muestre el estado Éxito. Tardará unos 5 minutos.

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 Continuar.

Paso 2: En la sesión SSH, ejecute flask db upgrade. Si se realiza correctamente, App Service se conecta a la base de datos.

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. Enhorabuena, ya está ejecutando una aplicación web en Azure App Service, con conectividad protegida a Azure Database for PostgreSQL.

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.

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.
3. Confirme con Eliminar de nuevo.