Validación del entorno de laboratorio

En la preparación para los laboratorios, es fundamental tener el entorno configurado correctamente. Esta página le guiará a través del proceso de configuración y garantiza que se cumplen todos los requisitos previos.

Este laboratorio requiere Microsoft Edge o un explorador compatible con Azure DevOps.
Configurar una suscripción de Azure: si aún no tiene una suscripción de Azure, cree una siguiendo las instrucciones de esta página o visite https://azure.microsoft.com/free para registrarse de forma gratuita.
Configurar una organización de Azure DevOps:: si aún no tiene una organización Azure DevOps que pueda usar para este laboratorio, cree una siguiendo las instrucciones disponibles en Creación de una organización o colección de proyectos.
Página de descarga de Git para Windows. Esto se instalará como parte de los requisitos previos para este laboratorio.
Visual Studio Code. Esto se instalará como parte de los requisitos previos para este laboratorio.
Azure CLI. Instale la CLI de Azure en las máquinas del agente autohospedado.

Instrucciones para crear una organización de Azure DevOps (solo tiene que hacerlo una vez)

Nota: Comience en el paso 3 si ya tiene cuenta de Microsoft configurada y una suscripción activa de Azure vinculada a esa cuenta.

Use una sesión privada del explorador para obtener una nueva cuenta de Microsoft (MSA) personal en https://account.microsoft.com.
Con la misma sesión del explorador, regístrese para obtener una suscripción gratuita de Azure en https://azure.microsoft.com/free.
Abra un explorador y vaya a Azure Portal en https://portal.azure.com y busque Azure DevOps en la parte superior de la pantalla de Azure Portal. En la página que aparece, haga clic en Organizaciones de Azure DevOps.
Después haz clic en el enlace con la etiqueta **My Azure DevOps Organizations ** o ve directamente a https://aex.dev.azure.com.
En la página Necesitamos más detalles, seleccione Continuar.
En el cuadro desplegable de la izquierda, seleccione Directorio predeterminado, en lugar de Cuenta de Microsoft.
Si se le solicita (“Necesitamos más detalles”), proporcione su nombre, dirección de correo electrónico y ubicación, y haga clic en Continuar.
De nuevo en https://aex.dev.azure.com con el directorio predeterminado seleccionado, haz clic en el botón azul Crear nueva organización.
Acepta los Términos de servicio haciendo clic en Continuar.
Si aparece un mensaje (“Casi listo”), deje el nombre de la organización de Azure DevOps de forma predeterminada (debe ser un nombre único global) y elija una ubicación de hospedaje cercana a usted en la lista.
Una vez que se abra la organización recién creada en Azure DevOps, seleccione Configuración de la organización en la esquina inferior izquierda.
En la pantalla Configuración de la organización, seleccione Facturación (abrir esta pantalla tarda unos segundos).
Seleccione Configurar facturación y, en el lado derecho de la pantalla, seleccione la suscripción de Azure y, a continuación, seleccione Guardar para vincular la suscripción con la organización.
Una vez que la pantalla muestre el identificador de suscripción de Azure vinculado en la parte superior, cambie el número de trabajos paralelos de pago de CI/CD hospedados de MS de 0 a 1. Después, haga clic en el botón Guardar de la parte inferior.
Puede esperar al menos 3 horas antes de usar las funcionalidades de CI/CD para que la nueva configuración se refleje en el back-end. De lo contrario, verá el mensaje “No se ha comprado o concedido ningún paralelismo hospedado”.

Instrucciones para crear y configurar el proyecto de Azure DevOps (solo tiene que hacerlo una vez)

Nota: Asegúrate de completar los pasos necesarios para crear la organización de Azure DevOps antes de continuar con estos pasos.

Para seguir todas las instrucciones del laboratorio, deberá configurar un nuevo proyecto de Azure DevOps, crear un repositorio basado en la aplicación eShopOnWeb y crear una conexión de servicio a la suscripción de Azure.

Creación del proyecto de equipo

En primer lugar, creará un proyecto eShopOnWeb de Azure DevOps que se usará en varios laboratorios.

Abra su explorador y navegue a su organización de Azure DevOps.
Seleccione la opción Nuevo proyecto y use la siguiente configuración:
- Nombre: eShopOnWeb
- visibilidad: Privado
- Avanzado: Control de versiones: Git
- Avanzado: Proceso de elemento de trabajo: Scrum
Seleccione Crear.

Importación del repositorio de Git de eShopOnWeb

Ahora, importará eShopOnWeb en el repositorio de Git.

Abra su explorador y navegue a su organización de Azure DevOps.
Abra el proyecto eShopOnWeb creado anteriormente.
Seleccione Repositorios > Archivos, Importar un repositorio y, después, seleccione Importar.
En la ventana Importar un repositorio de Git, pegue la siguiente dirección URL https://github.com/MicrosoftLearning/eShopOnWeb y seleccione Importar:
El repositorio se organiza de la siguiente manera:
- La carpeta .ado contiene canalizaciones de YAML de Azure DevOps.
- El contenedor de carpetas .devcontainer está configurado para realizar el desarrollo con contenedores (ya sea localmente en VS Code o GitHub Codespaces).
- La carpeta .azure contiene infraestructura de la plantilla de ARM y Bicep como plantillas de código.
- Definiciones de flujo de trabajo de GitHub del contenedor de carpetas .github.
- La carpeta src contiene el sitio web de .NET 6 que se utiliza en los escenarios de laboratorio.
Deje abierta la ventana del explorador web.

Creación de una entidad de servicio y una conexión de servicio para acceder a los recursos de Azure

A continuación, creará una entidad de servicio mediante la CLI de Azure, y una conexión de servicio en Azure DevOps que le permitirá implementar y acceder a los recursos de la suscripción de Azure.

Inicie un explorador web, vaya a Azure Portal en https://portal.azure.com, e inicie sesión con la cuenta de usuario que tenga el rol Propietario en la suscripción de Azure que va a usar en los laboratorios de este curso, así como el rol Administrador global en el inquilino de Microsoft Entra asociado a esta suscripción.
En Azure Portal, seleccione el botón Cloud Shell situado en la parte a la derecha del cuadro de búsqueda de la parte superior de la página.
Si se le pide que seleccione Bash o PowerShell, seleccione Bash.

[!NOTE] Si es la primera vez que inicia Cloud Shell y aparece el mensaje No tiene ningún almacenamiento montado, seleccione la suscripción que utiliza en este laboratorio y seleccione Crear almacenamiento.
En la solicitud de Bash, en el panel de Cloud Shell, ejecute los siguientes comandos para recuperar los valores del identificador de suscripción de Azure y los atributos de nombre de suscripción:
```
subscriptionName=$(az account show --query name --output tsv)
subscriptionId=$(az account show --query id --output tsv)
echo $subscriptionName
echo $subscriptionId
```
[!NOTE] Copie ambos valores en un archivo de texto. Los necesitará en los laboratorios de este curso.
En la solicitud de Bash, en el panel de Cloud Shell, ejecute el siguiente comando para crear una entidad de servicio:
```
az ad sp create-for-rbac --name sp-eshoponweb-azdo --role contributor --scopes /subscriptions/$subscriptionId
```
[!NOTE] El comando generará una salida JSON. Copie los resultados en un archivo de texto. Lo necesitará en breve.

[!NOTE] Registre el valor de, el nombre de la entidad de seguridad, su identificador y el identificador de inquilino incluidos en la salida JSON. Los necesitará en los laboratorios de este curso.
Vuelva a la ventana del explorador web que muestra el portal de Azure DevOps con el proyecto eShopOnWeb abierto y seleccione Configuración del proyecto en la esquina inferior izquierda del portal.
En Canalizaciones, seleccione Conexiones de servicio y, después, seleccione Crear conexión de servicio.
En la hoja New service connection (Nueva conexión de servicio), seleccione Azure Resource Manager y, después, seleccione Next (Siguiente) (es posible que deba desplazarse hacia abajo).
Seleccione Service Principal (Entidad de servicio) (manual) y, después, seleccione Next (Siguiente).
Rellene los campos vacíos con la información recopilada durante los pasos anteriores:
- Identificador y nombre de la suscripción.
- Id. de entidad de servicio (o clientId/AppId), clave de entidad de servicio (o contraseña) y TenantId.
- En Nombre de conexión de servicio, escriba azure subs. Se hará referencia a este nombre en las canalizaciones de YAML para hacer referencia a la conexión de servicio con el fin de acceder a la suscripción de Azure.
No marque Conceder permiso de acceso a todas las canalizaciones. Seleccione Verificar y guardar.

[!NOTE] No se recomienda la opción Conceder permiso de acceso a todas las canalizaciones para entornos de producción. Solo se usa en este laboratorio para simplificar la configuración de la canalización.

Ya ha completado los pasos previos necesarios para continuar con los laboratorios.