Requisitos previos de Cloud Service Mesh

En esta página, se describen los requisitos para instalar Cloud Service Mesh, como las licencias de GKE Enterprise, los requisitos del clúster, los requisitos de la flota y los requisitos generales.

proyecto de Cloud

Antes de comenzar:

• Selecciona o crea un proyecto de Google Cloud.

• Verifica que la facturación esté habilitada para tu proyecto.

Licencias de GKE Enterprise

GKE

Cloud Service Mesh está disponible con GKE Enterprise o como un servicio independiente. Las API de Google se utilizan para determinar cómo se te factura. Para usar Cloud Service Mesh como un servicio independiente, no habilites la API de GKE Enterprise en tu proyecto. La secuencia de comandos habilita todas las otras asmcliAPI de Google requeridas para ti. Para obtener información sobre los precios de Cloud Service Mesh, consulta Precios.

• Los suscriptores de GKE Enterprise deben asegurarse de habilitar la API de GKE Enterprise.

Habilitar la API

• Si no estás suscrito a GKE Enterprise, aún puedes instalar Cloud Service Mesh, pero ciertos elementos y funciones de la IU de la consola de Google Cloud solo están disponibles para los suscriptores de GKE Enterprise. Si deseas obtener información sobre lo que está disponible para los suscriptores y los no suscriptores, consulta las diferencias en la IU de GKE Enterprise y Cloud Service Mesh.

• Si habilitaste la API de GKE Enterprise, pero quieres usar Cloud Service Mesh como un servicio independiente, inhabilita la API de GKE Enterprise.

Fuera de Google Cloud

Para instalar Cloud Service Mesh de forma local, en GKE en AWS, en Amazon EKS o en Microsoft AKS, debes ser cliente de GKE Enterprise. Los clientes de GKE Enterprise no reciben una factura separada por Cloud Service Mesh porque ya se incluye en los precios de GKE Enterprise. Para obtener más información, consulta la guía de precios de GKE Enterprise.

Requisitos generales

• Para que se los incluya en la malla de servicios, los puertos de servicio deben tener un nombre, y ese nombre debe incluir el protocolo del puerto en la siguiente sintaxis: name: protocol[-suffix], en la que los corchetes indican un sufijo opcional que debe comenzar con un guion. Para obtener más información, consulta Asigna nombres a puertos de servicio.

• Si creaste un perímetro de servicio en tu organización, es posible que debas agregar el servicio de autoridad certificadora de Cloud Service Mesh al perímetro. Consulta Agrega la autoridad certificadora de Cloud Service Mesh a un perímetro de servicio para obtener más información.

• Si deseas cambiar los límites de recursos predeterminados para el contenedor del archivo adicional istio-proxy, los valores nuevos deben ser mayores que los valores predeterminados a fin de evitar eventos de memoria (OOM).

• Un proyecto de Google Cloud solo puede tener una malla asociada.

Requisitos del clúster

GKE

• Verifica que la versión del clúster se enumere en las plataformas compatibles.

• El clúster de GKE debe cumplir con los siguientes requisitos:

  • El clúster de GKE debe ser estándar. Los clústeres de Autopilot solo son compatibles con Cloud Service Mesh administrado.

  • Un tipo de máquina que tenga, al menos, 4 CPU virtuales, como e2-standard-4. Si el tipo de máquina del clúster no tiene al menos 4 CPU virtuales, cámbialo como se describe en Migra cargas de trabajo a diferentes tipos de máquina.

  • La cantidad mínima de nodos depende del tipo de máquina. Cloud Service Mesh requiere al menos 8 CPU virtuales. Si el tipo de máquina tiene 4 CPU virtuales, tu clúster debe tener al menos 2 nodos. Si el tipo de máquina tiene 8 CPU virtuales, el clúster solo necesita 1 nodo. Si necesitas agregar nodos, consulta Cambia el tamaño de un clúster.

• Se requiere Workload Identity de GKE. Te recomendamos que habilites Workload Identity antes de instalar Cloud Service Mesh. Habilitar Workload Identity cambia la forma en que se protegen las llamadas de tus cargas de trabajo a las API de Google, como se describe en Limitaciones de Workload Identity. Ten en cuenta que no necesitas habilitar el Servidor de metadatos de GKE en los grupos de nodos existentes.

• Aunque es una acción opcional, se recomienda inscribir el clúster en un canal de versiones. Te recomendamos que te inscribas en el canal de versiones regular, ya que otros pueden basarse en una versión de GKE que no es compatible con Cloud Service Mesh 1.18.7. Para obtener más información, consulta Plataformas compatibles. Sigue las instrucciones en Inscribe un clúster existente en un canal de versiones si tienes una versión estática de GKE.

• Si instalas Cloud Service Mesh en un clúster privado, debes abrir el puerto 15017 en el firewall para que funcionen los webhooks que se usan para la inserción automática de sidecar y la validación de la configuración. Para obtener más información, consulta Abre un puerto en un clúster privado.

• Asegúrate de que la máquina cliente desde la que instalas Cloud Service Mesh tenga conectividad de red al servidor de la API.

• Para las cargas de trabajo de Windows Server, no se admite Cloud Service Mesh. Si tu clúster tiene grupos de nodos de Linux y Windows Server, de todas formas, puedes instalar Cloud Service Mesh y usarlo en tus cargas de trabajo de Linux.

• Después de aprovisionar Cloud Service Mesh, debes comunicarte con el equipo de asistencia antes de iniciar la rotación de IP o la rotación de credenciales de certificados.

Fuera de Google Cloud

• Asegúrate de que el clúster de usuario en el que instales Cloud Service Mesh tenga al menos 4 CPU virtuales, 15 GB de memoria y 4 nodos.

• Verifica que la versión del clúster se enumere en las plataformas compatibles.

• Asegúrate de que la máquina cliente desde la que instalas Cloud Service Mesh tenga conectividad de red al servidor de la API.

• Si implementas sidecars en pods de aplicaciones en los que la conectividad directa a los servicios de CA (como meshca.googleapis.com y privateca.googleapis.com) no está disponible; debes configurar un proxy HTTPS basado en CONNECT explicito.

• Para los clústeres públicos con reglas de firewall de salida configuradas que bloquean reglas implícitas, asegúrate de haber configurado HTTP/HTTPS y reglas DNS para llegar a las APIs públicas de Google.

Requisitos de la flota

Con Cloud Service Mesh 1.11 y versiones posteriores, todos los clústeres deben registrarse en una flota y se debe habilitar la identidad de carga de trabajo de flota. Puedes configurar los clústeres o puedes permitir que asmcli registre los clústeres siempre que cumplan con los siguientes requisitos:

Precaución: Todos los clústeres de Cloud Service Mesh de una malla deben estar registrados en la misma flota en todo momento para usar Cloud Service Mesh. Otros clústeres en el proyecto de un clúster de Cloud Service Mesh no deben estar registrados en una flota diferente.

• GKE: (se aplica a Cloud Service Mesh administrado y en el clúster) Habilita GKE Workload Identity en el clúster de Google Kubernetes Engine, si aún no está habilitado. Además, debes registrar el clúster mediante Workload Identity.

• Clústeres de GKE fuera de Google Cloud: (se aplica a la malla de servicios de Cloud en el clúster) Google Distributed Cloud, Google Distributed Cloud, GKE en AWS y GKE en Azure se registran automáticamente en tu flota de proyectos cuando se crea el clúster. A partir de GKE Enterprise 1.8, todos estos tipos de clústeres habilitan Workload Identity de forma automática cuando se registran. Los clústeres registrados existentes se actualizan para usar Workload Identity de la flota cuando se actualizan a GKE Enterprise 1.8.

• Clústeres de Amazon EKS: (se aplica a la malla de servicios de Cloud en el clúster) El clúster debe tener un proveedor de identidad de OIDC de IAM público. Sigue las instrucciones que se indican en Crea un proveedor de OIDC de IAM para el clúster para verificar si existe un proveedor y crea uno si es necesario.

Cuando ejecutas asmcli install, especificas el ID del proyecto del proyecto host de la flota. asmcli registra el clúster si aún no lo está.

NOTA: Si no registraste un clúster de un proyecto en una flota alojada en un proyecto diferente antes, se deben realizar pasos adicionales para configurar los permisos de la flota. Si deseas obtener instrucciones detalladas, consulta Otorga permisos para registrar un clúster en otro proyecto.

Próximos pasos

• Planifica una instalación nueva
• Planificar una actualización