Requisitos previos de Cloud Service Mesh

En esta página, se describen los requisitos para instalar Cloud Service Mesh, como la licencia 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 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 eres suscriptor de GKE Enterprise, de todas formas puedes instalar Cloud Service Mesh, pero algunos elementos y funciones de la IU en la consola de Google Cloud solo están disponibles para suscriptores de GKE Enterprise. Si deseas obtener información sobre lo que está disponible para suscriptores y no suscriptores, consulta las diferencias de IU de GKE Enterprise y Cloud Service Mesh.

• Si habilitaste la API de GKE Enterprise, pero deseas 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 on AWS, Amazon EKS o Microsoft AKS, debes ser cliente de GKE Enterprise. A los clientes de GKE Enterprise no se les factura por separado por Cloud Service Mesh porque ya está incluido 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 una 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 . 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 en 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.

• No se admite Cloud Service Mesh para las cargas de trabajo de Windows Server. Si tu clúster tiene grupos de nodos de Linux y Windows Server, aún 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 certificados de credenciales.

Fuera de Google Cloud

• Asegúrate de que el clúster de usuario en el que instalas 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 reglas HTTP/HTTPS y DNS para alcanzar 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 las cargas 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 poder usar Cloud Service Mesh. Otros clústeres del proyecto de un clúster de Cloud Service Mesh no se deben registrar en una flota diferente.

• GKE: (se aplica a Cloud Service Mesh en el clúster y administrado) 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 Cloud Service Mesh en el clúster) GKE on VMware, GKE on Bare Metal, GKE on AWS y GKE on 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 automáticamente Workload Identity de la flota 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 Cloud Service Mesh 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 tu clúster a fin de verificar si existe un proveedor y crear 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