En este artículo se explica cómo agregar y configurar un catálogo para el centro de desarrollo o proyecto de Microsoft Dev Box.
Los catálogos le ayudan a proporcionar un conjunto de definiciones de imágenes seleccionadas para que los equipos de desarrollo creen cuadros de desarrollo listos para código. Puede adjuntar su propio repositorio de control de código fuente desde GitHub o Azure Repos como catálogo.
Para proteger aún más las plantillas, el catálogo se cifra; Dev Box admite el cifrado en reposo con claves de cifrado administradas por la plataforma, que administra Microsoft for Azure Services.
- Para obtener información sobre cómo hospedar un repositorio en GitHub, consulte Introducción a GitHub.
- Para obtener información sobre cómo hospedar un repositorio de Git en un proyecto de Azure Repos, consulte Azure Repos.
La asociación de catálogos en el nivel de proyecto permite a los ingenieros de plataforma proporcionar definiciones de imagen específicas para cada equipo de desarrollo. Además, permite a los líderes del equipo de desarrollo asignados como admins de proyectos administrar las definiciones de imagen que están disponibles para sus equipos.
Los ingenieros de plataforma tienen control total sobre el uso de catálogos en el nivel de proyecto. El uso de catálogos de nivel de proyecto debe habilitarse en el nivel central de desarrollo para poder agregar un catálogo a un proyecto. Los ingenieros de plataforma también pueden configurar qué tipos de elementos de catálogo, como las definiciones de imagen, se pueden consumir en el nivel de proyecto.
De forma predeterminada, el uso de catálogos en el nivel de proyecto está deshabilitado y ninguno de los tipos de elementos de catálogo está habilitado. Las definiciones de entorno de un catálogo de nivel de proyecto se sincronizan y se pueden usar en dos condiciones. En primer lugar, debe habilitar catálogos basados en proyectos en el nivel del centro de desarrollo correspondiente. En segundo lugar, debe habilitar el uso de definiciones de imagen para el proyecto.
Agregar un catálogo a un proyecto
Debe habilitar catálogos de nivel de proyecto en el nivel del centro de desarrollo para poder agregar un catálogo a un proyecto. También debe habilitar el uso de definiciones de imagen en el nivel de proyecto.
Para habilitar el uso de catálogos de nivel de proyecto en el nivel del centro de desarrollo:
En Azure Portal, vaya al centro de desarrollo.
En el menú de la izquierda, en Configuración, seleccione Configuración del Centro de desarrollo.
En Catálogos de nivel de proyecto, seleccione Habilitar catálogos por proyecto y, a continuación, seleccione Aplicar.
Para habilitar el uso de definiciones de imagen en el proyecto:
En Azure Portal, vaya al proyecto.
En el menú izquierdo, en Configuración, seleccione Catálogos.
En la página Catálogos, seleccione Permisos de elementos de catálogo.
En el panel Configuración del elemento de catálogo , seleccione Definiciones de imágenes de implementación de Azure para habilitar el uso de definiciones de imagen en el nivel de proyecto.
Ahora, puede agregar un catálogo al proyecto.
En el caso de los catálogos que usan una identidad administrada o un token de acceso personal (PAT) para la autenticación, debe asignar una identidad administrada para el proyecto. Para los catálogos que usan un PAT, debe almacenar el PAT en un almacén de claves y conceder a la identidad administrada acceso al secreto del almacén de claves.
Para poder adjuntar un catálogo a un centro o proyecto de desarrollo, debe configurar una identidad administrada, también denominada Managed Service Identity (MSI). Puede adjuntar una identidad administrada asignada por el sistema (MSI asignada por el sistema) o una identidad administrada asignada por el usuario (MSI asignada por el usuario). A continuación, asigne roles a la identidad administrada para permitir que el centro de desarrollo o el proyecto creen tipos de entorno en la suscripción y lean el proyecto de Azure Repos que contiene el repositorio de catálogos.
Si el centro de desarrollo o el proyecto no tiene un MSI asociado, siga los pasos descritos en Configuración de una identidad administrada crear una y asignar roles para la identidad administrada.
Para más información sobre las identidades administradas, consulte ¿Qué son las identidades administradas para los recursos de Azure?
Adición de un catálogo
Los catálogos se pueden agregar desde un repositorio de Azure Repos o un repositorio de GitHub. Puede optar por autenticarse mediante la asignación de permisos a un MSI o mediante un PAT, que se almacena en un almacén de claves.
Seleccione la pestaña del tipo de repositorio y la autenticación que desea usar.
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.
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.
Seleccione Configuración de la organización.
En la página Información general, seleccione Usuarios.
En la página Usuarios, seleccione Agregar usuarios.
Complete Agregar nuevos usuarios escribiendo o seleccionando la siguiente información y, a continuación, seleccione Agregar:
| Nombre |
Importancia |
| 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 entrada |
Seleccione Básico. |
| 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
Dev Box admite la asociación de repositorios de Azure Repos y repositorios 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 cuadros de desarrollo coherentes.
Los siguientes pasos le permiten adjuntar un repositorio de Azure Repos.
En el Azure Portal, vaya al centro de desarrollo o al proyecto.
En el menú de la izquierda, en Configuración del entorno, seleccione Catálogos y, luego, elija Agregar.
En Agregar catálogo, escriba la siguiente información y seleccione Agregar:
| Campo |
Importancia |
| 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. |
| Ruta de acceso de la carpeta |
Dev Box recupera una lista de carpetas de la rama. Seleccione la carpeta que almacena las plantillas de IaC. |
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.
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.
Obtenga la dirección URL de clonación del repositorio de Git de Azure Repos.
Copie y guarde la URL.
Creación de un token de acceso personal en Azure Repos
Vaya a la página principal de la colección de equipo (por ejemplo, https://contoso-web-team.visualstudio.com) y seleccione el proyecto.
Cree un PAT.
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:
Inicie sesión en Azure Portal.
En el cuadro de búsqueda, escriba Key Vault.
En la lista de resultados, seleccione Key Vault.
En la página Key Vault, seleccione Crear.
En la pestaña Crear almacén de claves, especifique la siguiente información:
| Nombre |
Importancia |
| 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. |
| Grupo de recursos |
Use un grupo de recursos existente o seleccione Crear nuevo y especifique 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.
En la pestaña Directiva de acceso, seleccione Control de acceso basado en roles de Azure y, después, seleccione Revisar y crear.
En la pestaña Revisar y crear, seleccione Crear.
Si las directivas de su organización requieren que mantenga privada la instancia de Key Vault y sin acceso desde Internet, puede crear una regla de firewall para deshabilitar o limitar el acceso público y establecer la instancia de Key Vault para permitir que los servicios de Microsoft de confianza pasen por alto la regla. Actualmente no se admiten almacenes de claves con puntos de conexión privados ni integración de vínculo privado para este escenario.
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
En el menú de la izquierda de la instancia de Key Vault, seleccione Secretos.
En la página Secretos, seleccione Generar o importar.
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.
- Selecciona Crear.
Obtención del identificador del secreto
Obtención de la ruta de acceso al secreto que creó en el almacén de claves.
En Azure Portal, vaya al almacén de claves.
En el menú de la izquierda de la página del almacén de claves, seleccione Secretos.
En la página Secretos, seleccione el secreto que ha creado anteriormente.
En la página de versiones, seleccione la VERSIÓN ACTUAL.
En la página de la versión actual, en el Identificador secreto, seleccione Copiar.
Adición del repositorio como catálogo
En el Azure Portal, vaya al centro de desarrollo o al proyecto.
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.
En el menú de la izquierda, en Configuración del entorno, seleccione Catálogos y, luego, elija Agregar.
En Agregar catálogo, escriba la siguiente información y seleccione Agregar:
| Campo |
Importancia |
| 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. |
| Ruta de acceso de 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 Dev Box recupera la versión más reciente del secreto de la bóveda 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 |
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:
- Instalación y configuración de la aplicación del Centro de desarrollo de Microsoft
- Asigne permisos en GitHub para los repositorios.
- Agregue el repositorio como catálogo.
Instalación de la aplicación del Centro de desarrollo de Microsoft
Inicie sesión en Azure Portal.
Vaya al centro de desarrollo o al proyecto.
En el menú de la izquierda, en Configuración del entorno, seleccione Catálogos y, luego, elija Agregar.
En el panel Agregar catálogo, escriba o seleccione lo siguiente:
| Campo |
Importancia |
| Nombre |
Escriba un nombre para el catálogo. |
| Origen del catálogo |
Seleccione GitHub. |
| Tipo de autenticación |
Seleccione Aplicación de GitHub. |
Para instalar la aplicación del Centro de desarrollo de Microsoft, seleccione Configurar los repositorios.
Si se le pide, autentíquese en GitHub.
En la página Centro de desarrollo de Microsoft, seleccione Configurar.
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.
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.
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
Vuelva a Azure Portal.
En Agregar catálogo, escriba la siguiente información y seleccione Agregar:
| Campo |
Importancia |
| Repo |
Seleccione el repositorio que quiera agregar como catálogo. |
| Rama |
Seleccione la rama. |
| Ruta de acceso de la carpeta |
Seleccione la carpeta que contiene subcarpetas que contienen las definiciones de imagen. |
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
Vaya a la página principal del repositorio de GitHub que contiene las definiciones de plantilla.
Obtenga la dirección URL de clonación de un repositorio de GitHub.
Copie y guarde la URL.
Creación un token de acceso personal en GitHub
Dev Box 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.
Vaya a la página principal del repositorio de GitHub que contiene las definiciones de plantilla.
En la esquina superior derecha de GitHub, seleccione la imagen del perfil y, después, seleccione Configuración.
En la barra lateral izquierda, seleccione Configuración de desarrollador>Tokens de acceso personal>Tokens específicos.
Seleccione Generar nuevo token.
En la página Nuevo token de acceso personal específico, especifique la siguiente información:
| Nombre |
Importancia |
| 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 al repositorio |
Seleccione Solo repositorios. |
| Seleccionar repositorios |
Seleccione el repositorio que contiene las definiciones de imagen. |
| Permisos del repositorio |
Expanda Permisos del repositorio y en Contenido, en la lista Acceso, seleccione Lectura de código. |
Seleccione Generar token.
Copie y guarde el token generado para usarlo más adelante.
Importante
Si utiliza un repositorio privado almacenado en una organización de GitHub, debe asegurarse de que el token de acceso personal de GitHub está configurado para conceder acceso a la organización correcta y a los repositorios que contiene.
- Los tokens clásicos de la organización deben tener autorización para el inicio de sesión único en la organización concreta después de crearlos.
- Los tokens específicos deben tener el propietario del token establecido como la propia organización que se va a autorizar.
Los tokens de acceso de red configurados incorrectamente pueden generar el error Repositorio no encontrado.
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:
Inicie sesión en Azure Portal.
En el cuadro de búsqueda, escriba key vault.
En la lista de resultados, seleccione Key Vault.
En la página Key Vault, seleccione Crear.
En la pestaña Crear almacén de claves, especifique la siguiente información:
| Nombre |
Importancia |
| 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. |
| Grupo de recursos |
Use un grupo de recursos existente o seleccione Crear nuevo y especifique 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.
En la pestaña Directiva de acceso, seleccione Control de acceso basado en roles de Azure y, después, seleccione Revisar y crear.
En la pestaña Revisar y crear, seleccione Crear.
Si las directivas de su organización requieren que mantenga privada la instancia de Key Vault y sin acceso desde Internet, puede crear una regla de firewall para deshabilitar o limitar el acceso público y establecer la instancia de Key Vault para permitir que los servicios de Microsoft de confianza pasen por alto la regla. Actualmente no se admiten almacenes de claves con puntos de conexión privados ni integración de vínculo privado para este escenario.
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
En el menú de la izquierda de la instancia de Key Vault, seleccione Secretos.
En la página Secretos, seleccione Generar o importar.
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.
- Selecciona Crear.
Obtención del identificador del secreto
Obtención de la ruta de acceso al secreto que creó en el almacén de claves.
En Azure Portal, vaya al almacén de claves.
En el menú de la izquierda de la página del almacén de claves, seleccione Secretos.
En la página Secretos, seleccione el secreto que ha creado anteriormente.
En la página de versiones, seleccione la VERSIÓN ACTUAL.
En la página de la versión actual, en el Identificador secreto, seleccione Copiar.
Adición del repositorio como catálogo
En el Azure Portal, vaya al centro de desarrollo o al proyecto.
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.
En el menú de la izquierda, en Configuración del entorno, seleccione Catálogos y, luego, elija Agregar.
En Agregar catálogo, escriba la siguiente información y seleccione Agregar.
| Campo |
Importancia |
| 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 |
| Ruta de acceso de la carpeta |
Escriba la ruta de acceso de carpeta relativa al URI de clonación que contiene subcarpetas con los elementos de catálogo.
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.
Eliminar el identificador de versión asegura que Dev Box obtenga la versión más reciente del secreto de la bóveda 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 |
En Catálogos, compruebe que aparece el catálogo. Si la conexión se realiza correctamente, el estado se muestra como Sincronización correcta.
Ver elementos de catálogo sincronizados
Independientemente del tipo de repositorio que use, puede ver los elementos de catálogo que se sincronizan desde el catálogo.
En el menú izquierdo del centro de desarrollo o proyecto, en Configuración del entorno, seleccione Catálogos.
En el panel Catálogos, seleccione el nombre del catálogo.
Verá una lista de elementos de catálogo sincronizados correctamente.
Actualización de un catálogo
Si actualiza la definición o el contenido de la plantilla en el repositorio adjunto, puede proporcionar el conjunto más reciente de definiciones de imágenes a los equipos de desarrollo mediante la sincronización del catálogo. Puede sincronizar un catálogo de forma manual o automática.
Sincronizar manualmente un catálogo
Al sincronizar manualmente un catálogo, Dev Box examina el repositorio y hace que la lista más reciente de definiciones de imágenes esté disponible para todos los proyectos asociados en el centro de desarrollo.
En el menú izquierdo del centro de desarrollo, en Configuración del entorno, seleccione Catálogos.
Seleccione el catálogo específico y, a continuación, en la barra de comandos, seleccione Sincronizar.
Sincronizar automáticamente un catálogo
Al configurar un catálogo para que se sincronice automáticamente, Dev Box examina el repositorio cada 30 minutos y hace que la lista más reciente de definiciones de imágenes esté disponible para todos los proyectos asociados en el centro de desarrollo.
En el menú izquierdo del centro de desarrollo o proyecto, en Configuración del entorno, seleccione Catálogos.
Seleccione el catálogo específico y, a continuación, seleccione Editar.
En el panel Editar catálogo, seleccione Sincronizar automáticamente este catálogo y, a continuación, seleccione Guardar.
Si se produce un error en una sincronización automática, debe realizar una sincronización manual. Dev Box no realiza ningún intento de sincronización automática adicional hasta que una sincronización manual se realiza correctamente.
Eliminación de un catálogo
Puede eliminar un catálogo para quitarlo del centro de desarrollo o del proyecto de Dev Box. Las plantillas de un catálogo eliminado no están disponibles para los equipos de desarrollo cuando implementan nuevos cuadros de desarrollo. Actualice la referencia de definición de entorno para los cuadros de desarrollo existentes que se crearon mediante las definiciones de imagen del catálogo eliminado. Si la referencia no se actualiza y se vuelve a implementar el entorno, se produce un error en la implementación.
Para eliminar un catálogo:
En el menú izquierdo del centro de desarrollo o proyecto, en Configuración del entorno, seleccione Catálogos.
Seleccione el catálogo específico y seleccione Eliminar.
En el cuadro de diálogo Eliminar catálogo, seleccione Continuar para eliminar el catálogo.
Solución de errores de sincronización de catálogos
Al agregar o sincronizar un catálogo, es posible que encuentre un error de sincronización o una advertencia. Un error de sincronización indica que un catálogo no se pudo sincronizar correctamente, una advertencia de sincronización indica que algunos o todos los elementos del catálogo tienen errores. Puede ver el estado y los errores de sincronización en Azure Portal, o bien usar la CLI de Azure y la API de REST para solucionar y resolver los errores.
Visualización del estado de sincronización del catálogo
En Azure Portal, puede obtener más información sobre el estado de sincronización del catálogo y las advertencias o errores seleccionando el vínculo de estado. El vínculo de estado abre un panel que muestra el estado de sincronización, el número de definiciones de imagen que se agregaron y el número de definiciones de imagen que se ignoraron o produjeron errores.
Visualización de errores de sincronización del catálogo
En el menú izquierdo del centro de desarrollo o proyecto, en Configuración del entorno, seleccione Catálogos.
En la columna Estado, seleccione el vínculo de estado del catálogo que no se pudo sincronizar.
Verá un panel de detalles que muestra los cambios en la última sincronización, el número de errores de sincronización y el tipo de errores.
Visualización de advertencias de sincronización de catálogos
En el menú izquierdo del centro de desarrollo o proyecto, en Configuración del entorno, seleccione Catálogos.
En la columna Estado, seleccione el vínculo de estado del catálogo que se sincronice, pero notifique una advertencia.
Verá un panel de detalles que muestra los cambios en la última sincronización, el número de errores de elemento y el tipo y el origen de cada error.
Puede ver los elementos que se han sincronizado correctamente desde un catálogo que también notifica errores de sincronización. En el panel Catálogos, seleccione el nombre del catálogo.
Verá una lista de elementos de catálogo sincronizados correctamente.
Solución de errores de sincronización de catálogos mediante la CLI de Azure
Use la CLI de Azure o la API REST para obtener el catálogo. La respuesta de GET muestra el tipo de error:
- Se ignoraron las definiciones de imagen que fueron detectadas como duplicadas.
- Definiciones de imagen no válidas que no se pudieron realizar debido a errores de esquema, referencia o validación.
Resolución de errores de definición de entorno omitidos
Se produce un error de definición de entorno omitido si agrega dos o más definiciones de imagen que tienen el mismo nombre. Puede resolver este problema cambiando el nombre de las definiciones de imagen para que cada definición de entorno tenga un nombre único en el catálogo.
Resolución de errores de definición de entorno no válida
Los errores de definición de entorno no válida puede producirse por varios motivos:
Errores de esquema de manifiesto. Asegúrese de que el archivo de entorno de la definición del entorno tenga el esquema necesario.
Errores de validación. Compruebe los siguientes elementos para resolver los errores de validación:
- Asegúrese de que el tipo de motor del archivo de entorno esté configurado correctamente.
- Asegúrese de que el nombre de la definición de entorno tenga entre 3 y 63 caracteres.
- Asegúrese de que el nombre de la definición del entorno solo incluye caracteres válidos para una dirección URL, es decir, caracteres alfanuméricos y estos símbolos:
~!,.';:=-_+()*&$@
Errores de referencia. Asegúrese de que la ruta de acceso de la plantilla a la que hace referencia el archivo de entorno es una ruta relativa válida a un archivo en el repositorio.
Contenido relacionado
