Uso de clusters de Compute para aprovisionar nodos gestionados

Descubra cómo crear pools de nodos gestionados en clusters de recursos informáticos con Kubernetes Engine (OKE) para soportar cargas de trabajo que utilizan unidades de hardware dedicado compatibles con RDMA.

Un cluster de recursos informáticos es un recurso del servicio informático que proporciona redes de gran ancho de banda y baja latencia entre instancias con hardware dedicado soportadas. En Kubernetes Engine, puede especificar un cluster de recursos informáticos al crear un pool de nodos gestionado. Cuando Kubernetes Engine crea instancias de nodo de trabajador para el pool de nodos, el servicio de recursos informáticos inicia las instancias en el cluster de recursos informáticos seleccionado.

Utilice clusters de cálculo para pools de nodos gestionados que ejecutan cargas de trabajo que requieren redes compatibles con RDMA, como cargas de trabajo de entrenamiento distribuidas. La especificación de un cluster de recursos informáticos para un pool de nodos gestionado le permite utilizar redes compatibles con RDMA al tiempo que conserva las operaciones del pool de nodos gestionado de Kubernetes Engine, como la ampliación, las actualizaciones y la sustitución de nodos.

Kubernetes Engine no crea clusters de recursos informáticos. Cree y configure el cluster de recursos informáticos en el servicio Compute antes de seleccionarlo en Kubernetes Engine. Para obtener más información sobre los clusters de recursos informáticos, consulte Clusters de recursos informáticos en la documentación del servicio Compute.

Al especificar un cluster de recursos informáticos para un pool de nodos gestionado, Kubernetes Engine activa automáticamente los plugins de HPC de Oracle Cloud Agent necesarios para las redes RDMA, incluido el plugin de autenticación RDMA de HPC de recursos informáticos y el plugin de configuración automática RDMA de HPC de recursos informáticos. Tenga en cuenta que no puede personalizar esta configuración de plugin de Oracle Cloud Agent mediante las API del pool de nodos de Kubernetes Engine.

Solo puede especificar un cluster de recursos informáticos al crear un pool de nodos gestionado. No puede agregar, eliminar ni cambiar el cluster de recursos informáticos de un pool de nodos existente. Para utilizar un cluster de recursos informáticos diferente, cree un nuevo pool de nodos gestionados.

Antes de crear un pool de nodos gestionado en un cluster de recursos informáticos, tenga en cuenta lo siguiente:

El cluster de Kubernetes Engine debe ser un cluster mejorado.
Cree el cluster de recursos informáticos en el servicio Compute.
Asegúrese de que el estado del ciclo de vida del cluster de recursos informáticos es ACTIVE.
Utilice una unidad de pool de nodos que admita RDMA y clusters de recursos informáticos (consulte Unidades soportadas en la documentación del servicio Compute).
La configuración de colocación del pool de nodos debe incluir solo el dominio de disponibilidad que contiene el cluster de recursos informáticos.
No especifique dominios de errores en la configuración de colocación. Cuando se especifica un cluster de recursos informáticos, el servicio de recursos informáticos gestiona la colocación del dominio de errores.
Agregue la política de IAM necesaria para que Kubernetes Engine pueda utilizar el cluster de recursos informáticos al iniciar instancias de nodo de trabajador.

Política de IAM necesaria

Para permitir que un pool de nodos utilice un cluster de recursos informáticos, debe existir una política que permita a la entidad de recurso del pool de nodos utilizar el cluster de recursos informáticos. Por ejemplo:

allow any-user to {COMPUTE_CLUSTER_LAUNCH_INSTANCE} in compartment <compartment_name> where request.principal.type = 'nodepool' and target.resource.id = '<compute_cluster_OCID>'

donde:

<compartment_name> es el nombre del compartimento que contiene el cluster de recursos informáticos.
<compute_cluster_OCID> es el OCID del clusters de recursos informáticos.

Uso de la consola

Puede especificar un cluster de recursos informáticos al crear un cluster con un pool de nodos gestionado o al crear un pool de nodos gestionado en un cluster mejorado existente.

No puede especificar un cluster de recursos informáticos al actualizar un pool de nodos gestionado existente.

Creación de un cluster y especificación de un cluster de cálculo para un pool de nodos gestionado

Siga las instrucciones para crear un cluster mediante el flujo de trabajo Creación personalizada. Consulte Uso de la consola para crear un cluster con valores definidos explícitamente en el flujo de trabajo "Creación personalizada".
Al especificar los detalles del pool de nodos:
1. En Tipo de nodo, seleccione Gestionado.
2. Especifique la configuración de colocación de nodos de la siguiente manera:
  - Dominio de disponibilidad: seleccione el dominio de disponibilidad que contiene el cluster de recursos informáticos.
  - Compartimento de subred de nodo de trabajador: seleccione el compartimento que contiene la subred de nodo de trabajador.
  - Subred de nodo de trabajador: seleccione una subred en el dominio de disponibilidad del cluster de recursos informáticos.
  - Dominios de errores: no especifique dominios de errores. El servicio Compute gestiona la colocación del dominio de errores.
3. Para Unidad de nodo, seleccione una unidad de nodo que soporte RDMA y clusters de recursos informáticos.
4. Seleccione Opciones avanzadas y especifique el cluster de recursos informáticos que desea utilizar en la sección Agregar un cluster de recursos informáticos:
  - Compartimento de cluster de recursos informáticos: seleccione el compartimento que contiene el cluster de recursos informáticos.
  - Cluster de Compute: seleccione el cluster de Compute.
Cree el cluster.

Kubernetes Engine crea el cluster y el pool de nodos gestionados. Cuando Kubernetes Engine crea instancias de nodo de trabajador para el pool de nodos gestionado, el servicio de recursos informáticos inicia las instancias en el cluster de recursos informáticos seleccionado.

Creación de un pool de nodos gestionado y especificación de un cluster de recursos informáticos

En la página de lista Clusters, seleccione el nombre del cluster mejorado en el que desea crear un nuevo pool de nodos. Si necesita ayuda para buscar la página de lista o el cluster, consulte Listing Clusters.
En el separador Pools de nodos de la página de detalles del cluster, seleccione Agregar pool de nodo para crear un nuevo pool de nodo gestionado y especificar las propiedades requeridas para sus nodos del trabajador.
Al especificar los detalles del pool de nodos:
1. En Tipo de nodo, seleccione Gestionado.
2. Seleccione Opciones avanzadas y especifique el cluster de recursos informáticos que desea utilizar en la sección Agregar un cluster de recursos informáticos:
  - Compartimento de cluster de recursos informáticos: seleccione el compartimento que contiene el cluster de recursos informáticos.
  - Cluster de Compute: seleccione el cluster de Compute.
3. Especifique la configuración de colocación de nodos de la siguiente manera:
  - Dominio de disponibilidad: seleccione el dominio de disponibilidad que contiene el cluster de recursos informáticos.
  - Compartimento de subred de nodo de trabajador: seleccione el compartimento que contiene la subred de nodo de trabajador.
  - Subred de nodo de trabajador: seleccione una subred en el dominio de disponibilidad del cluster de recursos informáticos.
  - Dominios de errores: no especifique dominios de errores. El servicio Compute gestiona la colocación del dominio de errores.
4. Para Unidad de nodo, seleccione una unidad de nodo que soporte RDMA y clusters de recursos informáticos.
Cree el pool de nodos.

Kubernetes Engine crea el pool de nodos gestionado. Cuando Kubernetes Engine crea instancias de nodo de trabajador para el pool de nodos gestionado, el servicio de recursos informáticos inicia las instancias en el cluster de recursos informáticos seleccionado.

Uso de la CLI

Para utilizar la CLI para crear un pool de nodos gestionado en un cluster de recursos informáticos, incluya el par clave/valor computeClusterId en el parámetro --node-config-details con el formato:

oci ce node-pool create \
  --cluster-id <cluster_OCID> \
  --compartment-id <compartment_OCID> \
  --name <node_pool_name> \
  --kubernetes-version <kubernetes_version> \
  --node-shape <shape> \
  --node-config-details '{
    "size": 2,
    "placementConfigs": [
      {
        "availabilityDomain": "<availability_domain>",
        "subnetId": "<subnet_OCID>"
      }
    ],
    "computeClusterId": "<compute_cluster_OCID>"
  }'

La configuración de ubicación debe incluir solo el dominio de disponibilidad que contiene el cluster de recursos informáticos. No especifique dominios de errores.

Uso de la API

Al crear un pool de nodos gestionado, especifique computeClusterId en los detalles de configuración del pool de nodos.

Para crear solicitudes de pool de nodos, especifique:

CreateNodePoolDetails.createNodePoolNodeConfigDetails.computeClusterId

La propiedad computeClusterId es inmutable. No puede especificar computeClusterId en UpdateNodePoolDetails.

Solución de problemas

Utilice la siguiente información para solucionar problemas con clusters de cálculo en pools de nodos gestionados.

El cluster de recursos informáticos no está disponible en la lista

Compruebe lo siguiente:

Ha seleccionado el compartimento correcto.
El cluster de recursos informáticos está activo.
Tiene permiso para ver o utilizar el cluster de recursos informáticos.
El cluster de Kubernetes Engine es un cluster mejorado.

Fallo al crear el pool de nodos