Crea un clúster para ejecutar cargas de trabajo de contenedores

Console

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

2. Haz clic en Crear clúster.

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

4. Selecciona la versión de Kubernetes para el clúster.

5. Selecciona la zona en la que deseas crear el clúster.

6. Haz clic en Vincular proyecto y selecciona un proyecto existente para vincularlo a tu clúster. Luego, haz clic en Guardar. Puedes adjuntar o separar proyectos después de crear el clúster desde la página de detalles del proyecto. Debes tener un proyecto adjunto a tu clúster antes de implementar cargas de trabajo de contenedores en él.

   

7. Haz clic en Siguiente.

8. Configura los parámetros de configuración de red para tu clúster. No puedes cambiar estos parámetros de configuración de red después de crear el clúster. El único protocolo de Internet compatible y predeterminado para los clústeres de Kubernetes es la versión 4 del protocolo de Internet (IPv4).

   1. Si deseas crear nodos de balanceador de cargas dedicados, ingresa la cantidad de nodos que deseas crear. De forma predeterminada, recibes cero nodos y el tráfico del balanceador de cargas se ejecuta a través de los nodos de control.

   2. Selecciona el CIDR de servicio (enrutamiento entre dominios sin clases) que deseas usar. Tus servicios implementados, como los balanceadores de cargas, reciben direcciones IP asignadas de este rango.

   3. Selecciona el CIDR de Pod que deseas usar. El clúster asigna direcciones IP de este rango a tus Pods y VMs.

   4. Haz clic en Siguiente.

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

10. Para crear grupos de nodos adicionales, selecciona Agregar grupo de nodos. Cuando editas el grupo de nodos predeterminado o agregas un grupo de nodos 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 la cantidad de nodos trabajadores 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 parámetros de configuración:

       • Tipo de máquina
       • CPU
       • Memoria

    4. Haz clic en Guardar.

11. Haz clic en Crear para generar el clúster.

API

Para crear un clúster nuevo directamente con la API, aplica un recurso personalizado a tu instancia de GDC:

1. Crea un recurso personalizado Cluster y guárdalo como un archivo YAML, por ejemplo, cluster.yaml:

   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
     loadBalancer:
       ingressServiceIPSize: LOAD_BALANCER_POOL_SIZE
     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
   

   Reemplaza lo siguiente:

   • CLUSTER_NAME: Es el nombre del clúster. El nombre del clúster no debe terminar con -system. El sufijo -system está reservado para los clústeres creados por GDC.
   • POD_CIDR: Es el tamaño de los rangos de red desde los que se asignan las direcciones IP virtuales de los Pods. Si no se establece, se usa el valor predeterminado 21.
   • SERVICE_CIDR: Es el tamaño de los rangos de red desde los que se asignan las direcciones IP virtuales de servicio. Si no se establece, se usa el valor predeterminado 23.
   • KUBERNETES_VERSION: Es la versión de Kubernetes del clúster, como 1.26.5-gke.2100. Para enumerar las versiones de Kubernetes disponibles para configurar, consulta Enumera las versiones de Kubernetes disponibles para un clúster.
   • LOAD_BALANCER_POOL_SIZE: Es el tamaño de los grupos de direcciones IP no superpuestos que usan los servicios de balanceador de cargas. Si no se establece, se usa el valor predeterminado 20.
   • MACHINE_TYPE: Es el tipo de máquina para los nodos trabajadores del grupo de nodos. Consulta los tipos de máquinas disponibles para ver qué se puede configurar.
   • NODE_POOL_NAME: Es el nombre del grupo de nodos.
   • NUMBER_OF_WORKER_NODES: Es la cantidad de nodos trabajadores que se aprovisionarán en el grupo de nodos.
   • TAINTS: Son los taints que se aplicarán a los nodos de este grupo de nodos. Este paso es opcional,
   • LABELS: Son las etiquetas que se aplicarán a los nodos de este grupo de nodos. Contiene una lista de pares clave-valor. Este campo es opcional.
   • GPU_PARTITION_SCHEME: Esquema de partición de GPU, si ejecutas cargas de trabajo de GPU. Por ejemplo, mixed-2 La GPU no se particiona si no se configura este campo. Para conocer los perfiles de GPU multiinstancia (MIG) disponibles, consulta Perfiles de MIG compatibles.

2. Aplica el recurso personalizado a tu instancia de GDC:

   kubectl apply -f cluster.yaml --kubeconfig MANAGEMENT_API_SERVER
   

   Reemplaza MANAGEMENT_API_SERVER por la ruta de acceso al archivo kubeconfig del servidor de la API zonal. Si aún no generaste un archivo kubeconfig para el servidor de la API en la zona de destino, consulta Accede para obtener más detalles.

Terraform

1. En un archivo de configuración de Terraform, inserta el siguiente fragmento de código:

   provider "kubernetes" {
     config_path = "MANAGEMENT_API_SERVER"
   }
   
   resource "kubernetes_manifest" "cluster-create" {
     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"
         }
         "loadBalancer" = {
           "ingressServiceIPSize" = "LOAD_BALANCER_POOL_SIZE"
         }
         "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"
         }
       }
     }
   }
   

   Reemplaza lo siguiente:

   • MANAGEMENT_API_SERVER: Es la ruta de acceso a kubeconfig del servidor de API zonal. Si aún no generaste un archivo kubeconfig para el servidor de la API en la zona de destino, consulta Accede para obtener más detalles.
   • CLUSTER_NAME: Es el nombre del clúster. El nombre del clúster no debe terminar con -system. El sufijo -system está reservado para los clústeres creados por GDC.
   • POD_CIDR: Es el tamaño de los rangos de red desde los que se asignan las direcciones IP virtuales de los Pods. Si no se establece, se usa el valor predeterminado 21.
   • SERVICE_CIDR: Es el tamaño de los rangos de red desde los que se asignan las direcciones IP virtuales de servicio. Si no se establece, se usa el valor predeterminado 23.
   • KUBERNETES_VERSION: Es la versión de Kubernetes del clúster, como 1.26.5-gke.2100. Para enumerar las versiones de Kubernetes disponibles para configurar, consulta Enumera las versiones de Kubernetes disponibles para un clúster.
   • LOAD_BALANCER_POOL_SIZE: Es el tamaño de los grupos de direcciones IP no superpuestos que usan los servicios de balanceador de cargas. Si no se establece, se usa el valor predeterminado 20.
   • MACHINE_TYPE: Es el tipo de máquina para los nodos trabajadores del grupo de nodos. Consulta los tipos de máquinas disponibles para ver qué se puede configurar.
   • NODE_POOL_NAME: Es el nombre del grupo de nodos.
   • NUMBER_OF_WORKER_NODES: Es la cantidad de nodos trabajadores que se aprovisionarán en el grupo de nodos.
   • TAINTS: Son los taints que se aplicarán a los nodos de este grupo de nodos. Este paso es opcional,
   • LABELS: Son las etiquetas que se aplicarán a los nodos de este grupo de nodos. Contiene una lista de pares clave-valor. Este campo es opcional.
   • GPU_PARTITION_SCHEME: Esquema de partición de GPU, si ejecutas cargas de trabajo de GPU. Por ejemplo, mixed-2 La GPU no se particiona si no se configura este campo. Para conocer los perfiles de GPU multiinstancia (MIG) disponibles, consulta Perfiles de MIG compatibles.

2. Aplica el nuevo clúster de Kubernetes con Terraform:

   terraform apply