Adición de repositorios privados en Cloud Manager private-repositories

Obtenga información sobre cómo configurar Cloud Manager para que funcione con sus propios repositorios privados de GitHub.

Información general overview

La configuración de Cloud Manager con sus repositorios privados de GitHub le permite validar código directamente en GitHub, lo que elimina la necesidad de sincronizarse con el repositorio de Adobe con frecuencia.

NOTE
Esta funcionalidad es exclusiva de GitHub público. La compatibilidad con GitHub autoalojado no está disponible.

Configuración configuration

La configuración consta de dos pasos principales:

Añadir un repositorio add-repo

  1. En Cloud Manager, en la página Resumen del programa, haga clic en la pestaña Repositorios para cambiar a la pestaña Repositorios y haga clic en Añadir repositorio.

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

  3. Proporcione los detalles del repositorio

    • Nombre del repositorio: un nombre expresivo
    • URL del repositorio: la URL de este, que debe finalizar en .git
    • Descripción (opcional): una descripción más larga del repositorio según sea necesario

    Añadir su propio repositorio

  4. Haga clic en Guardar.

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 validate-ownership

Cloud Manager ahora conoce su repositorio de GitHub, pero aún necesita acceso. Para otorgar acceso, debe instalar la aplicación de GitHub de Adobe y comprobar que es el propietario del repositorio especificado.

  1. Después de añadir su propio repositorio, se abre el cuadro de diálogo Validación de propiedad de repositorio privado.

    Validación de propiedad de repositorio privado

  2. Cloud Manager utiliza una aplicación de GitHub para interactuar de forma segura con el repositorio.

    Un propietario de su organización de GitHub debe instalar la aplicación ubicada en https://github.com/apps/cloud-manager-for-aem y otorgar acceso al repositorio. Consulte la documentación de GitHub para obtener más detalles.

  3. Para mejorar la seguridad, cree un archivo secreto en la rama predeterminada del repositorio. Haga clic en Generar.

  4. Confirme la generación del archivo secreto pulsando o haciendo clic en Confirmar.

    Confirmar generación de secreto

  5. De nuevo en el cuadro de diálogo Validación de propiedad de repositorio privado, Cloud Manager ha generado el contenido del archivo privado en el campo Contenido de archivo secreto. Copie el contenido de dicho campo.

    El contenido del archivo secreto solo se mostrará una vez. Si no copia el contenido antes de cerrar esta ventana, deberá volver a generar el secreto.

    Copiar contenido de archivo secreto

  6. Cree un nuevo archivo en la rama predeterminada de su repositorio de GitHub denominado .well-known/adobe/cloud-manager-challenge y pegue el contenido del archivo secreto en ese archivo y guárdelo.

  7. Una vez que la aplicación está instalada y el archivo secreto existe en el repositorio, puede hacer clic en Validar en el diálogo Validación de propiedad de repositorio privado.

La aplicación se puede instalar y puede generar 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 todavía no se puede utilizar.

Repositorio no validado

Tenga en cuenta que la columna Tipo identifica fácilmente los repositorios proporcionados por Adobe (Adobe) y sus propios repositorios de GitHub (GitHub).

Para volver al repositorio más tarde y completar la validación, vaya a la página Repositorios. Haga clic en el botón de los tres puntos situado junto al repositorio de GitHub que ha añadido y seleccione Validación de propiedad en el menú desplegable.

Uso de repositorios privados con Cloud Manager using

Una vez validado el repositorio de GitHub en Cloud Manager, la integración se completa y puede utilizarlo con Cloud Manager.

Para usar repositorios privados 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 completen las comprobaciones 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 cierra o se combina la solicitud de extracción, la canalización de calidad del código de pila completa creada se elimina automáticamente.

TIP
Consulte el documento 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 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 con canalizaciones pipelines

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

Limitaciones limitations

Se aplican ciertas restricciones al usar repositorios privados con Cloud Manager.

  • Las canalizaciones de configuración de nivel web no son compatibles con los repositorios privados.
  • 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 GitHub de Adobe se quita de su organización de GitHub, se eliminará la función de validación de solicitudes de extracción de todos los repositorios.
  • Las canalizaciones que utilizan repositorios privados y el activador de compilación de compromiso no se inician automáticamente cuando se inserta un nuevo compromiso 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 intenta validar las solicitudes de extracción creadas para ese repositorio.
recommendation-more-help
c6cdc82b-cee9-48e0-a6ee-48149d5e72c3