Crear un clúster compartido para ejecutar cargas de trabajo de contenedores

En este documento se explica cómo crear un clúster de Kubernetes compartido en una zona aislada de Google Distributed Cloud (GDC). Un clúster compartido abarca varios proyectos e incluye servicios gestionados completos por GDC que ofrecen una configuración de clúster de Kubernetes muy estricta que es menos configurable que el clúster estándar. Para obtener más información sobre los clústeres estándar, consulta Configuraciones de clústeres de Kubernetes.

Los clústeres compartidos son un recurso de zona y no pueden abarcar varias zonas. Para operar clústeres en un universo multizona, debes crearlos manualmente en cada zona.

Este documento está dirigido a audiencias como desarrolladores de aplicaciones del grupo de operadores de aplicaciones, que se encargan de gestionar las cargas de trabajo de contenedores en su organización. Para obtener más información, consulta la documentación sobre las audiencias de GDC aislado.

Antes de empezar

  • Para obtener los permisos que necesitas para crear un clúster compartido, pide al administrador de la organización de gestión de identidades y accesos que te asigne el rol de administrador de clústeres de usuarios (user-cluster-admin). Este rol no está vinculado a un espacio de nombres.

  • Para usar la API o Terraform para crear un clúster compartido, genera el archivo kubeconfig del servidor de la API de zona para alojar tu clúster. Asigna la ruta de kubeconfig a la variable de entorno MANAGEMENT_API_SERVER. Para obtener más información, consulta el artículo Recursos de servidor de la API de gestión de zonas.

  • Consulta los límites del clúster para tener en cuenta los recursos.

Planificar el bloque CIDR de pods

Para asignar el bloque CIDR de pod del tamaño adecuado para tus cargas de trabajo, debes calcular la cantidad de direcciones IP que se necesitan para tu clúster de Kubernetes antes de crearlo. La mayoría de los parámetros de red no se pueden cambiar una vez creado el clúster.

Un clúster de Kubernetes sigue la siguiente lógica al asignar direcciones IP:

  • Kubernetes asigna un bloque CIDR /24 que consta de 256 direcciones a cada uno de los nodos. Esta cantidad se ajusta al máximo predeterminado de 110 pods por nodo para los clústeres de Kubernetes.
  • El tamaño del bloque CIDR asignado a un nodo depende del valor máximo de pods por nodo.
  • El bloque siempre contiene al menos el doble de direcciones que el número máximo de pods por nodo.

Consulta el siguiente ejemplo para saber cómo se ha calculado el valor predeterminado de Tamaño de máscara por nodo= /24 para alojar 110 pods:

Maximum pods per node = 110
Total number of IP addresses required = 2 * 110 = 220

Per node mask size = /24
Number of IP addresses in a /24 = 2(32 - 24) = 256

Determina la máscara CIDR de pod que se debe configurar para el clúster de Kubernetes en función del número de nodos necesarios. Planifica las futuras incorporaciones de nodos al clúster mientras configuras el intervalo CIDR:

  Total number of nodes supported = 2(Per node mask size - pod CIDR mask)

Dado que hay un valor predeterminado de Tamaño de máscara por nodo= /24, consulta la siguiente tabla, que asigna la máscara CIDR del pod al número de nodos admitidos.

Máscara CIDR de pods Cálculo: 2(Tamaño de máscara por nodo - Máscara CIDR) Número máximo de nodos admitidos, incluidos los nodos del plano de control
/21 2(24 - 21) 8
/20 2(24-20) 16
/19 2(24 - 19) 32
/18 2(24 - 18) 64

Después de calcular el bloque CIDR de pod para tu clúster de Kubernetes, configúralo como parte del flujo de trabajo de creación del clúster en la siguiente sección.

Crear un clúster compartido

Sigue estos pasos para crear un clúster de Kubernetes compartido:

Consola

  1. En el selector de proyectos, selecciona tu organización.

    Los clústeres compartidos son recursos de la organización. Si seleccionas un proyecto, crearás un clúster estándar, que se limita al proyecto. Para obtener más información, consulta la jerarquía de recursos.

  2. En el menú de navegación, selecciona Kubernetes Engine > Clústeres.

  3. Haz clic en Crear clúster.

  4. En el campo Nombre, especifica un nombre para el clúster.

  5. Selecciona la versión de Kubernetes del clúster.

  6. Selecciona la zona en la que quieres crear el clúster.

  7. Haz clic en Adjuntar proyecto y selecciona un proyecto para adjuntarlo a tu clúster. A continuación, haz clic en Guardar. Puedes vincular o desvincular proyectos después de crear el clúster desde la página de detalles del proyecto. Debes tener un proyecto asociado a tu clúster antes de desplegar cargas de trabajo de contenedores en él.

    Crea un clúster mediante la consola.

  8. Haz clic en Siguiente.

  9. Configura los ajustes de red de tu clúster. No puedes cambiar estos ajustes de red después de crear el clúster. El protocolo de Internet predeterminado y el único que se admite en los clústeres de Kubernetes es el Protocolo de Internet, versión 4 (IPv4).

    1. Si quieres crear nodos de balanceador de carga específicos, introduce el número de nodos que quieres crear. De forma predeterminada, recibes cero nodos y el tráfico del balanceador de carga pasa por los nodos de control.

    2. Selecciona el CIDR de servicio (enrutamiento de interdominios sin clases) que quieras usar. A tus servicios desplegados, como los balanceadores de carga, se les asignan direcciones IP de este intervalo.

    3. Selecciona el CIDR de pod que quieras usar. El clúster asigna direcciones IP de este intervalo a tus pods y máquinas virtuales.

    4. Haz clic en Siguiente.

  10. Revisa los detalles del grupo de nodos predeterminado generado automáticamente para el clúster. Haz clic en Editar para modificar el grupo de nodos predeterminado.

  11. Para crear más grupos de nodos, selecciona Añadir grupo de nodos. Al editar el grupo de nodos predeterminado o añadir uno nuevo, puedes personalizarlo con las siguientes opciones:

    1. Asigna un nombre al grupo de nodos. No puedes modificar el nombre después de crear el grupo de nodos.
    2. Especifica el número de nodos de trabajador que se crearán en el grupo de nodos.
    3. Selecciona la clase de máquina que mejor se adapte a los requisitos de tu carga de trabajo. Consulta la lista de los siguientes ajustes:

      • Tipo de máquina
      • CPU
      • Memoria
    4. Haz clic en Guardar.

  12. Haz clic en Crear para que se genere el clúster.

La creación de un clúster compartido puede tardar hasta 90 minutos en completarse.

API

  1. Crea el recurso personalizado Cluster:

    kubectl --kubeconfig MANAGEMENT_API_SERVER apply -f - <<EOF
    apiVersion: cluster.gdc.goog/v1
    kind: Cluster
    metadata:
      name: CLUSTER_NAME
      namespace: platform
    spec:
      clusterNetwork:
        podCIDRSize: POD_CIDR
        serviceCIDRSize: SERVICE_CIDR
      initialVersion:
        kubernetesVersion: KUBERNETES_VERSION
      nodePools:
      - machineTypeName: MACHINE_TYPE
        name: NODE_POOL_NAME
        nodeCount: NUMBER_OF_WORKER_NODES
        taints: TAINTS
        labels: LABELS
        acceleratorOptions:
          gpuPartitionScheme: GPU_PARTITION_SCHEME
      releaseChannel:
        channel: UNSPECIFIED
    EOF
    

    Haz los cambios siguientes:

    • MANAGEMENT_API_SERVER: ruta de kubeconfig del servidor de la API de zona.
    • CLUSTER_NAME: el nombre del clúster. El nombre del clúster no puede terminar con -system. El sufijo -system está reservado para los clústeres creados por GDC.
    • POD_CIDR: el tamaño de los intervalos de red desde los que se asignan las direcciones IP virtuales de los pods. Si no se define, se usará el valor predeterminado 21.
    • SERVICE_CIDR: el tamaño de los intervalos de red desde los que se asignan las direcciones IP virtuales de servicio. Si no se define, se usará el valor predeterminado 23.
    • KUBERNETES_VERSION: la versión de Kubernetes del clúster, como 1.26.5-gke.2100. Para ver la lista de versiones de Kubernetes disponibles que puedes configurar, consulta Mostrar las versiones de Kubernetes disponibles para un clúster.
    • MACHINE_TYPE: el tipo de máquina de los nodos de trabajador del grupo de nodos. Consulta los tipos de máquinas disponibles para saber qué puedes configurar.
    • NODE_POOL_NAME: el nombre del grupo de nodos.
    • NUMBER_OF_WORKER_NODES: el número de nodos de trabajador que se aprovisionarán en el grupo de nodos.
    • TAINTS: las restricciones que se aplicarán a los nodos de este grupo de nodos. Se trata de un campo opcional.
    • LABELS: las etiquetas que se aplicarán a los nodos de este grupo de nodos. Contiene una lista de pares clave-valor. Se trata de un campo opcional.
    • GPU_PARTITION_SCHEME: el esquema de partición de GPU, si ejecutas cargas de trabajo de GPU. Se trata de un campo opcional. Por ejemplo, mixed-2. La GPU no se particiona si no se define este campo. Para obtener más información sobre los perfiles de GPU con multiinstancia (MIG) disponibles, consulta Perfiles de MIG admitidos.

    La creación de un clúster compartido puede tardar hasta 90 minutos en completarse.

  2. Crea el recurso personalizado ProjectBinding:

    kubectl --kubeconfig MANAGEMENT_API_SERVER apply -f - <<EOF
    apiVersion: resourcemanager.gdc.goog/v1
    kind: ProjectBinding
    metadata:
      name: CLUSTER_NAME-PROJECT_NAME
      namespace: platform
      labels:
        resourcemanager.gdc.goog/projectbinding-for-user-project: "true"
    spec:
      clusterRef:
        name: CLUSTER_NAME
      selector:
        nameSelector:
          matchNames:
          - PROJECT_NAME
    EOF
    

    Haz los cambios siguientes:

    • MANAGEMENT_API_SERVER: ruta de kubeconfig del servidor de la API de zona.
    • CLUSTER_NAME: el nombre del clúster.
    • PROJECT_NAME: el nombre del proyecto al que se vinculará. Cada recurso de ProjectBinding solo se puede asignar a un clúster. Si un proyecto requiere acceso a varios clústeres, se debe crear un ProjectBinding único para cada clúster.

    Debes adjuntar un proyecto a tu clúster para que un desarrollador pueda desplegar cargas de trabajo de contenedores en el clúster.

Terraform

  1. En un archivo de configuración de Terraform, inserta el siguiente fragmento de código para crear el recurso personalizado Cluster:

    provider "kubernetes" {
      config_path = "MANAGEMENT_API_SERVER"
    }
    
    resource "kubernetes_manifest" "CLUSTER_RESOURCE_NAME" {
      manifest = {
        "apiVersion" = "cluster.gdc.goog/v1"
        "kind" = "Cluster"
        "metadata" = {
          "name" = "CLUSTER_NAME"
          "namespace" = "platform"
        }
        "spec" = {
          "clusterNetwork" = {
            "podCIDRSize" = "POD_CIDR"
            "serviceCIDRSize" = "SERVICE_CIDR"
          }
          "initialVersion" = {
            "kubernetesVersion" = "KUBERNETES_VERSION"
          }
          "nodePools" = [{
            "machineTypeName" = "MACHINE_TYPE"
            "name" = "NODE_POOL_NAME"
            "nodeCount" = "NUMBER_OF_WORKER_NODES"
            "taints" = "TAINTS"
            "labels" = "LABELS"
            "acceleratorOptions" = {
              "gpuPartitionScheme" = "GPU_PARTITION_SCHEME"
            }
          }]
          "releaseChannel" = {
            "channel" = "UNSPECIFIED"
          }
        }
      }
    }
    

    Haz los cambios siguientes:

    • MANAGEMENT_API_SERVER: ruta de kubeconfig del servidor de la API de zona.
    • CLUSTER_RESOURCE_NAME: el nombre único del recurso de Terraform del clúster, como cluster-1. Terraform usa este nombre para identificar tu clúster, pero GDC no lo usa.
    • CLUSTER_NAME: el nombre del clúster. El nombre del clúster no puede terminar con -system. El sufijo -system está reservado para los clústeres creados por GDC.
    • POD_CIDR: el tamaño de los intervalos de red desde los que se asignan las direcciones IP virtuales de los pods. Si no se define, se usará el valor predeterminado 21.
    • SERVICE_CIDR: el tamaño de los intervalos de red desde los que se asignan las direcciones IP virtuales de servicio. Si no se define, se usará el valor predeterminado 23.
    • KUBERNETES_VERSION: la versión de Kubernetes del clúster, como 1.26.5-gke.2100. Para ver la lista de versiones de Kubernetes disponibles que puedes configurar, consulta Mostrar las versiones de Kubernetes disponibles para un clúster.
    • MACHINE_TYPE: el tipo de máquina de los nodos de trabajador del grupo de nodos. Consulta los tipos de máquinas disponibles para saber qué puedes configurar.
    • NODE_POOL_NAME: el nombre del grupo de nodos.
    • NUMBER_OF_WORKER_NODES: el número de nodos de trabajador que se aprovisionarán en el grupo de nodos.
    • TAINTS: las restricciones que se aplicarán a los nodos de este grupo de nodos. Se trata de un campo opcional.
    • LABELS: las etiquetas que se aplicarán a los nodos de este grupo de nodos. Contiene una lista de pares clave-valor. Se trata de un campo opcional.
    • GPU_PARTITION_SCHEME: el esquema de partición de GPU, si ejecutas cargas de trabajo de GPU. Se trata de un campo opcional. Por ejemplo, mixed-2. La GPU no se particiona si no se define este campo. Para obtener más información sobre los perfiles de GPU con multiinstancia (MIG) disponibles, consulta Perfiles de MIG admitidos.
  2. En un archivo de configuración de Terraform, inserta el siguiente fragmento de código para crear el recurso personalizado ProjectBinding:

    provider "kubernetes" {
      config_path = "MANAGEMENT_API_SERVER"
    }
    
    resource "kubernetes_manifest" "PROJECT_BINDING_RESOURCE_NAME" {
      manifest = {
        "apiVersion" = "resourcemanager.gdc.goog/v1"
        "kind" = "ProjectBinding"
        "metadata" = {
          "name" = "CLUSTER_NAME-PROJECT_NAME"
          "namespace" = "platform"
          "labels" = {
            "resourcemanager.gdc.goog/projectbinding-for-user-project" = "true"
          }
        }
        "spec" = {
          "clusterRef" = {
            "name" = "CLUSTER_NAME"
          }
          "selector" = {
            "nameSelector" = {
              "matchNames" = [
                "PROJECT_NAME",
              ]
            }
          }
        }
      }
    }
    

    Haz los cambios siguientes:

    • MANAGEMENT_API_SERVER: ruta de kubeconfig del servidor de la API de zona.
    • PROJECT_BINDING_RESOURCE_NAME: el nombre del recurso de Terraform de la vinculación del proyecto, como project-binding-1. Terraform usa este nombre para identificar la vinculación de tu proyecto, pero GDC no lo usa.
    • CLUSTER_NAME: el nombre del clúster.
    • PROJECT_NAME: el nombre del proyecto al que se vinculará. Cada recurso de ProjectBinding solo se puede asignar a un clúster. Si un proyecto requiere acceso a varios clústeres, se debe crear un ProjectBinding único para cada clúster.

    Debes adjuntar un proyecto a tu clúster para que un desarrollador pueda desplegar cargas de trabajo de contenedores en el clúster.

  3. Aplica los nuevos recursos personalizados con Terraform:

    terraform apply
    

La creación de un clúster compartido puede tardar hasta 90 minutos en completarse.

Siguientes pasos