Conectarse a Cloud Build

En esta página se explica cómo invocar compilaciones automáticamente desde Secure Source Manager mediante archivos de configuración de Cloud Build y un archivo YAML de activadores en tu repositorio de Secure Source Manager.

Antes de empezar

  1. Crea una instancia de Secure Source Manager.
  2. Crea un repositorio de Secure Source Manager.
  3. Configura una cuenta de servicio especificada por el usuario de Cloud Build.

Roles obligatorios

Para obtener los permisos que necesitas para conectar un repositorio de Secure Source Manager a Cloud Build, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos:

Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

Para obtener información sobre cómo conceder roles de Secure Source Manager, consulta los artículos Control de acceso con gestión de identidades y accesos y Conceder acceso a instancias a los usuarios.

Roles de cuenta de servicio obligatorios

Para crear compilaciones y obtener su estado en Cloud Build, concede los siguientes roles de Gestión de Identidades y Accesos (IAM) al agente de servicio de Secure Source Manager (service-PROJECT-NUMBER@gcp-sa-sourcemanager.iam.gserviceaccount.com):

  • Rol Editor de Cloud Build (roles/cloudbuild.builds.editor) en el proyecto en el que hayas habilitado Cloud Build.
  • Rol Usuario de cuenta de servicio (roles/iam.serviceAccountUser) en la cuenta de servicio de Cloud Build o en el proyecto con el que se creó la cuenta de servicio de Cloud Build.
  • Si el proyecto en el que has habilitado Cloud Build es diferente del proyecto en el que has habilitado Secure Source Manager, asigna el rol Consumidor de uso de servicios (roles/serviceusage.serviceUsageConsumer) en el proyecto de Cloud Build.
  • Si las compilaciones se ejecutan en grupos de trabajadores, asigna a la cuenta de servicio de Secure Source Manager el rol Usuario de WorkerPool de Cloud Build (roles/cloudbuild.workerPoolUser) en el proyecto de Cloud Build.

Para permitir que Cloud Build lea de tu repositorio de Secure Source Manager, concede a la cuenta de servicio de Cloud Build los siguientes roles de IAM:

En función de tu caso de uso, es posible que la cuenta de servicio de Cloud Build necesite funciones de IAM adicionales para ejecutar compilaciones. Por ejemplo:

Para obtener información sobre cómo conceder roles de gestión de identidades y accesos a un agente de servicio, consulta Conceder o revocar un solo rol.

Para obtener información sobre los registros de compilación, consulta Configurar registros de compilación.

Crear un archivo de configuración de compilación

Un archivo de configuración de compilación define los campos que necesita Cloud Build para llevar a cabo las tareas de compilación. Puedes escribir el archivo de configuración de la compilación con la sintaxis YAML.

Puedes crear archivos de configuración de compilación en la rama o las ramas desde las que quieras compilar.

Para crear un archivo de configuración de compilación, sigue estos pasos:

  1. En la interfaz web de Secure Source Manager, selecciona el repositorio que quieras conectar a Cloud Build.
  2. Selecciona la rama desde la que quieras compilar con Cloud Build.

  3. Crea un archivo de configuración de compilación. Para obtener información sobre cómo crear archivos de configuración de compilación, sigue las instrucciones de Crear un archivo de configuración de compilación.

  4. Confirma los cambios en la rama.

Crear un archivo de activadores

El archivo de configuración de los activadores debe crearse en la rama predeterminada de tu repositorio.

Para crear un archivo de configuración de activadores, sigue estos pasos:

  1. En tu repositorio local o en la interfaz web de Secure Source Manager, cambia a la rama predeterminada.

  2. Crea un archivo llamado .cloudbuild/triggers.yaml.