Cómo conectarse a un repositorio de GitHub

En esta página, se explica cómo conectar un repositorio de GitHub a Cloud Build. Para obtener más información sobre los repositorios de Cloud Build, consulta Repositorios de Cloud Build.

Antes de comenzar

  • Enable the Cloud Build API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  • Ten listo tu código fuente en un repositorio de GitHub.
  • Tener un Dockerfile o un archivo de configuración de Cloud Build en tu repositorio de código fuente de GitHub
  • Si es la primera vez que conectas tu repositorio a Cloud Build, asegúrate de tener permisos de administrador en él. Para obtener más información sobre los permisos de los repositorios de GitHub, consulta Niveles de permisos del repositorio para una organización.

  • Para usar los comandos de gcloud en esta página, instala Google Cloud CLI.

Conéctate a un repositorio de GitHub

Para conectar tu repositorio de GitHub a tu Cloud Build, haz lo siguiente:

  1. Abre la página Repositorios en la consola de Google Cloud .

    Abrir la página repositorios

  2. En el selector de proyectos de la barra superior, selecciona tu proyecto Google Cloud .

  3. En la parte superior de la página, selecciona la pestaña 1ª gen..

  4. Haz clic en Conectar repositorio.

    Verás el panel Conectar repositorio.

    1. En Selecciona el proveedor de administración de código fuente, selecciona GitHub App de GitHub de Cloud Build.

    2. Haz clic en Continuar.

      Es posible que se te solicite que autentiques tu conexión a GitHub o que instales la app de GitHub. Si aún no lo hiciste, completa los siguientes pasos:

      1. Si no accediste a GitHub antes, hazlo ahora.

        Aparece la página de autorización, en la que autorizas a la app de Google Cloud Build para que se conecte a Google Cloud.

        Captura de pantalla del botón autorizar

      2. Haz clic en Autorizar a Google Cloud Build a través de GoogleCloudBuild (Authorize Google Cloud Build by GoogleCloudBuild).

      3. Haz clic en Instalar Google Cloud Build.

      4. En el diálogo que aparece, selecciona tu organización o nombre de usuario de GitHub.

      5. Selecciona una de las opciones siguientes según la necesidad de tu empresa:

        • Todos los repositorios: Habilita el acceso a los repositorios de GitHub actuales y futuros con la app de Cloud Build.

        • Solo repositorios seleccionados: Usa el menú desplegable Seleccionar repositorios para habilitar solo repositorios específicos para acceder a ellos con la app de Cloud Build.

        Podrás habilitar repositorios adicionales más adelante. Si seleccionas Todos los repositorios, la app de Cloud Build tendrá autorización para acceder a todos tus repositorios. Sin embargo, debes conectar cada repositorio nuevo a través de Cloud Build siguiendo los pasos que se describen en esta sección.

      6. Haz clic en Instalar para instalar la app de Cloud Build.

        Se cerrará el diálogo y aparecerá la página Repositorios.

    3. En la sección Seleccionar repositorio, selecciona los siguientes campos:

      • Cuenta de GitHub: Es la cuenta de GitHub que se usó para instalar la app de GitHub de Cloud Build. Es posible que este campo ya esté preseleccionado.

      • Repositorio: Son los repositorios a los que deseas conectar Cloud Build.

      Si no encuentras uno o más de tus repositorios de destino, haz clic en Editar repositorios en GitHub para habilitar repositorios adicionales en la app de GitHub de Cloud Build. Luego, podrás seleccionar tu nuevo repositorio de destino en la sección Seleccionar repositorio.

    4. Una vez que hayas seleccionado tu cuenta y repositorios de GitHub, lee la renuncia de responsabilidad de consentimiento y selecciona la casilla de verificación junto a la renuncia para indicar que aceptas los términos presentados.

    5. Haz clic en Connect.

    6. (Opcional) En la sección Crear un activador, selecciona los repositorios para los que deseas crear un activador en el campo Crear un activador de muestra para estos repositorios. Una vez que hayas seleccionado tus repositorios, haz clic en Crear un activador.

    7. Haz clic en Listo.

(Opcional) Actualiza la cuenta autenticada de GitHub

Si necesitas actualizar la cuenta de GitHub asociada con tu Cuenta de Google, puedes navegar a la página Autenticar con GitHub. Es posible que debas hacerlo si notas que la página del repositorio de Cloud Build Connect indica que la app de GitHub no está instalada en ningún repositorio después de instalar la app de Cloud Build en GitHub.

¿Qué sigue?