Adición de un repositorio privado de GitHub en Cloud Manager private-repositories

Si configura Cloud Manager para que se integre con el repositorio privado de GitHub alojado en github.com, podrá validar su código directamente en GitHub mediante Cloud Manager. Esta página se aplica a cualquier repositorio alojado en github.com, independientemente del plan de GitHub (Gratis, Pro, Equipo o Enterprise Cloud). Esta configuración elimina el requisito de sincronizar el código regularmente con el repositorio de Adobe.

IMPORTANT
Cloud Manager valida la propiedad del repositorio de GitHub de una de las dos maneras siguientes, según dónde esté alojado el repositorio:
  • Esta página se aplica a cualquier repositorio alojado en github.com, independientemente del plan de GitHub (Gratis, Pro, Equipo o Enterprise Cloud). Estos repositorios utilizan la aplicación de Adobe GitHub para validar la propiedad. No se requiere ninguna configuración de gancho web, ya que Cloud Manager se integra directamente a través de la aplicación.

  • Si desea agregar cualquiera de los siguientes tipos de repositorios, consulte Agregar repositorios externos en Cloud Manager. Estos repositorios utilizan un PAT (token de acceso personal) y un webhook configurado manualmente para validar la propiedad.

    • Repositorios de GitHub Enterprise Server (versión autoalojada de GitHub).
    • Repositorios de GitLab (tanto gitlab.com como la versión autoalojada de GitLab).
    • Repositorios de bitbucket (solo bitbucket.org, versión en la nube). La versión autoalojada de Bitbucket dejó de usarse el 15 de febrero de 2024.
    • Repositorios de DevOps de Azure (dev.azure.com).

Configuración configuration

La configuración de un repositorio privado de GitHub en Cloud Manager consta de dos pasos:

Añadir un repositorio privado de GitHub a un programa add-repo

  1. Inicie sesión en Cloud Manager en my.cloudmanager.adobe.com y seleccione la organización adecuada.

  2. En la consola Mis programas, seleccione el programa al que desea vincular un repositorio Git privado.

  3. En el menú lateral, en Servicios, seleccione Icono de carpeta Repositorios.

    La página Repositorios

  4. Cerca de la esquina superior derecha de la página Repositorios, haga clic en Añadir repositorio.

  5. En el diálogo Añadir repositorio, seleccione Repositorio privado como el tipo de repositorio.

    Añadir su propio repositorio

  6. En cada campo respectivo, proporcione los siguientes detalles sobre el repositorio:

    table 0-row-2 1-row-2 2-row-2 3-row-2
    Campo Descripción
    Nombre del repositorio Un nombre expresivo para el nuevo repositorio.
    URL del repositorio La dirección URL del repositorio privado, que debe finalizar en .git.
    Por ejemplo, https://github.com/org-name/repo-name.git (la ruta de la dirección URL es sólo con fines ilustrativos).
    Descripción (opcional) Breve descripción del repositorio.
  7. Seleccione Guardar.
    Ahora puede validar la propiedad del repositorio privado.

TIP
Para obtener más información sobre la administración de repositorios en Cloud Manager, consulte el documento Repositorios de Cloud Manager.

Validar la propiedad de un repositorio privado de GitHub validate-ownership

Cloud Manager ahora está configurado con el repositorio de GitHub, pero aún requiere autorización para acceder al repositorio. Para otorgar acceso, debe instalar la aplicación de GitHub de Adobe y comprobar que es el propietario del repositorio especificado.

Para validar la propiedad de un repositorio privado de GitHub:

  1. Después de agregar el repositorio, siga los pasos restantes del cuadro de diálogo Validación de propiedad del repositorio privado.

    Validación de propiedad de repositorio privado

    table 0-row-2 1-row-2 2-row-2
    Descripción
    Paso 1: Aplicación GitHub Cloud Manager usa una aplicación de GitHub para interactuar con su repositorio privado de forma segura.
    · Un propietario de su organización de GitHub debe instalar la aplicación ubicada en https://github.com/apps/cloud-manager-for-aem y conceder acceso al repositorio.
    · Para obtener más información sobre cómo instalar y conceder acceso, consulte la documentación de GitHub.
    Paso 2: Archivo Secreto Para mejorar la seguridad, debe crear un archivo secreto en la rama predeterminada del repositorio.
    · Haga clic en Generar y luego haga clic en Confirmar. Cloud Manager genera el contenido del archivo privado en el campo de texto Contenido de archivo secreto.
    · Haga clic en Icono de copiar para copiar el contenido de ese campo. El contenido del archivo secreto solo se mostrará una vez. Si no copia el contenido antes de cerrar este cuadro de diálogo, vuelva a generar el secreto.
  2. Cree un nuevo archivo en la rama predeterminada del repositorio de GitHub con el nombre

    .well-known/adobe/cloud-manager-challenge

  3. Pegue el contenido del archivo secreto en el nuevo archivo y guarde.

    Una vez que la aplicación esté instalada y el archivo secreto exista en el repositorio, continúe con los pasos.

  4. En el cuadro de diálogo Validación de propiedad de repositorio privado, haga clic en Validar.

La aplicación se puede instalar y se puede crear un archivo secreto en cualquier orden. Sin embargo, ambos pasos deben completarse antes de poder validar.

Hasta la validación, el repositorio se muestra con un icono rojo que indica que aún no se ha validado y que no está disponible para su uso.

Repositorio no validado

La columna Tipo de la tabla de la página Repositorios identifica los repositorios proporcionados por Adobe (Adobe) y sus propios repositorios privados (GitHub).

Para acceder al repositorio más tarde y completar la validación, en la página Repositorios, haga clic en Icono de más en la fila que representa el repositorio de GitHub que agregó. En la lista desplegable, seleccione Validación de propiedad.

Uso de repositorios privados de GitHub con Cloud Manager using

Una vez validado el repositorio de GitHub en Cloud Manager, la integración se completa. Puede utilizar el repositorio con Cloud Manager.

Para usar repositorios privados de GitHub con Cloud Manager:

  1. Al crear una solicitud de extracción, se inicia automáticamente una comprobación de GitHub.

    Comprobaciones de GitHub

  2. Para cada solicitud de extracción, se crea automáticamente una canalización de calidad de código de pila completa. Esta canalización se inicia en cada actualización de solicitud de extracción.

  3. La comprobación de GitHub permanece en estado de ejecución hasta que se complete la comprobación de calidad del código. Los resultados de calidad del código se propagan a la comprobación de GitHub.

    Comprobaciones de calidad del código de GitHub

Cuando se combina o cierra la solicitud de extracción, la canalización de calidad del código de pila completa creada se elimina automáticamente.

TIP
Consulte Anotaciones de comprobación de GitHub para obtener más información sobre la información proporcionada a través de GitHub cuando se ejecutan las comprobaciones de solicitudes de extracción.
TIP
Puede controlar las canalizaciones que se crean automáticamente para validar cada solicitud de extracción en un repositorio privado. Consulte el documento Configuración de comprobación de GitHub para repositorios privados para obtener más información.

Asociación de repositorios privados de GitHub con canalizaciones pipelines

Los repositorios privados validados se pueden asociar a canalizaciones de pila completa y front-end.

Limitaciones limitations

Al utilizar repositorios privados con Cloud Manager, se aplican las siguientes limitaciones.

  • No se creará ni insertará ninguna etiqueta de Git al utilizar repositorios privados en canalizaciones de producción de pila completa.
  • Si la aplicación de Adobe GitHub se elimina de su organización de GitHub, se elimina la función de validación de solicitudes de extracción de todos los repositorios.
  • Las canalizaciones que utilizan repositorios privados de GitHub y el déclencheur de compilación “en la confirmación” no se inician automáticamente cuando se inserta una nueva confirmación en la rama seleccionada.
  • La funcionalidad de reutilización de artefactos no se aplica a repositorios privados.
  • No se puede pausar la validación de la solicitud de extracción mediante la comprobación de GitHub desde Cloud Manager. Si el repositorio de GitHub se valida en Cloud Manager, Cloud Manager siempre intenta validar las solicitudes de extracción creadas para ese repositorio.
  • Si su organización de GitHub aplica restricciones de IP, abra un caso de asistencia para obtener la lista de direcciones IP que deben permitirse.
recommendation-more-help
experience-manager-cloud-service-help-main-toc