Implementación continua desde Git mediante Cloud Build

Puedes usar Cloud Build para automatizar las implementaciones y compilaciones en Knative serving con el activador de Cloud Build para 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.

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 Knative serving.

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 buildpacks de Google Cloud: Go, Node.js, Python, Java o .NET Core.

• Enable the Cloud Build and Cloud Source Repositories APIs.

  Enable the APIs

Configura la implementación continua desde la interfaz de usuario de Knative serving

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. Ve a Knative serving en la consola de Google Cloud:

   Ir a Knative serving

2. Haz clic en Crear servicio.

3. Completa la Configuración del servicio (Service settings) con tus preferencias.

4. Haz clic en Siguiente.

5. Selecciona Continuously deploy new revisions from a source repository.

   

6. Haz clic en Configuración con Cloud Build (Set up with Cloud Build).

7. Selecciona el proveedor y el repositorio.

   • GitHub: Si aún no estás autenticado, haz clic en Autenticar y sigue las instrucciones. De forma predeterminada, la conexión de un repositorio se realiza a través de la app de GitHub de Cloud Build. Como alternativa, puedes duplicar el repositorio de GitHub en Cloud Source Repositories. Para hacerlo, haz clic en Opciones avanzadas (Advanced options) y marca Duplicar el repositorio de GitHub con Cloud Source Repositories. Más información
   • Bitbucket: Si aún no estás autenticado, haz clic en Autenticar y sigue las instrucciones.
   • Cloud Source Repositories

   

8. Haz clic en Siguiente (Next).

9. 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.

   

10. Haz clic en Guardar (Save).

11. Verifica la configuración seleccionada.

    

12. Haz clic en Crear (Create).

13. 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.

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

    • Botón Edit Continuous Deployment
    • Historial de compilaciones
    • Detalles de la fuente en la sección Revision Details.

Servicio existente

1. Ve a Knative serving en la consola de Google Cloud:

   Ir a Knative serving

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

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

4. Selecciona el proveedor y el repositorio.

   • GitHub: Si aún no estás autenticado, haz clic en Autenticar y sigue las instrucciones. De forma predeterminada, la conexión de un repositorio se realiza a través de la app de GitHub de Cloud Build. Como alternativa, puedes duplicar el repositorio de GitHub en Cloud Source Repositories. Para hacerlo, haz clic en Opciones avanzadas (Advanced options) y marca Duplicar el repositorio de GitHub con Cloud Source Repositories. Más información
   • Bitbucket: Si aún no estás autenticado, haz clic en Autenticar y sigue las instrucciones.
   • Cloud Source Repositories

   

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.

   

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:

   • Botón Edit Continuous Deployment
   • Historial de compilaciones
   • Detalles de la fuente en la sección Revision Details.

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 Knative serving.

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.