Compila repositorios desde Bitbucket Cloud

Cloud Build te permite crear activadores para compilar desde repositorios alojados en Bitbucket Cloud, lo que te permite ejecutar compilaciones en respuesta a eventos como envíos de confirmación o solicitudes de combinación asociadas con tu repositorio de Bitbucket Cloud.

En esta página, se explica cómo puedes habilitar la funcionalidad del activador en una instancia de Cloud de Bitbucket. Obtén más información sobre los activadores de Cloud Build y los repositorios de Cloud Build.

Antes de comenzar

  • Habilita las API de Cloud Build and Secret Manager.

    Habilita las API

Crea un activador de Bitbucket Cloud

Sigue estos pasos para crear un activador de Bitbucket Cloud:

Console

  1. Abrir la página Activadores:

    Abrir la página Activadores

  2. Selecciona tu proyecto de Google Cloud y haz clic en Abrir.

  3. Haz clic en Crear activador.

  4. Ingresa las siguientes opciones de configuración del activador:

    • Nombre: un nombre para tu activador

    • Región: Selecciona la región del activador.

      • Si el archivo de configuración de compilación asociado con el activador especifica un grupo privado, Cloud Build lo usa para ejecutar tu compilación. En este caso, la región que especifiques en el activador debe coincidir con la región en la que creaste el grupo privado.
      • Si el archivo de configuración de compilación asociado con el activador no especifica un grupo privado, Cloud Build usa el grupo predeterminado para ejecutar la compilación en la misma región que el activador.

    • Descripción (opcional): Una descripción para tu activador

    • Evento: Selecciona el evento de repositorio que invoca al activador.

      • Enviar a una rama: Configura el activador para que inicie compilaciones a partir de las confirmaciones en una rama en particular.

      • Enviar etiqueta nueva: Configura el activador para que inicie compilaciones a partir de las confirmaciones que contengan una etiqueta específica.

      • Solicitud de extracción: Configura el activador para que inicie una compilación a partir de las confirmaciones de una solicitud de extracción.

    • Fuente: Selecciona 2a gen. como fuente.

      • Repositorio: En la lista de repositorios disponibles, selecciona el repositorio. Para conectar un repositorio nuevo, consulta Conéctate a un repositorio de Bitbucket Cloud.

      • Rama o Etiqueta: Especifica una expresión regular con la rama o el valor de la etiqueta que deben coincidir. Para obtener información acerca de la sintaxis de expresión regular aceptable, consulta Sintaxis RE2.

      • Control de comentarios: Si seleccionaste Solicitud de extracción como tu Evento, elige una de las siguientes opciones para controlar si el activador ejecuta automáticamente una compilación:

        • Obligatorio excepto para los propietarios y colaboradores: Cuando un propietario o colaborador del repositorio crea o actualiza una solicitud de extracción, el activador ejecuta las compilaciones de forma automática. Si un colaborador externo inicia la acción, las compilaciones se ejecutan solo después de que un propietario o colaborador comenta /gcbrun en la solicitud de extracción.

        • Obligatorio: Cuando un colaborador crea o actualiza una solicitud de extracción, las compilaciones se ejecutan solo después de que un propietario o colaborador comenta /gcbrun en la solicitud de extracción. Las compilaciones se ejecutan cada vez que se realiza un cambio en una solicitud de extracción.

        • No obligatoria: Cuando un colaborador crea o actualiza una solicitud de extracción, los activadores ejecutan las compilaciones de forma automática.

    • Configuración: Selecciona el archivo de configuración de compilación ubicado en tu repositorio o configura tu compilación de forma intercalada en el activador.

    • Tipo: Selecciona el tipo de configuración que usarás para la compilación.

      • Archivo de configuración de Cloud Build (YAML o JSON): Usa un archivo de configuración de compilación para la configuración.
      • Dockerfile: Usa Dockerfile para la configuración.

    • Ubicación: Especifica la ubicación de tu configuración.

      • Repositorio: Si el archivo de configuración se encuentra en el repositorio, proporciona la ubicación del archivo de configuración de compilación o el directorio Dockerfile, y un nombre para la imagen resultante. Si tu configuración es Dockerfile, de manera opcional, puedes proporcionar un tiempo de espera para la compilación. Cuando hayas proporcionado el Dockerfile y el nombre de la imagen, obtendrás una vista previa del comando docker build para tu compilación.

      • En línea: Si seleccionaste Archivo de configuración de Cloud Build (YAML o JSON) como tu opción de configuración, puedes especificar tu configuración de la compilación de forma intercalada. Haz clic en Abrir editor para escribir tu archivo de configuración de compilación en la consola de Google Cloud con la sintaxis YAML o JSON. Haz clic en Listo para guardar la configuración de tu compilación.

  5. Haz clic en Crear para crear tu activador de Bitbucket Cloud.

gcloud

Crea un activador de evento de envío de repositorio con el siguiente comando:

gcloud builds triggers create bitbucket-cloud \
    --name=TRIGGER_NAME \
    --repository=\
    projects/PROJECT_ID/locations/REGION/connections/CONNECTION_NAME/repositories/REPO_NAME \
    --branch-pattern=".*" --build-config="CONFIG_NAME" \
    --region=REGION

Aquí:

  • TRIGGER-NAME es el nombre que quieres darle al activador de compilación.
  • PROJECT_ID es tu ID del proyecto de Google Cloud.
  • REGION es la región del activador.
  • CONNECTION_NAME es el nombre de la conexión de host.
  • REPO_NAME es el nombre de tu repositorio conectado en Bitbucket Cloud.
  • CONFIG_NAME es el nombre de tu archivo de esquema de configuración.

Después de crear el activador, Cloud Build detecta todos los eventos de envío en todas las ramas. Cuando envías cualquier confirmación al repositorio, se invoca el activador. Puedes ver los resultados de la compilación en la página Historial de compilaciones.

Uso compartido de datos

Los datos que se envían a Bitbucket Cloud desde Cloud Build te ayudan a identificar los activadores por nombre y a ver los resultados de la compilación en tus repositorios de Bitbucket Cloud.

Los siguientes datos se comparten entre Cloud Build y tu host de Cloud de Bitbucket:

  • ID del proyecto de Google Cloud
  • Nombre del activador

¿Qué sigue?