Implementa en un clúster de Google Kubernetes Engine

En este documento, se describe cómo implementar tus aplicaciones en clústeres de Google Kubernetes Engine.

Cloud Deploy te permite implementar tus cargas de trabajo basadas en contenedores en cualquier clúster de Google Kubernetes Engine. Todas las funciones de Cloud Deploy son compatibles cuando realizas implementaciones en destinos de GKE.

Antes de comenzar

En este archivo skaffold.yaml, la sección deploy incluye kubectl, lo que indica que Skaffold se renderiza para Kubernetes (GKE) y se implementa en él. Los manifiestos que usas para esta aplicación se enumeran allí.

Crea tu configuración de destino

Cada destino se puede configurar en el archivo YAML de la canalización de entrega o puede estar en un archivo separado. Además, puedes configurar más de un destino en el mismo archivo, pero deben estar en diferentes secciones kind: Target.

Los objetivos deben definirse en el mismo proyecto y región que la canalización de entrega. Sin embargo, los clústeres en los que se implementan los objetivos pueden estar en diferentes proyectos y regiones, siempre que la cuenta de servicio tenga acceso a esos proyectos.

En la definición de destino, crea una sección gke para que apunte al clúster de GKE:

gke:
 cluster: projects/[project_name]/locations/[location]/clusters/[cluster_name]

Este identificador de recursos de GKE usa los siguientes elementos:

  • [project_name] es el nombre del Google Cloud proyecto en el que ejecutas este clúster.

    No es necesario que el clúster en el que realizas la implementación esté en el mismo proyecto que tu canalización de entrega.

  • [location] es la región en la que se creó el clúster.

  • [cluster_name] es el nombre que se le dio al clúster cuando se creó.

    Puedes encontrar este nombre en la lista de clústeres de tu proyecto, en la Google Cloud consola.

    Lista de clústeres en la consola de Google Cloud

A continuación, se muestra un ejemplo de configuración de destino que apunta a un clúster de GKE:

      apiVersion: deploy.cloud.google.com/v1
      kind: Target
      metadata:
       name: dev
      description: development cluster
      gke:
       cluster: projects/my-app/locations/us-central1/clusters/my-app-dev-cluster

Crea tu configuración de Skaffold

En esta sección, se proporciona y explica un ejemplo de una configuración simple de Skaffold para usar cuando se realiza la implementación en un clúster de GKE.

El siguiente es un ejemplo de un archivo skaffold.yaml para la implementación en un clúster de GKE:

apiVersion: skaffold/v4beta7
kind: Config
metadata:
  name: gke-application
manifests:
  rawYaml:
  - deployment.yaml
deploy:
  kubectl: {}

En Usa Skaffold con Cloud Deploy , se describe con más detalle cómo usar Skaffold con tu canalización de entrega.

Prepara tus manifiestos de Kubernetes

Para implementar tu aplicación en GKE, debes proporcionar a Cloud Deploy uno o más manifiestos de Kubernetes, que se renderizan y, luego, se aplican al clúster o los clústeres de destino para implementar tu aplicación.

Si no tienes esos manifiestos, créalos antes de intentar realizar la implementación con una canalización de entrega de Cloud Deploy.

Puedes usar Kustomize o Helm para ayudarte a crear manifiestos. También puedes usar Kustomize o Helm si tus manifiestos están basados en plantillas y deben renderizarse.

Revisión general

Ahora que tienes tus manifiestos de Kubernetes, tu configuración de skaffold.yaml, y tus definiciones de destino de Cloud Deploy, y registraste tus destinos como recursos de Cloud Deploy, puedes invocar tu canalización de entrega para crear una versión y hacer que avance por la progresión de destinos definidos en la canalización.

Realiza la implementación con un proxy

Puedes especificar un proxy para tu clúster de GKE de destino. Esto es para las organizaciones que están configuradas para acceder a sus clústeres solo a través de un proxy HTTP.

Para ello, agrega una propiedad proxyUrl a la sección gke en la configuración de destino:

gke:
 cluster: projects/my-app/locations/us-central1/clusters/my-app-dev-cluster
 proxyUrl: [URL]

En el ejemplo anterior, URL es la URL del proxy.

Realiza la implementación en un clúster privado

Puedes implementar tu aplicación en un clúster de GKE privado con una de las siguientes tres opciones:

Usa un extremo de DNS

Esta es la forma más sencilla de conectarse a un clúster privado.

  1. Habilita el extremo basado en DNS en tu clúster.

  2. Configura dnsEndpoint como true en gke en la configuración de destino.

    Si tu clúster no tiene configurado un extremo basado en IP, puedes omitir este paso. Cloud Deploy se conectará al extremo de DNS de forma predeterminada, ya que es el único extremo del plano de control.

Usa una red de nube privada virtual

Puedes configurar un destino para realizar la implementación en un clúster de GKE privado conectado a una red de nube privada virtual:

  1. Crea tu clúster privado.

    Un clúster privado es un clúster nativo de la VPC cuyos nodos y Pods están aislados de forma predeterminada de Internet público.

    Si planeas usar la IP interna del destino del clúster privado, configura internalIp como true en gke en la configuración de destino.

  2. En Cloud Build, crea un grupo de trabajadores privados que puedas usar para realizar la implementación en este clúster privado.

  3. Configura el entorno de ejecución para usar ese grupo privado.

    Debes usar este grupo para RENDER. También puedes usarlo para DEPLOY y VERIFY. A continuación, se muestra un ejemplo que usa RENDER y DEPLOY:

    executionConfigs:
- usages:
  - RENDER
  - DEPLOY
  workerPool: "projects/p123/locations/us-central1/workerPools/wp123"

Consulta Acceder a clústeres privados de GKE con grupos privados de Cloud Build para obtener más información.

Consideraciones sobre el proyecto y los permisos

Puedes configurar un destino para usar un grupo de trabajadores privados que pueda realizar la implementación en un clúster privado. Sin embargo, hay algunas cosas que debes tener en cuenta si los recursos están en proyectos diferentes.

  • Cuando Cloud Deploy y el grupo de trabajadores están en proyectos diferentes

Para comunicarse con un grupo privado que tenga acceso a una VPC y que esté en un proyecto diferente de tu objetivo, el agente de servicio de implementación de Cloud Deploy necesita permisos suficientes para comunicarse con ese proyecto.

La cuenta de servicio de ejecución también necesita permisos para acceder al bucket de Cloud Storage.

  • Cuando el grupo de trabajadores y el clúster están en proyectos diferentes

Si el clúster de GKE privado está en un proyecto diferente de el grupo de trabajadores privados, la cuenta de servicio de ejecución requiere permisos suficientes para comunicarse con el proyecto en el que se encuentra el clúster.

Usa destinos de clústeres conectados de GKE y Connect Gateway

Puedes configurar un destino para realizar la implementación en un clúster de GKE privado con destinos que usen clústeres conectados de GKE y Connect Gateway.

Este enfoque no requiere que uses una nube privada virtual ni conexiones de red privada virtual.

¿Qué sigue?