Reto 04 - Crear un Entorno de Despliegue

< Reto Anterior - Home - Siguiente reto >

Introducción

Con la aplicación actualizada, ¡el refugio está listo para comenzar a configurar el despliegue! Han elegido usar Azure para alojar la aplicación. El sitio web se alojará en Azure Container Apps y la base de datos en Azure Cosmos DB para MongoDB.

El primer paso será asegurarte de que tienes acceso al repositorio de GitHub asignado. Este repositorio contiene toda la información necesaria para configurar y desplegar la aplicación en Azure. No necesitarás crear ni configurar el entorno por tu cuenta; simplemente tendrás permisos de lectura para acceder a la información relevante. Durante la introducción del reto, te proporcionaremos detalles sobre cómo acceder y utilizar este repositorio con la información de la cuenta de Azure que usarás. En un reto posterior, configurarás el despliegue continuo para el proyecto.

Descripción

Para este reto, crearás un GitHub workflow que utiliza un archivo Azure Bicep para configurar los recursos necesarios en Azure. Para este reto, el grupo de recursos necesario ya está establecido y puedes encontrar toda la información relevante en el repositorio de GitHub asignado. Solo necesitarás configurar una identidad de servicio para otorgar los permisos necesarios a la acción y ejecutar la acción para crear los recursos adicionales.

La Configuración como Código (CaC), o configuración como código, es un enfoque para gestionar la configuración del sistema que implica definir los ajustes de configuración en archivos o scripts legibles por máquinas. Esto permite una gestión más eficiente, automatizada y consistente de la configuración del sistema, ya que los cambios pueden realizarse y desplegarse más fácilmente y con mayor control. Con la configuración como código, los ajustes de configuración se almacenan en archivos controlados por versiones, utilizando a menudo una sintaxis declarativa como YAML, JSON o HCL. Estos archivos pueden almacenarse junto con el código de la aplicación, facilitando la gestión de todo el ciclo de vida del desarrollo del software.

Este desafío utiliza Azure Bicep, que es un lenguaje específico de dominio para definir la infraestructura de Azure. Ya se ha creado un archivo Bicep para que lo uses. El archivo Bicep:

• Crea una instancia serverless de Azure Cosmos DB para MongoDB.
• Crea los recursos para soportar una Azure Container App.
• Crea la Azure Container App con una imagen predeterminada.
• Configura la Azure Container App con la cadena de conexión para Azure Cosmos DB para MongoDB.

El archivo Bicep acepta un parámetro llamado prefixName, que debe configurarse con 5 caracteres alfanuméricos aleatorios en minúsculas. Es importante mencionar que utilicen 5 letras que puedan identificarlos, como las iniciales de su nombre, ya que compartirán el grupo con otros miembros del equipo. La idea es que cada uno realice su despliegue y, con este prefijo, puedan identificarse fácilmente.

Tips

Debes agregar en el repositorio los secretos y variables requeridos en la sección de Actions. Toda esta información la puedes encontrar en el repositorio de GitHub que te compartimos al inicio.

Secretos a agregar:

1. AZURE_CREDENTIALS: Este es un JSON que contiene las credenciales.
2. AZURE_SUBSCRIPTION: Una cadena que representa el ID de tu suscripción a Azure.

Variables a agregar:

1. AZURE_RG: Aquí encontrarás el nombre del grupo de recursos a utilizar en el repositorio. Normalmente, puedes ver el nombre de tu repositorio asignado y agregar “-rg” al final para obtener el nombre del grupo de recursos.
2. AZURE_PREFIX: Recuerda usar tus iniciales o una combinación de 5 caracteres alfanuméricos en minúsculas que te identifiquen para poder diferenciar tu proyecto.

Para agregar los secretos y variables:

1. Ve a la sección de “Secrets and Variables” en tu repositorio de GitHub.
2. Selecciona “New repository secret” o “New variable” según corresponda.
3. Introduce los valores necesarios y guarda los cambios.

Tip adicional:

• Si estás saturado, aquí puedes encontrar un ejemplo del archivo que puedes usar como referencia. Te pedimos que intentes hacerlo por ti mismo antes de utilizar el ejemplo.

Criterios de Éxito

• Demuestra que has encontrado la información del grupo de recursos en Azure para los recursos de la aplicación en el repositorio asignado.
• Demuestra que has almacenado correctamente los valores necesarios para el flujo de trabajo en el repositorio, cifrando los valores que son sensibles.
• Demuestra que has creado un nuevo GitHub workflow llamado create-azure-resources.yml con las siguientes opciones:
  • El GitHub workflow puede ser ejecutado manualmente.
  • Lee el prefijo y otros parámetros desde secretos y variables.
• Demuestra que al navegar a la URL de la Aplicación Contenedor de Azure se muestra una pantalla con el mensaje Welcome to Azure Container Apps.

Recursos de Aprendizaje

• ¿Qué es la infraestructura como código (IaC)?
• Entender las GitHub Actions
• Guía de inicio rápido: implementación de archivos de Bicep mediante Acciones de GitHub
• Ejecutar un flujo de trabajo manualmente
• GitHub Actions contexts
• Uso de secretos en Acciones de GitHub
• GitHub Actions variables
• Create Actions secrets using GitHub CLI

< Reto Anterior - Home - Siguiente reto >