Crea un clúster de usuario con los clientes de la API de Anthos local

Consola

La mayoría de las opciones de configuración en la consola corresponden a los campos del archivo de configuración de clúster.

1. En la consola de Google Cloud, ve a la página de clústeres de GKE Enterprise.

   Ir a la página Clústeres de GKE Enterprise

2. Selecciona el proyecto de Google Cloud en el que deseas crear el clúster. El proyecto seleccionado también se usa como el proyecto host de la flota. Este debe ser el mismo proyecto en el que está registrado el clúster de administrador. Después de crear el clúster de usuario, se registra de forma automática en la flota del proyecto seleccionado.

3. Haz clic en Crear clúster.

4. En el cuadro de diálogo, haz clic en Local.

5. Junto a Bare metal, haz clic en Configurar.

6. Revisa los requisitos previos y la arquitectura de muestra. Cuando esté todo listo, haz clic en Siguiente para comenzar a configurar el clúster.

En las siguientes secciones, se te guiará a través de la configuración del clúster de usuario.

Conceptos básicos del clúster

Ingresa información básica sobre el clúster.

1. Ingresa un Nombre para el clúster de usuarios.

2. En Clúster de administrador, selecciona el clúster de administrador de la lista.

3. En el campo Ubicación de la API de Google Cloud, selecciona la región de Google Cloud de la lista. Con esta configuración, se especifica la región en la que se ejecuta la API de Anthos On-Prem y la región en la que se almacena lo siguiente:

   • Los metadatos del clúster de usuario que la API de Anthos On-Prem necesita para administrar el ciclo de vida del clúster
   • Los datos de Cloud Logging y Cloud Monitoring de los componentes del sistema
   • El registro de auditoría de administrador creado por los registros de auditoría de Cloud

   El nombre, el proyecto y la ubicación del clúster juntos identifican de forma única el clúster en Google Cloud.

4. Selecciona la versión de GKE en Bare Metal para tu clúster de usuario. Los clústeres de usuario deben ser la misma versión secundaria que el clúster de administrador o una versión secundaria anterior que el clúster de administrador.

5. Como creador de clústeres, se te otorgan privilegios de administrador de clúster. De manera opcional, ingresa la dirección de correo electrónico de otro usuario que administrará el clúster en el campo Usuario administrador.

   Cuando se crea el clúster, la API de Anthos On-Prem aplica las políticas de control de acceso basado en funciones (RBAC) de Kubernetes al clúster para otorgarte a ti y aotros usuarios administradores el rol clusterrole/cluster-admin de Kubernetes, que proporciona acceso completo a cada recurso en el clúster en todos los espacios de nombres.

6. En la sección Configuración de nodos, especifica lo siguiente:

   • Cantidad máxima de Pods por nodo: Ingresa la cantidad máxima de Pods que se pueden ejecutar en un solo nodo. Los valores permitidos están entre 32 y 250 inclusive. Kubernetes asigna un bloque de enrutamiento entre dominios sin clases (CIDR) a cada nodo para que cada pod pueda tener una dirección IP única. El tamaño del bloque CIDR corresponde a la cantidad máxima de pods por nodo. Para obtener más información sobre cómo configurar la cantidad máxima de pods por nodo, consulta Herramientas de redes de pods.

   • Entorno de ejecución del contenedor: containerd es el único entorno de ejecución de contenedores disponible para tu clúster.

7. Haz clic en Siguiente para ir a la sección Herramientas de redes.

Herramientas de redes

En esta sección, debes especificar las direcciones IP para los nodos, los Pods y los objetos Service del clúster. Si usas el balanceo de cargas en paquetes con MetalLB, también debes configurarlo.

1. En la sección de nodos del Plano de control, ingresa la dirección IPv4 de cada nodo del plano de control. Los nodos del plano de control ejecutan la carga de trabajo del sistema. Por lo general, se trata de una sola máquina si se usa una implementación mínima o tres máquinas si se usa una implementación de alta disponibilidad (HA). Especifica una cantidad impar de nodos a fin de tener la mayoría del quórum para la alta disponibilidad. Este campo se puede cambiar cada vez que actualices o actualices un clúster.

   Haz clic en + Agregar dirección IP según sea necesario para ingresar más direcciones IP.

2. En la sección Balanceador de cargas, selecciona el balanceador de cargas de la lista Modo para configurarlo en el clúster. Consulta la Descripción general de los balanceadores de cargas para obtener más información.

   Incluido con MetalLB

   Configurar el balanceo de cargas con el balanceador de cargas en paquete de MetalLB Con esta opción, GKE en Bare Metal implementa balanceadores de cargas de capa 4 que se ejecutan en un grupo dedicado de nodos trabajadores o en los mismos nodos que el plano de control.

   1. En la sección Grupos de nodos del balanceador de cargas, selecciona una de las siguientes opciones:

      • Usar nodos del plano de control: Elige esta opción para ejecutar los balanceadores de cargas en los mismos nodos que el plano de control.

      • Crear grupo de nodos del balanceador de cargas: Elige esta opción avanzada si necesitas ejecutar los balanceadores de cargas en un grupo dedicado de nodos trabajadores. Todos los nodos del grupo de nodos del balanceador de cargas deben estar en la misma subred de capa 2 que las IP virtuales (VIP) del balanceador de cargas que configuras en la sección Grupos de direcciones del balanceador de cargas.

        1. En el campo IP 1 del grupo de nodos del balanceador de cargas, ingresa una dirección IPv4 para un nodo en el grupo de nodos del balanceador de cargas.

        2. Haz clic en + Agregar dirección IP según sea necesario para ingresar direcciones IP adicionales.

   2. En la sección Grupos de direcciones del balanceador de cargas, agrega uno o más grupos de direcciones para que el controlador de MetalLB elija y asigne a los servicios de tipo LoadBalancer. La VIP de entrada, que especificas en la sección IP virtuales, debe estar en uno de estos grupos.

      1. Ingresa un Nombre para el grupo de direcciones.

      2. Ingresa un rango de direcciones IP en la notación CIDR (por ejemplo: 192.0.2.0/26) o en una notación de rango (por ejemplo: 192.0.2.64-192.0.2.72). Para especificar una sola dirección IP en un grupo, usa /32 en la notación CIDR (por ejemplo: 192.0.2.1/32).

      3. Si la VIP de entrada no está en el rango de direcciones, selecciona + Agregar rango de direcciones IP y, luego, ingresa otro rango de direcciones que incluya la VIP de entrada.

         Las direcciones IP en cada grupo no pueden superponerse y deben estar en la misma subred que los nodos del clúster.

      4. En Asignación de direcciones IP, selecciona una de las siguientes opciones:

         • Automático: Elige esta opción si deseas que el controlador de MetalLB asigne automáticamente las direcciones IP del grupo de direcciones a los servicios de tipo LoadBalancer.
         • Manual: Elige esta opción si deseas usar direcciones del grupo a fin de especificar direcciones de forma manual para los servicios de tipo LoadBalancer.

      5. Haz clic en Evita las direcciones IP con errores si deseas que el controlador de MetalLB no use direcciones del grupo que terminan en .0 o .255. Esto evita el problema de los dispositivos consumidores con errores que descartan por error el tráfico enviado a esas direcciones IP especiales.

      6. Cuando hayas terminado, haz clic en Listo.

      7. Si es necesario, haz clic en Agregar grupo de direcciones.

   Balanceador de cargas manual

   Con el balanceo de cargas manual, puedes configurar tus propias soluciones de balanceo de cargas para el tráfico del plano de control y del plano de datos. Debes configurar la VIP del plano de control en el balanceador de cargas externo antes de crear un clúster. El balanceador de cargas del plano de control externo también se puede usar para el tráfico del plano de datos o puedes configurar un balanceador de cargas independiente para el plano de datos. Para obtener más información, consulta Configura el balanceo de cargas manual.

3. En la sección IP virtuales, ingresa lo siguiente:

   • VIP del plano de control: La dirección IP de destino que se usará para el tráfico enviado al servidor de la API de Kubernetes del clúster de usuario. La VIP del plano de control debe estar en la misma subred que los nodos del balanceador de cargas y no debe estar en ninguno de los rangos de direcciones que se usan para los grupos de direcciones del balanceador de cargas.

   • Puerto: El puerto de destino que se usa para el tráfico enviado al servidor de la API de Kubernetes. El valor predeterminado es 443.

   • VIP de Ingress: La dirección IP que se configurará en el balanceador de cargas para el proxy de Ingress. Ingresa una dirección de uno de los grupos de direcciones del balanceador de cargas.

4. En la sección CIDR de servicio y Pod, especifica los rangos de direcciones IP del Pod y del servicio de Kubernetes en la notación CIDR. No deben superponerse entre sí ni con ninguna dirección fuera del clúster a la que quieras llegar desde dentro del clúster. Te recomendamos que uses los rangos de direcciones IP privadas definidos por RFC 1918. Console proporciona los siguientes rangos de direcciones predeterminados, pero puedes cambiarlos:

   • CIDR del servicio: 10.96.0.0/20 Si no aceptas el valor predeterminado, ingresa un rango CIDR entre /24 y /12, en el que /12 proporciona la mayor cantidad de direcciones IP.

   • CIDR del Pod: 192.168.0.0/16 Si no aceptas el valor predeterminado, ingresa un rango CIDR entre /18 y /8, en el que /8 proporciona la mayor cantidad de direcciones IP.

5. De manera opcional, en la sección de atributos de Atributos avanzados, especifica lo siguiente:

   • URL proxy: Es la dirección HTTP del servidor proxy. Incluye el número de puerto incluso si es el mismo que el puerto predeterminado del esquema, por ejemplo: http://my-proxy.example.local:80

   • URL: Es una lista separada por comas de direcciones IP, rangos de direcciones IP, nombres de host y nombres de dominio que no deben pasar por el servidor proxy. Cuando GKE en Bare Metal envía una solicitud a una de estas direcciones, hosts o dominios, la solicitud se envía directamente.

6. Haz clic en Siguiente.

Almacenamiento

GKE en Bare Metal proporciona interfaces de almacenamiento en bloque y de archivos. Tienen opciones predeterminadas, pero puedes personalizar las configuraciones. Para obtener más información, consulta Cómo configurar el almacenamiento local.

1. De manera opcional, puedes configurar lo siguiente:

   • Activaciones de nodos del aprovisionador local de volumen: Especifica la configuración de los PersistentVolumes (PV) locales respaldados por discos activados. Debes formatear y activar estos discos antes o después de la creación del clúster.

   • Uso compartido del aprovisionador local de volumen: Especifica la configuración de PersistentVolumes local respaldada por subdirectorios en un sistema de archivos compartidos. Estos subdirectorios se crean automáticamente durante la creación del clúster.

2. Haz clic en Siguiente.

Atributos

Las siguientes opciones se habilitan automáticamente para ayudarte a supervisar, solucionar problemas y operar tu clúster, y no se pueden inhabilitar:

• Cloud Logging de servicios del sistema
• Cloud Monitoring de servicios del sistema
• El registro de auditoría de actividad del administrador

Crear un grupo de nodos

El clúster debe tener al menos un grupo de nodos para los nodos trabajadores. Un grupo de nodos es una plantilla para los grupos de nodos trabajadores creados en este clúster.

En la consola, configura al menos un grupo de nodos (o acepta los valores predeterminados) y, luego, crea el clúster. Puedes agregar grupos de nodos adicionales después de crear el clúster. Con gcloud CLI, primero creas el clúster y, luego, agregas uno o más grupos de nodos al clúster recién creado.

1. Haz clic en grupo predeterminado en la barra de navegación izquierda.

2. En la sección Valores predeterminados del grupo de nodos, ingresa el Nombre del grupo de nodos o acepta “grupo predeterminado” como nombre.

3. En la sección Nodos trabajadores, ingresa las direcciones IP de las máquinas en las que se ejecutará el clúster.

4. En la sección Metadatos del grupo de nodos (opcional), si quieres agregar etiquetas y taints de Kubernetes, haz lo siguiente:

   1. Haz clic en + Add Kubernetes Labels. Ingresa la Clave y el Valor de la etiqueta. Repite la acción según sea necesario.
   2. Haz clic en + Agregar taint. Ingresa la Clave, el Valor y el Efecto para el taint. Repite la acción según sea necesario.

5. Haz clic en Verify and Complete para crear el clúster de usuario. La creación del clúster de usuario toma 15 minutos o más. La consola muestra los mensajes de estado mientras verifica la configuración y crea el clúster en tu centro de datos.

   Si hay un problema con la configuración, la consola muestra un mensaje de error que debería ser lo suficientemente claro como para que puedas solucionar el problema de configuración y volver a intentar crear el clúster.

gcloud CLI

Usa el siguiente comando para crear un clúster de usuario:

gcloud container bare-metal clusters create

Después de crear el clúster, debes crear al menos un grupo de nodos con el siguiente comando:

gcloud container bare-metal node-pools create

La mayoría de las marcas para crear el clúster y el grupo de nodos corresponden a los campos del archivo de configuración del clúster de usuario. Para ayudarte a comenzar, puedes probar el comando completo en la sección Ejemplos. Para obtener información sobre las marcas, consulta las secciones que siguen a los ejemplos o consulta la referencia de la CLI de gcloud.

Antes de comenzar

La versión de GKE en Bare Metal que seleccionas cuando creas un clúster de usuario debe ser una versión compatible con el clúster de administrador. Además, las versiones secundarias o de parches más recientes no estarán disponibles en la API de Anthos On-Prem hasta entre 7 y 10 días después del lanzamiento. Puedes ejecutar un comando gcloud para obtener una lista de las versiones compatibles que puedes instalar en el clúster de usuario.

1. Asegúrate de actualizar los componentes:

   gcloud components update
   

2. Obtén una lista de las versiones disponibles para instalar en el clúster de usuario:

   gcloud container bare-metal clusters query-version-config \
     --admin-cluster-membership=ADMIN_CLUSTER_NAME \
     --admin-cluster-membership-project=FLEET_HOST_PROJECT_ID \
     --admin-cluster-membership-location=global \
     --location=REGION
   

   Reemplaza lo siguiente:

   • ADMIN_CLUSTER_NAME: Es el nombre del clúster de administrador.

   • FLEET_HOST_PROJECT_ID: El ID del proyecto en el que está registrado el clúster de administrador

   • REGION: Es la región de Google Cloud que especificaste cuando inscribiste el clúster en la API de Anthos On-Prem.

Te sugerimos que uses la versión más reciente compatible para obtener las correcciones y mejoras más recientes.

Ejemplos

En esta sección, se proporciona un ejemplo de un comando que crea un clúster con el balanceador de cargas de MetalLB y un ejemplo con un balanceador de cargas manual. La información que especifiques varía según el tipo de balanceador de cargas que usarás. Consulta la Descripción general de los balanceadores de cargas para obtener más información.

En los ejemplos, se crea el clúster sin ningún grupo de nodos. Una vez que el clúster esté en ejecución, debes agregar un grupo de nodos antes de implementar las cargas de trabajo.

gcloud container bare-metal clusters create USER_CLUSTER_NAME \
  --project=FLEET_HOST_PROJECT_ID \
  --admin-cluster-membership=projects/FLEET_HOST_PROJECT_ID/locations/global/memberships/ADMIN_CLUSTER_NAME \
  --location=REGION \
  --version=VERSION \
  --admin-users=YOUR_EMAIL_ADDRESS \
  --admin-users=ANOTHER_EMAIL_ADDRESS \
  --metal-lb-address-pools='pool=NAME,avoid-buggy-ips=True|False,manual-assign=True|False,addresses=IP_ADDRESS_RANGE_1;IP_ADDRESS_RANGE_2;...' \
  --control-plane-node-configs='node-ip=CP_IP_ADDRESS_1,labels=CP_KEY_1.1=CP_VALUE_1.1;CP_KEY_1.2=CP_VALUE_1.2;...' \
  --control-plane-vip=CONTROL_PLANE_VIP \
  --control-plane-load-balancer-port=CONTROL_PLANE_LB_PORT \
  --ingress-vip=INGRESS_VIP \
  --island-mode-service-address-cidr-blocks=SERVICE_CIDR_BLOCK \
  --island-mode-pod-address-cidr-blocks=POD_CIDR_BLOCK \
  --lvp-share-path=/mnt/localpv-share \
  --lvp-share-storage-class=local-shared \
  --lvp-node-mounts-config-path=/mnt/localpv-disk \
  --lvp-node-mounts-config-storage-class=local-disks

'pool=NAME,avoid-buggy-ips=True|False,manual-assign=True|False,addresses=IP_ADDRESS_RANGE_1;IP_ADDRESS_RANGE_2;...' \

--metal-lb-address-pools='pool=pool1,avoid-buggy-ips=False,manual-assign=True,addresses=192.0.2.0/26;192.0.2.64-192.0.2.72'
--metal-lb-address-pools='pool=pool2,avoid-buggy-ips=True,manual-assign=True,addresses=10.251.133.0/24;10.251.134.80/32'

gcloud container bare-metal clusters create USER_CLUSTER_NAME \
  --project=FLEET_HOST_PROJECT_ID \
  --admin-cluster-membership=projects/FLEET_HOST_PROJECT_ID/locations/global/memberships/ADMIN_CLUSTER_NAME \
  --location=REGION \
  --version=VERSION \
  --admin-users=YOUR_EMAIL_ADDRESS \
  --admin-users=ANOTHER_EMAIL_ADDRESS \
  --enable-manual-lb \
  --control-plane-node-configs='node-ip=CP_IP_ADDRESS_1,labels=CP_KEY_1.1=CP_VALUE_1.1;CP_KEY_1.2=CP_VALUE_1.2;...' \
  --control-plane-vip=CONTROL_PLANE_VIP \
  --control-plane-load-balancer-port=CONTROL_PLANE_LB_PORT \
  --ingress-vip=INGRESS_VIP \
  --island-mode-service-address-cidr-blocks=SERVICE_CIDR_BLOCK \
  --island-mode-pod-address-cidr-blocks=POD_CIDR_BLOCK \
  --lvp-share-path=/mnt/localpv-share \
  --lvp-share-storage-class=local-shared \
  --lvp-node-mounts-config-path=/mnt/localpv-disk \
  --lvp-node-mounts-config-storage-class=local-disks

Antes de ejecutar el comando gcloud para crear el clúster, te recomendamos que incluyas --validate-only a fin de validar la configuración que especificaste en las marcas del comando gcloud. Cuando estés listo para crear el clúster, quita esta marca y ejecuta el comando.

La creación del clúster de usuario tarda 15 minutos o más. Puedes ver el clúster en Google Cloud Console en la página Clústeres de Anthos.

Para obtener una lista completa de las marcas y sus descripciones, consulta la referencia de la CLI de gcloud.

Crear un grupo de nodos

Después de crear el clúster, debes crear al menos un grupo de nodos antes de implementar las cargas de trabajo. Un grupo de nodos es una plantilla para los grupos de nodos trabajadores creados en este clúster. Con gcloud CLI, primero creas el clúster y, luego, agregas uno o más grupos de nodos al clúster recién creado.

gcloud container bare-metal node-pools create NODE_POOL_NAME \
  --cluster=USER_CLUSTER_NAME \
  --project=FLEET_HOST_PROJECT_ID \
  --location=REGION \
  --node-configs='node-ip=NP_IP_ADDRESS_1,labels=NP_KEY_1.1=NP_VALUE_1.1;NP_KEY_1.2=NP_VALUE_1.2;...'

Reemplaza lo siguiente:

• NODE_POOL_NAME: Es el nombre que elijas para el grupo de nodos. El nombre debe cumplir con los siguientes requisitos:

  • Contener 40 caracteres como máximo.
  • Contener solo caracteres alfanuméricos en minúscula o un guiones (-).
  • Comenzar con un carácter alfabético
  • Terminar con un carácter alfanumérico

• USER_CLUSTER_NAME: Es el nombre del clúster de usuario recién creado.

• FLEET_HOST_PROJECT_ID: El ID del proyecto en el que está registrado el clúster.

• REGION: Es la región de Google Cloud que especificaste cuando creaste el clúster.

• --node-configs: Es la dirección IPv4 de una máquina de nodo trabajador. Especifica esta marca para cada nodo. El valor de la marca tiene el siguiente formato:

  'node-ip=NP_IP_ADDRESS_1,labels=NP_KEY_1.1=NP_VALUE_1.1;NP_KEY_1.2=NP_VALUE_1.2;...' \
  

  El valor tiene segmentos que comienzan con las palabras clave node-ip y labels. Separa cada segmento con una coma.

  • node-ip: La dirección IP de un nodo trabajador. Solo puedes especificar un node-ip por marca. Agrega esta marca nuevamente para cada nodo en el grupo de nodos.

  • labels: Uno o más pares clave=valor adjuntos al nodo.

  Ten en cuenta las siguientes reglas de sintaxis:

  • Encierra todo el valor entre comillas simples.
  • No se permiten espacios en blanco.
  • Separa cada par clave=valor en el segmento labels con un punto y coma.

  De manera opcional, puedes especificar lo siguiente:

  • --node-labels=KEY=VALUE,...: Es una lista separada por comas de etiquetas de Kubernetes (pares clave-valor) aplicadas a cada nodo del grupo.

  • --node-taints=KEY=VALUE:EFFECT,...Una lista separada por comas de taints de Kubernetes que se aplican a cada nodo del grupo. Los taints son pares clave=valor asociados con un efecto. Los taints se usan con tolerancias para la programación de Pods. Especifica una de las siguientes opciones para EFFECT: NoSchedule, PreferNoSchedule o NoExecute.

En el siguiente ejemplo, se crea un grupo de nodos llamado default-pool en user-cluster- y se agregan dos nodos al grupo de nodos. Todos los nodos están etiquetados con node-pool-key=node-pool-value y tienen el taint dedicated=experimental:PreferNoSchedule.

gcloud container bare-metal node-pools create default-pool \
  --cluster=user-cluster-1  \
  --project=example-project-12345 \
  --location=us-west1 \
  --node-configs='node-ip=10.200.0.10' \
  --node-configs='node-ip=10.200.0.11,labels=key2.1=value2.1' \
  --node-labels=node-pool-key=node-pool-value \
  --node-taints=dedicated=experimental:PreferNoSchedule

Para obtener más información, consulta la referencia de la CLI de gcloud.

Terraform

Antes de comenzar

La versión de GKE en Bare Metal que seleccionas cuando creas un clúster de usuario debe ser una versión compatible con el clúster de administrador. Además, las versiones secundarias o de parches más recientes no estarán disponibles en la API de Anthos On-Prem hasta entre 7 y 10 días después del lanzamiento. Puedes ejecutar un comando gcloud para obtener una lista de las versiones compatibles que puedes instalar en el clúster de usuario.

1. Asegúrate de actualizar los componentes:

   gcloud components update
   

2. Obtén una lista de las versiones disponibles para instalar en el clúster de usuario:

   gcloud container bare-metal clusters query-version-config \
     --admin-cluster-membership=ADMIN_CLUSTER_NAME \
     --admin-cluster-membership-project=FLEET_HOST_PROJECT_ID \
     --admin-cluster-membership-location=global \
     --location=REGION
   

   Reemplaza lo siguiente:

   • ADMIN_CLUSTER_NAME: Es el nombre del clúster de administrador.

   • FLEET_HOST_PROJECT_ID: El ID del proyecto en el que está registrado el clúster de administrador

   • REGION: Es la región de Google Cloud que especificaste cuando inscribiste el clúster en la API de Anthos On-Prem.

Te sugerimos que uses la versión más reciente compatible para obtener las correcciones y mejoras más recientes.

Ejemplo

Puedes usar la siguiente muestra de configuración básica para crear un clúster de usuario con un balanceador de cargas de MetalLB en paquete. Para obtener más información, consulta la documentación de referencia de google_gkeonprem_bare_metal_cluster.

1. Clona el repositorio anthos-samples y cambia al directorio en el que se encuentra la muestra de Terraform:

   git clone https://github.com/GoogleCloudPlatform/anthos-samples
   cd anthos-samples/anthos-onprem-terraform/abm_user_cluster_metallb
   

   La muestra proporciona un archivo de variables de ejemplo para pasar a main.tf.

2. Crea una copia del archivo terraform.tfvars.sample:

   cp terraform.tfvars.sample terraform.tfvars
   

   anthos-onprem-terraform/abm_user_cluster_metallb/terraform.tfvars.sample

   Ver en GitHub
   
   project_id          = "PROJECT_ID"
   region              = "ON_PREM_API_REGION"
   admin_cluster_name  = "ADMIN_CLUSTER_NAME"
   bare_metal_version  = "VERSION"
   admin_user_emails   = ["YOUR_EMAIL_ADDRESS", "ADMIN_2_EMAIL_ADDRESS"]
   cluster_name        = "abm-user-cluster-metallb"
   control_plane_ips   = ["10.200.0.4"]
   worker_node_ips     = ["10.200.0.5", "10.200.0.6"]
   control_plane_vip   = "10.200.0.50"
   ingress_vip         = "10.200.0.51"
   lb_address_pools    = [
       { name = "lbpool_1", addresses = ["10.200.0.51-10.200.0.70"] }
   ]
   

3. Modifica los valores de los parámetros en terraform.tfvars y guarda el archivo.

   En la siguiente lista, se describen las variables:

   • project_id: El ID del proyecto en el que deseas crear el clúster. El proyecto especificado también se usa como proyecto host de la flota. Este debe ser el mismo proyecto en el que está registrado el clúster de administrador. Después de crear el clúster de usuario, se registra de forma automática en la flota del proyecto seleccionado. El proyecto host de la flota no se puede cambiar después de crear el clúster.

   • region: Es la región de Google Cloud en la que se ejecuta la API de Anthos On-Prem. Especifica us-west1 o una región compatible.

   • admin_cluster_name: Es el nombre del clúster de administrador que gestiona el clúster de usuario.

   • bare_metal_version: Es la versión de GKE en Bare Metal para el clúster de usuario. Especifica la misma versión que el clúster de administrador o una versión que no tenga más de una versión secundaria inferior a la del clúster de administrador.

   • cluster_name: Un nombre que elijas para el clúster de usuario El nombre no se puede cambiar después de crear el clúster. El nombre debe cumplir con los siguientes requisitos:

     • Contener 40 caracteres como máximo.
     • Contener solo caracteres alfanuméricos en minúscula o un guiones (-).
     • Comenzar con un carácter alfabético
     • Terminar con un carácter alfanumérico

   • control_plane_ips: Es una lista de una o más direcciones IPv4 para los nodos del plano de control. Los nodos del plano de control ejecutan la carga de trabajo del sistema. Por lo general, tienes una sola máquina si usas una implementación mínima, o tres máquinas si usas una implementación de alta disponibilidad (HA). Especifica una cantidad impar de nodos a fin de tener la mayoría del quórum para la alta disponibilidad. Puedes cambiar estas direcciones cada vez que actualices o actualices un clúster.

   • worker_node_ips: Es una lista de una o más direcciones IPv4 para las máquinas de nodos trabajadores.

   • control_plane_vip: La dirección IP virtual (VIP) que elegiste configurar en el balanceador de cargas para el servidor de la API de Kubernetes del clúster de usuario.

   • ingress_vip: La dirección IP que elegiste configurar en el balanceador de cargas para el proxy de entrada

   • lb_address_pools: Es una lista de mapas que define los grupos de direcciones que usará el balanceador de cargas de MetalLB. La VIP de entrada debe estar en uno de estos grupos.

   • admin_user_emails: Es una lista de direcciones de correo electrónico de los usuarios a los que se les otorgarán privilegios administrativos en el clúster. Asegúrate de agregar tu dirección de correo electrónico si deseas administrar el clúster.

   Cuando se crea el clúster, la API de Anthos On-Prem aplica las políticas de control de acceso basado en funciones (RBAC) de Kubernetes al clúster para otorgar a los usuarios administradores la función clusterrole/cluster-admin de Kubernetes, que proporciona acceso completo a todos los recursos del clúster en todos los espacios de nombres. Esto también permite a los usuarios acceder a la consola con su identidad de Google.

4. Guarda los cambios en terraform.tfvars.

5. Inicializa y crea terraform plan:

   terraform init
   

   Terraform instala las bibliotecas necesarias, como el proveedor de Google Cloud.

6. Revisa la configuración y realiza cambios si es necesario:

   terraform plan
   

7. Aplica el plan de Terraform para crear el clúster de usuario:

   terraform apply
   

   La creación del clúster de usuario tarda 15 minutos o más. Puedes ver el clúster en Google Cloud Console en la página Clústeres de Anthos.

Conecta la puerta de enlace

1. initialize la CLI de gcloud para usarla con el proyecto host de la flota o ejecuta los siguientes comandos a fin de acceder con tu Cuenta de Google, configura el proyecto host de tu flota como el predeterminado y actualiza los componentes:

   gcloud auth login
   gcloud config set project PROJECT_ID
   gcloud components update
   

2. Recupera las credenciales del clúster que se usan para interactuar con la puerta de enlace de Connect. En el siguiente comando, reemplaza MEMBERSHIP_NAME por el nombre de tu clúster. En GKE en Bare Metal, el nombre de la membresía es el mismo que el nombre del clúster.

   gcloud container fleet memberships get-credentials MEMBERSHIP_NAME
   

   Mediante este comando, se muestra una kubeconfig específica de la puerta de enlace de Connect especial con la que puedes conectarte al clúster a través de la puerta de enlace.

Una vez que tengas las credenciales necesarias, puedes ejecutar comandos mediante kubectl como lo harías con cualquier clúster de Kubernetes, y no necesitas especificar el nombre del archivo kubeconfig, por ejemplo:

kubectl get namespaces

Estación de trabajo de administrador

Usa el comando bmctl get credentials para recuperar un archivo kubeconfig para el clúster de usuario recién creado.

bmctl get credentials --cluster CLUSTER_NAME --admin-kubeconfig ADMIN_KUBECONFIG_PATH

Reemplaza lo siguiente:

• CLUSTER_NAME: Es el nombre del clúster de usuario de destino.

• ADMIN_KUBECONFIG_PATH: Es la ruta al archivo kubeconfig del clúster de administrador

Un kubeconfig con las credenciales del clúster de usuario se escribe en un archivo, bmctl-workspace/CLUSTER_NAME/CLUSTER_NAME-TIMESTAMP-kubeconfig. Los TIMESTAMP en el nombre del archivo indican la fecha y hora en que se creó el archivo.

Debido a que este archivo contiene credenciales de autenticación para tu clúster, debes almacenarlo en una ubicación segura con acceso restringido.