En esta página, se explica cómo puedes habilitar la funcionalidad del activador en un instancia de Bitbucket Cloud. Obtén más información sobre Activadores de Cloud Build y Repositorios de Cloud Build.
Antes de comenzar
-
Enable the Cloud Build and Secret Manager APIs.
- Sigue las instrucciones para conectar un host de Bitbucket Cloud.
- Sigue las instrucciones que se indican en Conéctate a un repositorio de Bitbucket Cloud.
Crea un activador de Bitbucket Cloud
Sigue estos pasos para crear un activador de Bitbucket Cloud:
Console
Abrir la página Activadores:
Selecciona tu proyecto de Google Cloud y haz clic en Abrir.
Haz clic en Crear activador.
Ingresa las siguientes opciones de configuración del activador:
Nombre: un nombre para tu activador
Región: Selecciona la región para el activador.
- Si el archivo de configuración de compilación asociado con el activador especifica un grupo privado, Cloud Build 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 la configuración para ejecutar tu compilación en la misma región como detonante.
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. de las confirmaciones en una solicitud de extracción.
Fuente: Selecciona 2a gen. como la fuente.
Repositorio: En la lista de repositorios disponibles, selecciona el en un repositorio de confianza. Para conectar un repositorio nuevo, consulta Cómo conectarse 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 Evento, elige una de las siguientes opciones para controlar si el activador ejecutará automáticamente una compilación:
Obligatorio excepto para los propietarios y colaboradores: Cuando se realiza una extracción una solicitud la crea o actualiza un propietario o colaborador del repositorio, el activador ejecuta automáticamente las compilaciones correspondientes. Si un proveedor de el colaborador inicia la acción, las compilaciones se ejecutan solo después un propietario o colaborador comenta
/gcbrun
en la solicitud de extracción.Obligatorio: Cuando cualquier persona crea o actualiza una solicitud de extracción Contributor, las compilaciones se ejecutan solo después de que un propietario el colaborador comenta
/gcbrun
en la solicitud de extracción. Compilaciones se ejecutan cada vez que se realiza un cambio en una solicitud de extracción.No obligatorio: Cuando cualquier persona crea o actualiza una solicitud de extracción, colaborador, los activadores ejecutan automáticamente las compilaciones.
Configuración: Selecciona el archivo de configuración de compilación ubicado en tu repositorio o configurar tu compilación intercalada en el desencadenante.
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 tu archivo de configuración se encuentra en tu repositorio, proporciona la ubicación de tu archivo de configuración de compilación o el directorio
Dockerfile
y un nombre para la imagen resultante. Si tu configuración esDockerfile
. De manera opcional, puedes proporcionar un tiempo de espera para tu compilación. Cuando proporciones elDockerfile
y el nombre de la imagen, verás una vista previa del comandodocker 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 de YAML o JSON. Haz clic en Listo para guardar la configuración de tu compilación.
Haz clic en Crear para crear tu activador de Bitbucket Cloud.
gcloud
Crea un activador de eventos 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 asignarle a tu activador de compilación.
- PROJECT_ID es tu ID del proyecto de Cloud.
- REGION es la región del activador.
- CONNECTION_NAME es el nombre de tu conexión de host.
- REPO_NAME es el nombre de tu repositorio conectado. en Bitbucket Cloud.
- CONFIG_NAME es el nombre de tu esquema de configuración. .
Después de que se crea el activador, Cloud Build escucha todos los eventos de envío en todas las ramas. Cuando envías una confirmación al repositorio, el activador se invocan. Puedes consulta los resultados de 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 ver los resultados de la compilación en tus repositorios de Bitbucket Cloud.
Los siguientes datos se comparten entre Cloud Build y tu Bitbucket Host en la nube:
- ID del proyecto de Google Cloud
- Nombre del activador
¿Qué sigue?
- Obtén más información sobre cómo crear y administrar activadores.
- Obtén más información para iniciar compilaciones de forma manual.
- Aprende a ver resultados de compilación.
- Aprende a realizar implementaciones azul-verde en Compute Engine.