En esta página, se describe cómo configurar Google Cloud Deploy para renderizar la configuración de cada destino en una canalización de entrega.
Google Cloud Deploy usa Skaffold para renderizar tus manifiestos de Kubernetes. El servicio admite la renderización de manifiestos sin procesar y herramientas de administración de manifiestos más avanzadas, como Helm, Kustomize y kpt.
El proceso de renderización tiene dos etapas:
La herramienta de administración de manifiestos genera el manifiesto.
Skaffold sustituye las referencias de imagen en el manifiesto por las imágenes que deseas implementar en la versión.
En esta página, se incluyen ejemplos de configuración mediante Helm y Kustomize.
Usa Skaffold para generar la configuración
Si aún no tienes un archivo de configuración de Skaffold (skaffold.yaml
), puedes usar Skaffold a fin de generar uno, según lo que haya en tu repositorio.
Instala Skaffold con Google Cloud CLI:
gcloud components install skaffold
Ejecuta
skaffold init
en el repositorio que contiene tus manifiestos:skaffold init --skip-build
Este comando crea un archivo skaffold.yaml
en tu repositorio. Ese archivo hace referencia a los manifiestos en ese repositorio. El contenido se ve así:
apiVersion: skaffold/v2beta15
kind: Config
metadata:
name: sample-app
deploy:
kubectl:
manifests:
- k8s-manifests/deployment.yaml
- k8s-manifests/rbac.yaml
- k8s-manifests/redis.yaml
- k8s-manifests/service.yaml
Renderiza los manifiestos sin procesar
Los manifiestos sin renderizar son manifiestos que no se administran mediante una herramienta como Helm o Kustomize, y, por lo tanto, no necesitan ningún procesamiento previo antes de hidratarse e implementarse en un clúster.
De forma predeterminada, Google Cloud Deploy usa skaffold render
para renderizar los manifiestos de Kubernetes y reemplaza los nombres de imagen sin etiquetar por los nombres de las imágenes etiquetadas de las imágenes de contenedor que implementas. Luego, cuando asciendes la versión, Google Cloud Deploy usa skaffold apply
para aplicar los manifiestos e implementar las imágenes en tu clúster de Google Kubernetes Engine.
Una estrofa deploy
de una configuración básica se ve de la siguiente manera:
deploy:
kubectl:
manifests:
- PATH_TO_MANIFEST
Consulta la documentación de Skaffold para obtener más información sobre qué valores se pueden pasar aquí.
Renderiza mediante Helm
Puedes usar Google Cloud Deploy para procesar tus gráficos de Helm. Para hacerlo, incluye los detalles del gráfico de Helm en una estrofa deploy
de un perfil de Skaffold.
Cada definición es similar a la siguiente:
apiVersion: skaffold/v2beta16
kind: Config
deploy:
helm:
releases:
- name: RELEASE_NAME
chartPath: PATH_TO_HELM_CHART
artifactOverrides:
image: IMAGE_NAME
Donde:
RELEASE_NAME es el nombre de la instancia del gráfico de Helm para esta versión.
PATH_TO_HELM_CHART es la ruta de acceso local a un gráfico de Helm empaquetado o un directorio de gráfico de Helm sin empaquetar.
IMAGE_NAME es el nombre de la imagen de contenedor que deseas implementar.
El gráfico de Helm debe tener un parámetro de valor image
que defina la imagen que se implementará en el gráfico.
Puedes usar opciones de configuración de Helm adicionales, como se describe en la documentación de Skaffold.
Renderiza mediante Kustomize
Puedes usar Kustomize con Google Cloud Deploy. Para hacerlo, señala los archivos de Kustomization desde la estrofa deploy
en la configuración de tu perfil skaffold.yaml
.
Debes incluir una configuración de Kustomize independiente para cada objetivo para el que uses Kustomize, en cada profile
correspondiente en tu skaffold.yaml
.
Cada definición es similar a la siguiente:
apiVersion: skaffold/v2beta16
kind: Config
metadata:
name: getting-started-kustomize
deploy:
kustomize:
paths:
- PATH_TO_KUSTOMIZE
Donde:
PATH_TO_KUSTOMIZE apunta a tus archivos de Kustomization. El valor predeterminado es ["."]
.
Puedes usar opciones de configuración adicionales de Kustomize, como se describe en la documentación de Skaffold.
Configuración de manifiestos diferentes por destino
A menudo, cada objetivo necesita una configuración ligeramente diferente. Por ejemplo, es posible que tengas más réplicas en las implementaciones de producción que en las implementaciones de etapa de pruebas.
Puedes renderizar un conjunto diferente de manifiestos para cada destino si proporcionas cada variación como un perfil de Skaffold diferente.
Perfiles con manifiestos sin procesar
Cuando trabajas con manifiestos sin procesar, puedes apuntar Google Cloud Deploy a un archivo diferente, según el objetivo. Puedes configurar eso de la siguiente manera:
apiVersion: skaffold/v2beta16
kind: Config
metadata:
name: getting-started
profiles:
- name: prod
deploy:
kubectl:
manifests:
- prod.yaml
- name: staging
deploy:
kubectl:
manifests:
- staging.yaml
Perfiles con Kustomize
A continuación, se muestra un ejemplo de skaffold.yaml
que tiene diferentes perfiles para la etapa de pruebas y la producción mediante Kustomize, en el que cada perfil apunta a una Kustomization diferente:
apiVersion: skaffold/v2beta16
kind: Config
profiles:
- name: prod
deploy:
kustomize:
paths:
- environments/prod
- name: staging
deploy:
kustomize:
paths:
- environments/staging
Perfiles a los que se hace referencia en la canalización de entrega
Se hace referencia a estos perfiles, definidos en skaffold.yaml
, en la configuración de canalización de entrega, por destino:
serialPipeline:
stages:
- targetId: staging-target
profiles:
- staging
- targetId: prod-target
profiles:
- prod
¿Qué sigue?
- Obtén más información sobre la configuración de la canalización de entrega de Google Cloud Deploy.
- Prueba la explicación de los perfiles de Skaffold para Google Cloud Deploy.
- Obtén más información sobre Kustomize.
- Obtén más información sobre Helm.
- Obtén más información sobre Kpt.
- Considera usar Artifact Registry para almacenar artefactos como gráficos de Helm o Kustomizations.