Adición y configuración de un catálogo desde GitHub o Azure Repos

Para agregar un catálogo, realice las tareas que se indican a continuación:

• Asigne permisos en Azure Repos para la identidad administrada.
• Agregue el repositorio como catálogo.

Asigne permisos en Azure Repos para la identidad administrada

Debe conceder permisos de identidad administrada al repositorio en Azure Repos.

1. Inicie sesión en su organización de Azure DevOps.

   Nota:

   La organización de Azure DevOps debe estar en el mismo directorio que la suscripción de Azure que contiene el centro de desarrollo o el proyecto.

2. Seleccione Configuración de la organización.

   

3. En la página Información general, seleccione Usuarios.

   

4. En la página Usuarios, seleccione Agregar usuarios.

   

5. Complete Agregar nuevos usuarios escribiendo o seleccionando la siguiente información y, a continuación, seleccione Agregar:

   NOMBRE	Valor
   Usuarios o entidades de servicio	Escriba el nombre del centro de desarrollo o el proyecto. Cuando se usa una MSI asignada por el sistema, especifique el nombre del centro de desarrollo o el proyecto, no el identificador de objeto de la cuenta administrada. Cuando use una MSI asignada por el usuario, use el nombre de la cuenta administrada.
   Nivel de acceso	Seleccione Básica.
   Agregar a proyectos	Seleccione el proyecto que contenga el repositorio.
   Grupos de Azure DevOps	Seleccione Lectores del proyecto.
   Enviar invitaciones por correo electrónico (solo a usuarios)	Desactive la casilla.

   

Adición del repositorio como catálogo

Azure Deployment Environments admite la asociación de repositorios de Azure Repos y de GitHub. Puede almacenar un conjunto de plantillas de IaC seleccionadas en un repositorio. La asociación del repositorio a un centro de desarrollo o proyecto como catálogo proporciona a los equipos de desarrollo acceso a las plantillas y les permite crear rápidamente entornos coherentes.

Los siguientes pasos le permiten adjuntar un repositorio de Azure Repos.

1. En el Azure Portal, vaya al centro de desarrollo o al proyecto.

2. En el menú de la izquierda, en Configuración del entorno, seleccione Catálogos y, luego, elija Agregar.

   

3. En Agregar catálogo, escriba la siguiente información y seleccione Agregar:

   Campo	Valor
   Nombre	Escriba un nombre para el catálogo.
   Ubicación del catálogo	Seleccione Azure DevOps.
   Tipo de autenticación	Seleccione Identidad administrada.
   Organización	Seleccione la organización de Azure DevOps.
   Proyecto	De la lista de proyectos, seleccione el proyecto que almacena el repositorio.
   Repo	De la lista de repositorios, seleccione el repositorio que desee agregar.
   Rama	Seleccione la rama.
   Folder path (Ruta de acceso a la carpeta)	Dev Box recupera una lista de carpetas de la rama. Seleccione la carpeta que almacena las plantillas de IaC.

   

4. En catálogos para el centro de desarrollo o el proyecto, compruebe que aparece el catálogo. Si la conexión se realiza correctamente, el estado se muestra como Sincronización correcta. La conexión a un catálogo podría tardar unos minutos la primera vez.

Para agregar un catálogo, realice las tareas que se indican a continuación:

• Obtenga la dirección URL de clonación de un repositorio de Azure Repos.
• Cree un token de acceso personal (PAT).
• Almacene el PAT como un secreto del almacén de claves en Azure Key Vault.
• Agregue el repositorio como catálogo.

Obtenga la dirección URL de clonación de un repositorio de Azure Repos.

1. Vaya a la página principal de la colección de equipo (por ejemplo, https://contoso-web-team.visualstudio.com) y, después, seleccione el proyecto.

2. Obtenga la dirección URL de clonación del repositorio de Git de Azure Repos.

3. Copie y guarde la URL.

Creación de un token de acceso personal en Azure Repos

1. Vaya a la página principal de la colección de equipo (por ejemplo, https://contoso-web-team.visualstudio.com) y seleccione el proyecto.

2. Cree un PAT.

3. Copie y guarde el token generado para usarlo más adelante.

Creación de un almacén de claves

Necesita una instancia de Azure Key Vault para almacenar el PAT utilizado para otorgar acceso a Azure a su repositorio. Los almacenes de claves pueden controlar el acceso mediante directivas de acceso o control de acceso basado en roles (RBAC). Si tiene un almacén de claves existente, puede usarlo, pero debe comprobar si usa directivas de acceso o asignaciones de RBAC para controlar el acceso. Para obtener ayuda sobre la configuración de una directiva de acceso para un almacén de claves, consulte Asignar una directiva de acceso a un almacén de claves.

Siga estos pasos para crear un almacén de claves de RBAC:

1. Inicie sesión en Azure Portal.

2. En el cuadro de búsqueda, escriba Key Vault.

3. En la lista de resultados, seleccione Key Vault.

4. En la página Key Vault, seleccione Crear.

5. En la pestaña Crear almacén de claves, especifique la siguiente información:

   Nombre	Valor
   Nombre	Escriba un nombre para el almacén de claves.
   Suscripción	Seleccione la suscripción en la que quiere crear el almacén de claves.
   Grupos de recursos	Use un grupo de recursos existente o seleccione Crear nuevo y escriba un nombre para el grupo de recursos.
   Ubicación	Seleccione la ubicación o región en la que quiere crear el almacén de claves.

   Deje las demás opciones con sus valores predeterminados.

6. En la pestaña Directiva de acceso, seleccione Control de acceso basado en roles de Azure y, después, seleccione Revisar y crear.

7. En la pestaña Revisar y crear, seleccione Crear.

Si las directivas de su organización requieren que mantenga la instancia de Key Vault privada de Internet, puede establecer Key Vault para permitir que los servicios de Microsoft de confianza omitan la regla de firewall.

Para saber cómo permitir que los servicios de confianza de Microsoft eviten el firewall, consulte Configuración de red de Azure Key Vault.

Almacenamiento del token de acceso personal en el almacén de claves

1. En el menú de la izquierda de la instancia de Key Vault, seleccione Secretos.

2. En la página Secretos, seleccione Generar o importar.

3. En la página Crear un secreto, haga lo siguiente:

   • En el cuadro Nombre, escriba un nombre descriptivo para el secreto.
   • En el cuadro Valor de secreto, pegue el PAT que copió anteriormente.
   • Seleccione Crear.

Obtención del identificador del secreto

Obtención de la ruta de acceso al secreto que creó en el almacén de claves.

1. En Azure Portal, vaya al almacén de claves.

2. En el menú de la izquierda de la página del almacén de claves, seleccione Secretos.

3. En la página Secretos, seleccione el secreto que ha creado anteriormente.

4. En la página de versiones, seleccione la VERSIÓN ACTUAL.

5. En la página de la versión actual, en el Identificador secreto, seleccione Copiar.

Adición del repositorio como catálogo

1. En el Azure Portal, vaya al centro de desarrollo o al proyecto.

2. Asegúrese de que la identidad adjunta al centro de desarrollo o proyecto tiene acceso al secreto del almacén de claves donde se almacena su token de acceso personal.

3. En el menú de la izquierda, en Configuración del entorno, seleccione Catálogos y, luego, elija Agregar.

4. En Agregar catálogo, escriba la siguiente información y seleccione Agregar:

   Campo	Valor
   Nombre	Escriba un nombre para el catálogo.
   Ubicación del catálogo	Seleccione Azure DevOps.
   Tipo de autenticación	Seleccione Token de acceso personal.
   Organización	Seleccione la organización que hospeda el repositorio de catálogos.
   Proyecto	Seleccione el proyecto que almacena el repositorio de catálogos.
   Repositorio	Seleccione el repositorio que almacena el catálogo.
   Folder path (Ruta de acceso a la carpeta)	Seleccione la carpeta que hospeda las plantillas de IaC.
   Identificador secreto	Escriba el identificador del secreto que contiene el token de acceso personal del repositorio. Al copiar un identificador secreto, la cadena de conexión incluye un identificador de versión al final, como en este ejemplo: https://contoso-kv.vault.azure.net/secrets/GitHub-repo-pat/9376b432b72441a1b9e795695708ea5a. Al quitar el identificador de versión, se garantiza que los entornos de implementación capturan la versión más reciente del secreto del almacén de claves. Si su PAT expira, solo debe actualizarse el almacén de claves. Identificador secreto de ejemplo: https://contoso-kv.vault.azure.net/secrets/GitHub-repo-pat

   

5. En Catálogos, compruebe que aparece el catálogo. Si la conexión se realiza correctamente, el valor de Estado será Conectado.

Para agregar un catálogo, realice las tareas que se indican a continuación:

1. Instalación y configuración de la aplicación del Centro de desarrollo de Microsoft
2. Asigne permisos en GitHub para los repositorios.
3. Agregue el repositorio como catálogo.

Instalación de la aplicación del Centro de desarrollo de Microsoft

1. Inicie sesión en Azure Portal.

2. Vaya al centro de desarrollo o al proyecto.

3. En el menú de la izquierda, en Configuración del entorno, seleccione Catálogos y, luego, elija Agregar.

4. En el panel Agregar catálogo, escriba o seleccione lo siguiente:

   Campo	Valor
   Nombre	Escriba un nombre para el catálogo.
   Origen del catálogo	Seleccione GitHub.
   Tipo de autenticación	Seleccione Aplicación de GitHub.

5. Para instalar la aplicación del Centro de desarrollo de Microsoft, seleccione Configurar los repositorios.

   

6. Si se le pide, autentíquese en GitHub.

7. En la página Centro de desarrollo de Microsoft, seleccione Configurar.

   

8. Seleccione la organización de GitHub que contenga el repositorio que quiera agregar como catálogo. Para poder instalar esta aplicación, la organización debe ser de su propiedad.

   

9. En la página Instalar Centro de desarrollo de Microsoft, seleccione Solo determinados repositorios y después el repositorio que quiera agregar como catálogo. A continuación, seleccione Instalar.

   

   Puede seleccionar varios repositorios para agregarlos como catálogos. Debe agregar cada repositorio como catálogo independiente, tal y como se describe en Agregar el repositorio como un catálogo.

10. En la página Microsoft quiere permiso para: del Centro de desarrollo de Microsoft, revise los permisos necesarios y, a continuación, seleccione Autorizar el Centro de desarrollo de Microsoft.

    

Adición del repositorio como catálogo

1. Vuelva a Azure Portal.

2. En Agregar catálogo, escriba la siguiente información y seleccione Agregar:

   Campo	Value
   Repo	Seleccione el repositorio que quiera agregar como catálogo.
   Rama	Seleccione la rama.
   Folder path (Ruta de acceso a la carpeta)	Seleccione la carpeta que contenga las subcarpetas con las definiciones de entorno.

   

3. En Catálogos, compruebe que aparece el catálogo. Si la conexión se realiza correctamente, el estado se muestra como Sincronización correcta.

   

Para agregar un catálogo, realice las tareas que se indican a continuación:

• Obtenga la dirección URL de clonación de un repositorio de GitHub.
• Cree un token de acceso personal (PAT) en GitHub.
• Almacene el PAT como un secreto del almacén de claves en Azure Key Vault.
• Agregue el repositorio como catálogo.

Obtención de la dirección URL de clonación de un repositorio de GitHub

1. Vaya a la página principal del repositorio de GitHub que contiene las definiciones de plantilla.

2. Obtenga la dirección URL de clonación de un repositorio de GitHub.

3. Copie y guarde la URL.

Creación un token de acceso personal en GitHub

Azure Deployment Environments admite la autenticación en repositorios de GitHub mediante tokens clásicos o tokens específicos. En este ejemplo, se crea un token específico.

1. Vaya a la página principal del repositorio de GitHub que contiene las definiciones de plantilla.

2. En la esquina superior derecha de GitHub, seleccione la imagen del perfil y, después, seleccione Configuración.

3. En la barra lateral izquierda, seleccione Configuración de desarrollador>Tokens de acceso personal>Tokens específicos.

4. Seleccione Generar nuevo token.

5. En la página Nuevo token de acceso personal específico, especifique la siguiente información:

   Nombre	Value
   Nombre del token	Escriba un nombre descriptivo para el token.
   Expiración	Seleccione el periodo de expiración del token en días.
   Descripción	Introduzca una descripción para el token.
   Propietario del recurso	Seleccione el propietario del repositorio.
   Acceso a los repositorios	Elige Solo seleccionar repositorios.
   Seleccionar repositorios	Seleccione el repositorio que contiene las definiciones del entorno.
   Permisos del repositorio	Expanda Permisos del repositorio y en Contenido, en la lista Acceso, seleccione Lectura de código.

   

6. Seleccione Generar token.

7. Copie y guarde el token generado para usarlo más adelante.

Creación de un almacén de claves

Necesita una instancia de Azure Key Vault para almacenar el PAT que se usa para conceder al repositorio acceso a Azure. Los almacenes de claves pueden controlar el acceso mediante directivas de acceso o control de acceso basado en roles (RBAC). Si tiene un almacén de claves existente, puede usarlo, pero debe comprobar si usa directivas de acceso o asignaciones de RBAC para controlar el acceso. Para obtener ayuda sobre la configuración de una directiva de acceso para un almacén de claves, consulte Asignación de directivas de acceso a un almacén de claves.

Siga estos pasos para crear un almacén de claves de RBAC:

1. Inicie sesión en Azure Portal.

2. En el cuadro de búsqueda, escriba key vault.

3. En la lista de resultados, seleccione Key Vault.

4. En la página Key Vault, seleccione Crear.

5. En la pestaña Crear almacén de claves, especifique la siguiente información:

   Nombre	Valor
   Nombre	Escriba un nombre para el almacén de claves.
   Suscripción	Seleccione la suscripción en la que quiere crear el almacén de claves.
   Grupos de recursos	Use un grupo de recursos existente o seleccione Crear nuevo y escriba un nombre para el grupo de recursos.
   Ubicación	Seleccione la ubicación o región en la que quiere crear el almacén de claves.

   Deje las demás opciones con sus valores predeterminados.

6. En la pestaña Directiva de acceso, seleccione Control de acceso basado en roles de Azure y, después, seleccione Revisar y crear.

7. En la pestaña Revisar y crear, seleccione Crear.

Si las directivas de su organización requieren que mantenga la instancia de Key Vault privada de Internet, puede establecer Key Vault para permitir que los servicios de Microsoft de confianza omitan la regla de firewall.

Para saber cómo permitir que los servicios de confianza de Microsoft eviten el firewall, consulte Configuración de red de Azure Key Vault.

Almacenamiento del token de acceso personal en el almacén de claves

1. En el menú de la izquierda de la instancia de Key Vault, seleccione Secretos.

2. En la página Secretos, seleccione Generar o importar.

3. En la página Crear un secreto, haga lo siguiente:

   • En el cuadro Nombre, escriba un nombre descriptivo para el secreto.
   • En el cuadro Valor del secreto, pegue el PAT.
   • Seleccione Crear.

Obtención del identificador del secreto

Obtención de la ruta de acceso al secreto que creó en el almacén de claves.

1. En Azure Portal, vaya al almacén de claves.

2. En el menú de la izquierda de la página del almacén de claves, seleccione Secretos.

3. En la página Secretos, seleccione el secreto que ha creado anteriormente.

4. En la página de versiones, seleccione la VERSIÓN ACTUAL.

5. En la página de la versión actual, en el Identificador secreto, seleccione Copiar.

Adición del repositorio como catálogo

1. En el Azure Portal, vaya al centro de desarrollo o al proyecto.

2. Asegúrese de que la identidad administrada adjunta al centro de desarrollo o proyecto tiene acceso al secreto del almacén de claves donde se almacena su token de acceso personal.

3. En el menú de la izquierda, en Configuración del entorno, seleccione Catálogos y, luego, elija Agregar.

4. En Agregar catálogo, escriba la siguiente información y seleccione Agregar.

   Campo	Valor
   Nombre	Escriba un nombre para el catálogo.
   Ubicación del catálogo	Seleccione GitHub.
   Repo	Escriba o pegue la dirección URL de clonación del repositorio de GitHub o del repositorio de Azure Repos. Ejemplo de catálogo: https://github.com/Azure/deployment-environments.git
   Rama	Escriba la rama del repositorio a la que quiere conectarse. Ejemplo de catálogo: main
   Folder path (Ruta de acceso a la carpeta)	Escriba la ruta de acceso de carpeta relativa al URI de clonación que contiene subcarpetas con las definiciones de entorno. La ruta de acceso de carpeta es para la carpeta con subcarpetas que contienen archivos de entorno de definiciones del entorno, no para la carpeta con el propio archivo de entorno de las definiciones del entorno. Esta imagen muestra la estructura de carpetas del catálogo de ejemplo. Ejemplo de catálogo: /Environments La ruta de acceso de la carpeta puede comenzar con o sin una barra diagonal (/).
   Identificador secreto	Escriba el identificador del secreto que contiene el token de acceso personal del repositorio. Al copiar un identificador secreto, la cadena de conexión incluye un identificador de versión al final, como en este ejemplo: https://contoso-kv.vault.azure.net/secrets/GitHub-repo-pat/9376b432b72441a1b9e795695708ea5a. La eliminación del identificador de versión garantiza que Deployment Environments captura la versión más reciente del secreto del almacén de claves. Si su PAT expira, solo debe actualizarse el almacén de claves. Identificador secreto de ejemplo: https://contoso-kv.vault.azure.net/secrets/GitHub-repo-pat

   

5. En Catálogos, compruebe que aparece el catálogo. Si la conexión se realiza correctamente, el estado se muestra como Sincronización correcta.