Implementación continua desde Git mediante Cloud Build

Puedes usar Cloud Build para automatizar las implementaciones y compilaciones en Cloud Run mediante el activador de Cloud Build a fin de compilar e implementar tu código de forma automática cada vez que se envíen confirmaciones nuevas a una rama específica de un repositorio de Git. Para ver un ejemplo de explicación sobre cómo crear un repositorio de plantillas y cómo implementar de forma continua desde Git, consulta la Guía de inicio rápido de implementación continua.

Cuando usas un activador de Cloud Build para compilar contenedores, la información del repositorio de código fuente se muestra en la consola de Google Cloud para tu servicio después de la implementación en Cloud Run.

Antes de comenzar

  • Tienes un repositorio de Git con un Dockerfile o tu base de código está escrita en uno de los lenguajes compatibles con los paquetes de compilación de Google Cloud.
  • Habilita las API de Cloud Build y Cloud Source Repositories.

    Habilita las API

Configura la implementación continua desde la interfaz de usuario de Cloud Run

El procedimiento varía un poco en función de si configuras la implementación continua en un servicio nuevo o en uno existente. Haz clic en la pestaña correspondiente para obtener más información.

Servicio nuevo

  1. Crea un servicio nuevo como se describe en Implementa un servicio nuevo y asegúrate de seleccionar Implementar revisiones nuevas de forma continua desde un repositorio de código fuente en Configuración de servicios.

  2. En la página Configuración del servicio, haz clic en Configurar con Cloud Build.

  3. GitHub es el proveedor de repositorios predeterminado. Si aún no estás autenticado, haz clic en Autenticar y sigue las instrucciones. La conexión de un repositorio se realiza con la app de GitHub de Cloud Build.

    Paso 1 de Configura la implementación continua

  4. Haz clic en Siguiente (Next).

  5. Completa las opciones del paso Configuración de compilación (Build Configuration):

    • Rama (Branch): Indica qué fuente se debe usar cuando se ejecuta el activador. Puedes ingresar la regex aquí. Las ramas coincidentes se verifican de forma automática, y puedes verlas debajo de la entrada. Ten en cuenta que si solo coincide una rama, el activador se ejecutará de manera automática después de la creación.
    • Build Type

      • Si el repositorio se debe compilar con Docker y contiene un Dockerfile, selecciona Dockerfile. En Ubicación de origen (Source location), se indica la ubicación y el nombre del Dockerfile. El directorio se usará como el contexto de compilación de Docker. Todas las rutas de acceso deben estar relacionadas con el directorio actual.

      • De lo contrario, selecciona Google Cloud Buildpacks. Usa Buildpack context para especificar el directorio y Entrypoint (opcional) a fin de proporcionar el comando que inicia el servidor. Por ejemplo, gunicorn -p :8080 main:app para Python, java -jar target/myjar.jar para Java. Déjalo en blanco para usar el comportamiento predeterminado.

    Paso 2 de Configura la implementación continua

  6. Haz clic en Guardar (Save).

  7. Verifica la configuración seleccionada.

    Verificación de la configuración de la implementación continua

  8. Haz clic en Crear (Create).

  9. Ten en cuenta que se te redireccionará a la página Detalles del servicio, en la que podrás realizar un seguimiento del progreso de la configuración de la implementación continua.

  10. Una vez que hayas completado todos los pasos, ten en cuenta las opciones adicionales:

Servicio existente

  1. Ir a Cloud Run

  2. Ubica el servicio en la lista de servicios y haz clic en él.

  3. Haz clic en Configura la implementación continua.

  4. GitHub es el proveedor de repositorios predeterminado. Si aún no estás autenticado, haz clic en Autenticar y sigue las instrucciones. La conexión de un repositorio se realiza con la app de GitHub de Cloud Build.

    Paso 1 de Configura la implementación continua

  5. Haz clic en Siguiente (Next).

  6. Completa las opciones del paso Configuración de compilación (Build Configuration):

    • Rama (Branch): Indica qué fuente se debe usar cuando se ejecuta el activador. Puedes ingresar la regex aquí. Las ramas coincidentes se verifican de forma automática, y puedes verlas debajo de la entrada. Ten en cuenta que si solo coincide una rama, el activador se ejecutará de manera automática después de la creación.
    • Build Type

      • Si el repositorio se debe compilar con Docker y contiene un Dockerfile, selecciona Dockerfile. En Ubicación de origen (Source location), se indica la ubicación y el nombre del Dockerfile. El directorio se usará como el contexto de compilación de Docker. Todas las rutas de acceso deben estar relacionadas con el directorio actual.

      • De lo contrario, selecciona Google Cloud Buildpacks. Usa Buildpack context para especificar el directorio y Entrypoint (opcional) a fin de proporcionar el comando que inicia el servidor. Por ejemplo, gunicorn -p :8080 main:app para Python, java -jar target/myjar.jar para Java. Déjalo en blanco para usar el comportamiento predeterminado.

    Paso 2 de Configura la implementación continua

  7. Haz clic en Guardar (Save).

  8. La página se vuelve a cargar y se muestra el progreso de la configuración de la implementación continua.

  9. Una vez que hayas completado todos los pasos, ten en cuenta las opciones adicionales:

Configura la implementación continua de forma manual

Consulta Configura la implementación continua de forma manual si necesitas usar un procedimiento manual y no la IU.

Adjunta el activador de Cloud Build existente al servicio de Cloud Run

Si ya tienes un activador de Cloud Build existente, puedes vincularlo al servicio y aprovechar las funciones de la consola de Google Cloud de la página Detalles del servicio: el botón Editar implementación continua y el gráfico Historial de compilaciones.

Para hacerlo, debes agregar una etiqueta con gcb-trigger-id como clave y el identificador único del activador de Cloud Build como valor (no el nombre del activador). Consulta estas instrucciones para configurar la etiqueta.