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 empezar

  • 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

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

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

Conectarse a un repositorio de GitHub

Para conectar tu repositorio de GitHub a Cloud Build, sigue estos pasos:

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

    Abre la página Repositorios.

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

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

  4. Haz clic en Conectar repositorio.

    Verá el panel Conectar repositorio.

    1. En Seleccionar proveedor de gestión de código fuente, selecciona Aplicación de GitHub para Cloud Build de GitHub.

    2. Haz clic en Continuar.

      Es posible que se te pida que autentiques tu conexión con GitHub o que instales la aplicación de GitHub. Si aún no lo has hecho, sigue estos pasos:

      1. Si no has iniciado sesión en GitHub antes, hazlo ahora.

        Aparecerá la página Autorización, donde podrás autorizar a la aplicación Google Cloud Build para que se conecte a Google Cloud.

        Captura de pantalla del botón de autorización

      2. Haz clic en Autorizar Google Cloud Build por GoogleCloudBuild.

      3. Haz clic en Instalar Google Cloud Build.

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

      5. Selecciona una de las siguientes opciones en función de las necesidades de tu empresa:

        • Todos los repositorios: habilita el acceso a los repositorios de GitHub actuales y futuros mediante la aplicación Cloud Build.

        • Seleccionar solo repositorios: usa el menú desplegable Seleccionar repositorios para habilitar solo repositorios específicos para el acceso mediante la aplicación Cloud Build.

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

      6. Haz clic en Instalar para instalar la aplicación Cloud Build.

        El cuadro de diálogo se cierra y aparece la página Repositorios.

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

      • Cuenta de GitHub: la cuenta de GitHub que se ha usado para instalar la aplicación GitHub para Cloud Build. Este campo puede estar preseleccionado.

      • Repositorio: los repositorios que quieras conectar a Cloud Build.

      Si no ves uno o varios de tus repositorios de destino, haz clic en Editar repositorios en GitHub para habilitar repositorios adicionales en la aplicación GitHub para Cloud Build. A continuación, puedes seleccionar el nuevo repositorio de destino en la sección Seleccionar repositorio.

    4. Una vez que hayas seleccionado tu cuenta de GitHub y tus repositorios, lee el aviso de consentimiento y marca la casilla situada junto a él para indicar que aceptas los términos presentados.

    5. Haz clic en Conectar.

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

    7. Haz clic en Listo.

(Opcional) Actualizar la cuenta de GitHub autenticada

Si necesitas actualizar la cuenta de GitHub asociada a tu cuenta de Google, puedes ir a la página Autenticar con GitHub. Puede que tengas que hacerlo si observas que la página Conectar repositorio de Cloud Build indica que la aplicación de GitHub no está instalada en ningún repositorio después de instalar la aplicación de Cloud Build en GitHub.

Siguientes pasos