En este documento, se describe cómo implementar tus aplicaciones, incluidos los servicios y los trabajos de Cloud Run.
Cloud Deploy te permite implementar tus cargas de trabajo basadas en contenedores en cualquier servicio o trabajo de Cloud Run. Todas las funciones de Cloud Deploy son compatibles cuando implementas en destinos de Cloud Run para servicios de Cloud Run, pero las implementaciones de versiones canary no son compatibles con trabajos de Cloud Run.
En este documento, se describen los tres parámetros de configuración principales que debes completar para implementar en Cloud Run:
- Crea tu configuración de destino
- Crea tu configuración de Skaffold
- Crea las definiciones del servicio o las definiciones de los trabajos de Cloud Run
Limitaciones
Solo puedes implementar un servicio o trabajo de Cloud Run por destino.
No puedes ejecutar una implementación de versiones canary en un trabajo de Cloud Run.
Sin embargo, los servicios de Cloud Run pueden usar una implementación de versiones canary.
Antes de comenzar
Asegúrate de usar la versión
401.0.0
o posterior de gcloud CLI.
Crea tu configuración de destino.
El destino se puede configurar en el YAML de tu canalización de entrega o puede estar en un archivo separado. Además, puedes configurar más de un destino en el mismo archivo.
En la definición de destino, crea una estrofa run
para identificar la ubicación en la que se creará el servicio de Cloud Run.
La sintaxis para especificar el servicio o trabajo de Cloud Run en la definición de destino es la siguiente:
run:
location: projects/[project_name]/locations/[region_name]
Este identificador de recursos usa los siguientes elementos:
[
project_name
] es el nombre del proyecto de Google Cloud en el que se creará tu servicio o trabajo de Cloud Run.Esto es lo que harás para cada objetivo. Recomendamos un proyecto diferente para cada servicio o trabajo de Cloud Run. Si deseas tener más de un servicio o trabajo en el mismo proyecto, debes usar los perfiles de Skaffold en el archivo de configuración
skaffold.yaml
.[
region_name
] es la región en la que se creará el servicio o el trabajo. Tu servicio o trabajo puede estar en cualquier región que admita Cloud Run.
A continuación, se muestra un ejemplo de configuración de destino en la que se define el servicio o el trabajo de Cloud Run para crear:
apiVersion: deploy.cloud.google.com/v1
kind: Target
metadata:
name: dev
description: development service
run:
location: projects/my-app/locations/us-central1
Puedes definir este destino dentro de una definición de canalización de entrega de Cloud Deploy o por separado. De cualquier manera, debes registrar el destino antes de crear la versión para implementar tu trabajo o servicio de Cloud Run.
Crea tu configuración de Skaffold
El siguiente es un archivo skaffold.yaml
de ejemplo para una implementación de Cloud Run:
apiVersion: skaffold/v4beta7
kind: Config
metadata:
name: cloud-run-application
manifests:
rawYaml:
- service.yaml
deploy:
cloudrun: {}
En este archivo skaffold.yaml
...
manifests.rawYaml
proporciona los nombres de las definiciones del servicio de Cloud Run.En este ejemplo,
service.yaml
es el archivo que define un servicio de Cloud Run que Skaffold implementará. Este nombre de archivo puede ser cualquier cosa, pero por convención esservice.yaml
para un servicio yjob.yaml
para un trabajo.La estrofa
deploy
especifica cómo deseas que se implemente el manifiesto, en particular, el proyecto y la ubicación. El campodeploy
es obligatorio.Te recomendamos que dejes el
{}
vacío. Cloud Deploy propaga esto durante la renderización en función del proyecto y la ubicación de la definición del destino.Sin embargo, para el desarrollo local, puedes proporcionar valores aquí. Sin embargo, Cloud Deploy siempre usa el proyecto y la ubicación de la definición de destino, independientemente de si los valores se proporcionan aquí.
Crea las definiciones del servicio de Cloud Run
Para crear una definición de servicio de Cloud Run, puedes crear una de forma manual o copiar una desde un servicio existente. Ambos se describen en esta sección.
Opción 1: Crea un service.yaml
nuevo de Cloud Run
El archivo service.yaml define tu servicio de Cloud Run. Cuando creas una versión, Skaffold usa esta definición para implementar tu servicio.
A continuación, se muestra un ejemplo simplificado:
apiVersion: serving.knative.dev/v1
kind: Service
metadata:
name: [SERVICE_NAME]
spec:
template:
spec:
containers:
- image: [IMAGE_PATH]
Aquí:
[SERVICE_NAME]
es un nombre para este servicio de Cloud Run.[IMAGE_PATH]
apunta a las imágenes de contenedor que implementas con este servicio.
Opción 2: Copia un service.yaml
de un servicio existente con la consola de Google Cloud
Puedes crear un servicio con la consola de Google Cloud o usar uno existente y copiar tu service.yaml
desde allí.
Para obtener el service.yaml
con Google Cloud CLI, sigue estos pasos:
gcloud run services describe [service_name] --format=export
Para obtener el service.yaml
de la consola de Google Cloud, sigue estos pasos:
En la consola de Google Cloud, ve a la página Servicios de Cloud Run.
Selecciona el servicio existente cuya definición deseas usar.
También puedes crear una cuenta nueva y, luego, seleccionarla. Cuando seleccionas el servicio, se muestra la página Detalles del servicio:
Selecciona la pestaña YAML.
Haz clic en Editar y, luego, copia el contenido del YAML en un archivo nuevo llamado
service.yaml
en tu sistema de archivos, de modo que Skaffold pueda usarlo cuando crees una versión.
Crea las definiciones de tus trabajos de Cloud Run
Para implementar una definición de trabajo de Cloud Run, puedes crear una de forma manual o copiar una desde un trabajo existente. Ambos se describen en esta sección.
Ten en cuenta que los trabajos no siempre se ejecutan cuando los implementa Cloud Deploy. Esto es diferente de los servicios, que ejecutan aplicaciones después de implementarlas. La forma en que se invoca un trabajo depende de este.
Opción 1: Crea un job.yaml
nuevo de Cloud Run
El archivo job.yaml define tu trabajo de Cloud Run. Cuando creas una versión, Skaffold usa esta definición para implementar el trabajo.
A continuación, se muestra un ejemplo simplificado:
apiVersion: run.googleapis.com/v1
kind: Job
metadata:
name: [JOB_NAME]
spec:
template:
spec:
containers:
- image: [IMAGE_PATH]
Aquí:
[JOB_NAME]
es un nombre para este trabajo de Cloud Run.[IMAGE_PATH]
apunta a la imagen del contenedor que estás implementando para este trabajo.
Opción 2: copiar un job.yaml
de un trabajo existente con la consola de Google Cloud
Puedes crear un trabajo con la consola de Google Cloud o usar uno existente y copiar tu job.yaml
desde allí.
Para obtener el job.yaml
con Google Cloud CLI, sigue estos pasos:
gcloud run jobs describe [job_name] --format=export
Para obtener el job.yaml
de la consola de Google Cloud, sigue estos pasos:
En la consola de Google Cloud, ve a la página Trabajos de Cloud Run.
Selecciona el trabajo existente cuya definición deseas usar.
También puedes crear una cuenta nueva y, luego, seleccionarla. Cuando seleccionas el trabajo, se muestra la página de detalles del trabajo:
Selecciona la pestaña YAML.
Haz clic en Editar y, luego, copia el contenido del YAML en un archivo nuevo llamado
job.yaml
en tu sistema de archivos, de modo que Skaffold pueda usarlo cuando crees una versión.
Revisión general
Ahora que tienes la definición del trabajo o servicio de Cloud Run, la configuración de skaffold.yaml
y la definición de destino de Cloud Deploy, y registraste tu destino como un recurso de Cloud Deploy, puedes invocar tu canalización de entrega para crear una versión y avanzar en el progreso de los destinos definidos en la canalización.
La guía de inicio rápido Implementa una app en Cloud Run con Cloud Deploy muestra todo esto en acción.
Comportamiento de los servicios entre revisiones
Cuando vuelves a implementar un servicio, la revisión nueva se basa en el service.yaml
recién implementado. No se mantiene nada sobre la revisión anterior, a menos que sea igual en el YAML recién implementado. Por ejemplo, si hay parámetros de configuración o etiquetas en la revisión anterior que no están en el YAML nuevo, esos parámetros o etiquetas no estarán en la revisión nueva.
Activa trabajos de Cloud Run
Después de implementar un trabajo, puedes activarlo como se describe en la documentación de Cloud Run.
Implementa servicios y trabajos de Cloud Run en varios proyectos
Si necesitas implementar servicios o trabajos que se encuentren en proyectos diferentes, tu cuenta de servicio de ejecución necesita permiso para acceder a los proyectos en los que se definen esos servicios o trabajos.
Consulta la cuenta de servicio de ejecución de Cloud Deploy y las funciones y permisos de Identity and Access Management para obtener más información.
¿Qué sigue?
Prueba la guía de inicio rápido: Implementa una aplicación en Cloud Run
Obtén más información sobre cómo configurar destinos de Cloud Deploy
Obtén más información sobre los entornos de ejecución de Cloud Deploy.
Obtén más información sobre la compatibilidad de Skaffold para Cloud Run.
Obtén más información sobre Cloud Run.