En esta página, se explica cómo configurar un clúster de GKE existente con las opciones que requiere Anthos Service Mesh. Si deseas agregar clústeres de diferentes proyectos de Google Cloud a Anthos Service Mesh, estos deben estar en una nube privada virtual (VPC) compartida. Consulta Configura clústeres con una VPC compartida para obtener más información.
Antes de comenzar
Antes de comenzar a configurar un clúster, asegúrate de haber hecho lo siguiente:
- Revisar los requisitos del clúster
- Configura tu entorno para instalar las herramientas que necesites.
- Configurar tu proyecto para crear variables de entorno, habilitar las API necesarias y establecer permisos
Configura un clúster existente
Crea las siguientes variables de entorno:
Configura el nombre del clúster:
export CLUSTER_NAME=YOUR_CLUSTER_NAME
Establece
CLUSTER_LOCATION
en la zona o en la región del clúster:export CLUSTER_LOCATION=YOUR_ZONE_OR_REGION
Establece el grupo de cargas de trabajo:
export WORKLOAD_POOL=${PROJECT_ID}.svc.id.goog
Establece el ID de la malla:
export MESH_ID="proj-${FLEET_PROJECT_NUMBER}"
Establece la zona o región predeterminada para Google Cloud CLI. Si no estableces el valor predeterminado aquí, asegúrate de especificar la opción
--zone
o--region
en los comandosgcloud container clusters
de esta página.Si tienes un clúster de una sola zona, configura la predeterminada:
gcloud config set compute/zone ${CLUSTER_LOCATION}
Si tienes un clúster regional, configura la región predeterminada:
gcloud config set compute/region ${CLUSTER_LOCATION}
Sugerencia: Para facilitar la configuración del entorno de shell en lo sucesivo, puedes copiar y pegar las declaraciones
export
de cada variable de entorno a una secuencia de comandos de shell sencilla quesource
cuando inicias una shell nueva. También puedes agregar los comandos degcloud
que establecen los valores predeterminados a la secuencia de comandos. O puedes usargcloud init
para crear y activar una configuración degcloud
con nombre.Configura la etiqueta
mesh_id
en el clúster. Si el clúster tiene etiquetas existentes que deseas conservar, debes incluirlas cuando agregues la etiqueta demesh_id
.Para ver si el clúster tiene etiquetas existentes, haz lo siguiente:
gcloud container clusters describe ${CLUSTER_NAME} \ --project ${PROJECT_ID}
Busca el campo
resourceLabels
en el resultado. Cada etiqueta se almacena en una línea separada en el camporesourceLabels
, por ejemplo:resourceLabels: csm: '' env: dev release: stable
Si la etiqueta
csm
está en el resultado, no necesitas conservarla. La etiquetamesh_id
reemplaza a la etiquetacsm
.Para mayor comodidad, puedes agregar las etiquetas a una variable de entorno. A continuación, reemplaza
YOUR_EXISTING_LABELS
por una lista separada por comas de las etiquetas existentes en el clúster con el formatoKEY=VALUE
, por ejemploenv=dev,release=stable
:export EXISTING_LABELS="YOUR_EXISTING_LABELS"
Establece la etiqueta
mesh_id
:Si el clúster tiene etiquetas existentes que deseas conservar, actualiza el clúster con el
mesh_id
y las etiquetas existentes:gcloud container clusters update ${CLUSTER_NAME} \ --project ${PROJECT_ID} \ --update-labels=mesh_id=${MESH_ID},${EXISTING_LABELS}
Si el clúster no tiene ninguna etiqueta existente, actualízalo solo con la etiqueta
mesh_id
:gcloud container clusters update ${CLUSTER_NAME} \ --project=${PROJECT_ID} \ --update-labels=mesh_id=${MESH_ID}
Habilita Workload Identity:
gcloud container clusters update ${CLUSTER_NAME} \ --project=${PROJECT_ID} \ --workload-pool=${WORKLOAD_POOL}
La habilitación de Workload Identity puede tardar de 10 a 15 minutos.
Habilita Cloud Monitoring y Cloud Logging en GKE:
gcloud container clusters update ${CLUSTER_NAME} \ --project=${PROJECT_ID} \ --enable-stackdriver-kubernetes