Tutorial: Implementación de una aplicación de ASP.NET Core y Azure SQL Database en Azure App Service

Step 1: En el portal de Azure:

1. En la barra de búsqueda superior, escriba app service.
2. Seleccione el elemento con la etiqueta App Service en el encabezado Servicios.
3. Seleccione Crear>Aplicación web. También puede ir directamente al asistente de creación.

Paso 2: En la página Crear aplicación web, rellene el formulario de la siguiente forma.

1. Nombre: msdocs-core-sql-XYZ. Se generará un grupo de recursos denominado msdocs-core-sql-XYZ_group .
2. Runtime stack: .NET 8 (LTS).
3. Sistema operativo: Linux.
4. Región: su región preferida.
5. Plan de Linux: cree nuevo y use el nombre msdocs-core-sql-XYZ.
6. Plan de precios: Basic B1. Cuando esté listo, puede escalar verticalmente a un plan de tarifa distinto.

Paso 3:

1. Seleccione la pestaña Base de datos .
2. Seleccione Crear una base de datos.
3. En Motor, seleccione SQLAzure.
4. Seleccione Crear un almacenamiento en caché de Azure para Redis.
5. En Nombre (en Caché), escriba un nombre para la memoria caché.
6. En SKU, seleccione Basic (Básico).

Paso 4:

1. Seleccione la pestaña Implementación .
2. Habilite la implementación continua.
3. En Organization, seleccione el alias de GitHub.
4. En Repositorio, seleccione msdocs-app-service-sqldb-dotnetcore.
5. En Rama, seleccione starter-no-infra.
6. Asegúrese de que la autenticación básica está deshabilitada.
7. Seleccione Revisar + crear.
8. Una vez completada la validación, seleccione Crear.

Paso 5: 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 para 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 back-end.
• Puntos de conexión privados: Acceda a los puntos de conexión para el almacén de claves, el servidor de bases de datos y Redis Cache en la red virtual.
• Interfaces de red: representa direcciones IP privadas, una para cada uno de los puntos de conexión privados.
• servidor de Azure SQL Database: accesible solo a través de su punto de conexión privado.
• Azure SQL Database: se crea una base de datos y un usuario en el servidor.
• 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.
• Private DNS zones: Habilita la resolución DNS del almacén de claves, el servidor de bases de datos y la caché de Redis en la red virtual.

Paso 1: Recuperar 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 > Cadenas de conexión.
2. Seleccione AZURE_SQL_CONNECTIONSTRING.
3. En Agregar/Editar cadena de conexión, en el campo Value, busque la parte de Password= al final de la cadena.
4. Copie la cadena de contraseña después de Password= para usarla más adelante. Este connection string le permite conectarse a la base de datos SQL protegida detrás de un punto de conexión privado. Sin embargo, los secretos se guardan directamente en la aplicación de App Service, que no es lo mejor. Del mismo modo, la cadena de conexión de caché de Redis en la pestaña de configuración de App contiene un secreto. Cambiarás 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 "key vault", seleccione Marketplace>Key Vault.
2. En Grupo de recursos, seleccione msdocs-core-sql-XYZ_group.
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-core-sql-XYZ_group.
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-core-sql-XYZVvaultEndpoint.
7. En Red virtual, seleccione la red virtual en el grupo msdocs-core-sql-XYZ_group .
8. En Subred, seleccione la subred compatible disponible. El Asistente para aplicaciones web lo creó para su comodidad.
9. Seleccione Aceptar.
10. Seleccione Revisar y crear y, luego, Crear. Espere a que finalice la implementación del almacén de claves. Deberías ver "Tu implementación ha sido completada".

Paso 4:

1. En la barra de búsqueda superior, escriba msdocs-core-sqly, a continuación, el recurso de App Service denominado msdocs-core-sql-XYZ.
2. En la página App Service, en el menú de la izquierda, seleccione Configuración > Conector de servicio. Ya hay dos conectores, que el asistente para la creación de aplicaciones ha creado automáticamente.
3. Active la casilla situada junto al Conector de bases de datos SQL y seleccione Editar.
4. Seleccione la pestaña Autenticación.
5. En Contraseña, pegue la contraseña que copió anteriormente.
6. Seleccione Store Secret en Key Vault.
7. En Key Vault Connection, seleccione Crear nuevo. Se abre un cuadro de diálogo Crear conexión encima del cuadro de diálogo de edición.

Step 5: Establecer 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 key vault que creó anteriormente.
2. Seleccione Revisar + crear.
3. Cuando se complete la validación, seleccione Crear.

Paso 6: Finalización de la configuración del conector de SQL Database

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 Configurar reglas de firewall para habilitar el acceso al servicio de destino. El Asistente para la creación de aplicaciones ya ha protegido la base de datos SQL con un punto de conexión privado.
4. Seleccione Guardar. Espere hasta que aparezca la Actualización correcta notificación.

Step 7: Configure el conector de Redis para usar secretos de Key Vault

1. En la página Conector de servicio, active la casilla situada junto al conector de Cache for Redis y, a continuación, seleccione Editar.
2. Seleccione la pestaña Autenticación.
3. Seleccione Store Secret en Key Vault.
4. En Key Vault Connection, seleccione el key vault que creó.
5. Seleccione Siguiente: Redes.
6. Seleccione Configurar reglas de firewall para habilitar el acceso al servicio de destino.
7. Seleccione Guardar. Espere hasta que aparezca la Actualización correcta notificación.

Step 8: Compruebe la integración de Key Vault

1. En el menú izquierdo, vuelva a seleccionar Configuración > Variables de entorno > Cadenas de conexión.
2. Siguiente a AZURE_SQL_CONNECTIONSTRING, seleccione Mostrar valor. El valor debe ser @Microsoft.KeyVault(...), lo que significa que es una referencia a la bóveda de claves porque el secreto ahora se administra en la bóveda de claves.
3. Para verificar la cadena de conexión de Redis, seleccione la pestaña Configuración de la aplicación. Junto a AZURE_REDIS_CONNECTIONSTRING, seleccione Mostrar valor. El valor debe ser @Microsoft.KeyVault(...) también.

Step 1: Volver al espacio de código de GitHub de su fork de ejemplo, ejecute git pull origin starter-no-infra. Esto extrae el archivo de flujo de trabajo recién confirmado en el codespace.

Step 2 (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 la memoria caché?" Copilot puede dar una explicación sobre la clase MyDatabaseContext y cómo está configurada en Program.cs.
3. Pregunta: "En modo de producción, quiero que la aplicación use la cadena de conexión llamada AZURE_SQL_CONNECTIONSTRING para la base de datos y la configuración de la aplicación denominada AZURE_REDIS_CONNECTIONSTRING". Copilot puede proporcionar una sugerencia de código similar a la de la Opción 2: sin GitHub Copilot seguida por los pasos, e incluso decirle que realice el cambio en el archivo Program.cs.
4. Abra Program.cs en el explorador y agregue la sugerencia de código. GitHub Copilot no proporciona la misma respuesta cada vez y no siempre es correcta. 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?.

Step 2 (Opción 2: sin GitHub Copilot):

1. Abra Program.cs en el explorador.
2. Busque el código comentado (líneas 12-21) y quite los comentarios. Este código se conecta a la base de datos mediante AZURE_SQL_CONNECTIONSTRING y se conecta a Redis Cache mediante la configuración AZURE_REDIS_CONNECTIONSTRING de la aplicación.

Step 3 (Opción 1: con GitHub Copilot):

1. Abra .github/workflows/starter-no-infra_msdocs-core-sql-XYZ en el explorador. El asistente de creación de "App Service" creó este archivo.
2. Resalte el paso dotnet publish y seleccione .
3. Ask Copilot, "Instala dotnet ef y luego crea un paquete de migraciones en la misma carpeta de salida."
4. Si la sugerencia es aceptable, seleccione Aceptar. GitHub Copilot no proporciona la misma respuesta cada vez y no siempre es correcta. 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?.

Step 3 (Opción 2: sin GitHub Copilot):

1. Abra .github/workflows/starter-no-infra_msdocs-core-sql-XYZ en el explorador. El asistente de creación de App Service ha creado este archivo
2. En el paso dotnet publish, agregue un paso para instalar la herramienta Entity Framework Core con el comando dotnet tool install -g dotnet-ef --version 8.*.
3. En el nuevo paso, agregue otro paso para generar un lote de migración de base de datos en el paquete de implementación: dotnet ef migrations bundle --runtime linux-x64 -o ${{env.DOTNET_ROOT}}/myapp/migrationsbundle. El paquete de migración es un ejecutable autónomo que se puede ejecutar en el entorno de producción sin necesidad del .NET SDK. El contenedor linux de App Service solo tiene el entorno de ejecución de .NET y no el SDK de .NET.

Paso 4:

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

Step 5: Regrese a la página Centro de implementación en el portal de Azure:

1. Seleccione la pestaña 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 6: 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 en GitHub muestre un estado de Éxito. Tardará unos 5 minutos.

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

1. Seleccione Herramientas de desarrollo>SSH.
2. Seleccione Ir. (El inicio tarda unos minutos).

Paso 2: En la sesión SSH:

1. Ejecute cd /home/site/wwwroot. Aquí están todos los archivos implementados.
2. Ejecute el paquete de migración que generó el flujo de trabajo de GitHub, con el comando ./migrationsbundle -- --environment Production. Si tiene éxito, App Service se conecta con éxito a la base de datos SQL. Recuerde que --environment Production corresponde a los cambios de código realizados en Program.cs.

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: Añadir algunas tareas a la lista. Enhorabuena, está ejecutando una aplicación web en Azure App Service, con conectividad segura a Azure SQL Database.

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. Puedes ver los registros de tu aplicación, incluidos los registros de plataforma y los registros de dentro del contenedor.

Step 1: En la barra de búsqueda de la parte superior del portal de Azure:

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.