Crea clústeres básicos

Esta es la segunda parte de una guía en la que se explica una pequeña instalación de prueba de concepto de Google Distributed Cloud. La primera parte es Configura una infraestructura mínima, que muestra cómo planificar tus direcciones IP y configurar la infraestructura de vSphere y Google Cloud necesaria para la implementación. En este documento, se basa en la configuración y la planificación que realizaste en la sección anterior, y se muestra cómo crear una estación de trabajo de administrador, un clúster de administrador y un clúster de usuario en el entorno de vSphere con plantillas simples que puedes completar aquí en este documento. Luego, puedes implementar una aplicación.

Al igual que con la configuración de la infraestructura de esta instalación simple, es posible que los clústeres que configures mediante este documento no sean adecuados para tus necesidades de producción y casos de uso reales. Si deseas obtener más información, instrucciones y prácticas recomendadas para las instalaciones de producción, consulta las guías de instalación.

Antes de comenzar

  1. Asegúrate de haber configurado los entornos de vSphere y Google Cloud como se describe en Configura la infraestructura mínima.

  2. Si deseas usar Terraform para crear el clúster de usuario, necesitas Terraform en tu estación de trabajo de administrador o en otra computadora.

Descripción general del procedimiento

Estos son los pasos principales que implica esta configuración:

  1. Accede a Google Cloud CLI con una cuenta que tenga los permisos necesarios para crear cuentas de servicio.

  2. Recopila información que necesites para configurar Google Distributed Cloud, incluidos tu nombre de usuario y contraseña de vCenter, y las direcciones IP que preparaste en la sección anterior.

  3. Crea una estación de trabajo de administrador que tenga los recursos y las herramientas que necesitas para crear clústeres de administrador y de usuario, incluidas las cuentas de servicio adicionales que necesitas para finalizar la configuración.

  4. Crea un clúster de administrador para administrar y actualizar el clúster de usuario.

  5. Crea un clúster de usuario para ejecutar tus cargas de trabajo.

1. Accede a Google Cloud CLI

La configuración de Google Distributed Cloud requiere varias cuentas de servicio con permisos diferentes. Por lo tanto, debes acceder a Google Cloud CLI con una cuenta que tenga los permisos necesarios para crear y configurar cuentas de servicio, ya que gkeadm usa tu propiedad actual account de gcloud CLI cuando realiza esta configuración.

  1. Accede a gcloud CLI. Puedes usar cualquier Cuenta de Google, pero esta debe tener los permisos necesarios. Si seguiste la parte anterior de esta guía, es probable que ya hayas accedido con una cuenta adecuada para crear tu cuenta de servicio de acceso a los componentes.

    gcloud auth login

  2. Verifica que la propiedad account de gcloud CLI esté configurada de forma correcta:

    gcloud config list

    En el resultado, se muestra el valor de la propiedad account de tu SDK. Por ejemplo:

    [core]
account = my-name@google.com
disable_usage_reporting = False
Your active configuration is: [default]

  3. Asegúrate de tener instalados los componentes más recientes de gcloud CLI:

    gcloud components update

    Según cómo instalaste gcloud CLI, es posible que veas el siguiente mensaje: “No puedes realizar esta acción porque el administrador de componentes de Google Cloud CLI está inhabilitado para esta instalación. Puedes ejecutar el siguiente comando para obtener el mismo resultado en esta instalación:" Sigue las instrucciones para copiar y pegar el comando y actualizar los componentes.

2. Recopila información

Usa la información que preparaste en Configura la infraestructura mínima para editar los marcadores de posición en la siguiente tabla:

Detalles de vSphere
Es el nombre de usuario de tu cuenta de vCenter USERNAME
Es la contraseña de tu cuenta de vCenter PASSWORD
La dirección de vCenter Server ADDRESS
Es la ruta de acceso al certificado de AC raíz de vCenter Server en la máquina que usarás para crear tu estación de trabajo de administrador. CA_CERT_PATH
El nombre de tu centro de datos de vSphere DATA_CENTER
El nombre del clúster de vSphere VSPHERE_CLUSTER
Es el nombre o la ruta de acceso del grupo de recursos de vSphere. Para obtener más información, consulta vcenter.resourcePool. RESOURCE_POOL
El nombre del almacén de datos de vSphere DATASTORE
El nombre de tu red de vSphere NETWORK
Direcciones IP
Una dirección IP para la estación de trabajo de administrador ADMIN_WS_IP
Cuatro direcciones IP para los nodos del clúster de administrador Esto incluye una dirección para un nodo adicional que se puede usar durante la actualización. ADMIN_CONTROL_PLANE_NODE_IP_1
ADMIN_CONTROL_PLANE_NODE_IP_2
ADMIN_CONTROL_PLANE_NODE_IP_3
Una dirección IP para el nodo del plano de control en el clúster de usuario. USER_CONTROL_PLANE_NODE_IP
Cuatro direcciones IP para los nodos del clúster de usuario. Esto incluye una dirección para un nodo adicional que se puede usar durante la actualización. USER_NODE_IP_1
USER_NODE_IP_2
USER_NODE_IP_3
USER_NODE_IP_4
Una dirección IP virtual (VIP) para el servidor de la API de Kubernetes del clúster de administrador ADMIN_CONTROL_PLANE_VIP
Una VIP para el servidor de la API de Kubernetes del clúster de usuario USER_CONTROL_PLANE_VIP
Una VIP de Ingress para el clúster de usuario USER_INGRESS_VIP
Dos VIP para los objetos Service de tipo LoadBalancer en tu clúster de usuario. SERVICE_VIP_1
SERVICE_VIP_2
La dirección IP de un servidor DNS, al que se puede acceder desde la estación de trabajo de administrador y los nodos del clúster DNS_SERVER_IP
La dirección IP de un servidor NTP al que se puede acceder desde la estación de trabajo de administrador y los nodos del clúster NTP_SERVER_IP
La dirección IP de la puerta de enlace predeterminada de la subred que tiene la estación de trabajo de administrador y los nodos del clúster DEFAULT_GATEWAY_IP
La máscara de red de la subred que tiene la estación de trabajo de administrador y los nodos del clúster
Ejemplo: 255.255.255.0		 NETMASK
Si la red está detrás de un servidor proxy, la URL del servidor proxy. Para obtener más información, consulta proxy. Si es necesario, complétala de forma manual en el archivo de configuración de la estación de trabajo de administrador. PROXY_URL
Rangos CIDR para objetos Service y Pods
El clúster de administrador y el de usuario necesitan un rango de CIDR para los Services y un rango de CIDR para los Pods. Usa los siguientes valores prepropagados, a menos que necesites cambiarlos para evitar la superposición con otros elementos de tu red:
Un rango de CIDR para los objetos Service en el clúster de administrador 10.96.232.0/24
Un rango CIDR para los Pods del clúster de administrador 192.168.0.0/16
Un rango de CIDR para los objetos Service en el clúster de usuario 10.96.0.0/20
Un rango CIDR para los Pods en el clúster de usuario 192.168.0.0/16
Detalles de Google Cloud
El ID del proyecto de Cloud que elegiste PROJECT_ID
Es la ruta de acceso al archivo de claves JSON para la cuenta de servicio de acceso a los componentes que configuraste en la sección anterior, en la máquina que usarás para crear la estación de trabajo de administrador. COMPONENT_ACCESS_SA_KEY_PATH
La dirección de correo electrónico asociada con tu cuenta de Google Cloud. Por ejemplo: alex@example.com. GOOGLE_ACCOUNT_EMAIL

3. Crear una estación de trabajo de administrador

Antes de crear cualquier clúster, debes crear una estación de trabajo de administrador y, luego, conectarte a ella mediante SSH. La estación de trabajo de administrador es una VM independiente con las herramientas y los recursos que necesitas para crear clústeres de GKE Enterprise en el entorno de vSphere. Usa la herramienta de línea de comandos de gkeadm para crear la estación de trabajo de administrador.

Descarga gkeadm

Descarga gkeadm en tu directorio actual:

gsutil cp gs://gke-on-prem-release/gkeadm/1.29.0-gke.1456/linux/gkeadm ./
chmod +x gkeadm

Necesitas la versión gkeadm (que también es la versión de Google Distributed Cloud) para crear los archivos de configuración de los clústeres de administrador y de usuario. Para verificar la versión de gkeadm, ejecuta lo siguiente:

./gkeadm version

En el siguiente resultado de ejemplo, se muestra la versión.

gkeadm 1.29.0 (1.29.0-gke.1456)

Aunque puedes descargar otra versión de gkeadm, en esta guía, se da por sentado que estás instalando 1.29.0-gke.1456 y se usa esa versión en todos los archivos de configuración y comandos.

Crea tu archivo de credenciales

Crea y guarda un archivo llamado credential.yaml en tu directorio actual con el siguiente contenido:

apiVersion: v1
kind: CredentialFile
items:
- name: vCenter
  username: "USERNAME"
  password: "PASSWORD"

Crea el archivo de configuración de la estación de trabajo de administrador

Crea y guarda un archivo llamado admin-ws-config.yaml, nuevamente en tu directorio actual, con el siguiente contenido:

gcp:
  componentAccessServiceAccountKeyPath: "COMPONENT_ACCESS_SA_KEY_PATH"
vCenter:
  credentials:
    address: "ADDRESS"
    fileRef:
      path: "credential.yaml"
      entry: "vCenter"
  datacenter: "DATA_CENTER"
  datastore: "DATASTORE"
  cluster: "VSPHERE_CLUSTER"
  network: "NETWORK"
  resourcePool: "RESOURCE_POOL"
  caCertPath: "CA_CERT_PATH"
proxyUrl: ""
adminWorkstation:
  name: "minimal-installation-admin-workstation"
  cpus: 4
  memoryMB: 8192
  diskGB: 50
  dataDiskName: gke-on-prem-admin-workstation-data-disk/minimal-installation-data-disk.vmdk
  dataDiskMB: 512
  network:
    ipAllocationMode: "static"
    hostConfig:
      ip: "ADMIN_WS_IP"
      gateway: "DEFAULT_GATEWAY_IP"
      netmask: "NETMASK"
      dns:
      - "DNS_SERVER_IP"
  proxyUrl: ""
  ntpServer: ntp.ubuntu.com

Crea tu estación de trabajo de administrador

Crea tu estación de trabajo de administrador con el siguiente comando:

./gkeadm create admin-workstation --auto-create-service-accounts

Ejecuta este comando:

  • Crea tu estación de trabajo de administrador.
  • Crea automáticamente cualquier cuenta de servicio adicional que necesites para la instalación
  • Crea archivos de configuración de plantillas para los clústeres de administrador y de usuario

El resultado proporciona información detallada sobre la creación de la estación de trabajo de administrador y un comando que puedes usar para obtener una conexión SSH a la estación de trabajo de administrador. Por ejemplo:

...
Admin workstation is ready to use.
Admin workstation information saved to /usr/local/google/home/me/my-admin-workstation
This file is required for future upgrades
SSH into the admin workstation with the following command:
ssh -i /usr/local/google/home/me/.ssh/gke-admin-workstation ubuntu@172.16.20.49
********************************************************************

En el resultado anterior, la dirección IP es un ejemplo. La dirección IP de la estación de trabajo de administrador será diferente. Toma nota de la dirección IP de tu estación de trabajo de administrador. La necesitarás en el próximo paso.

Si deseas obtener más información para crear una estación de trabajo de administrador, consulta Crea una estación de trabajo de administrador.

Conéctate a la estación de trabajo de administrador

Usa el comando que se muestra en el resultado anterior para obtener una conexión SSH a tu estación de trabajo de administrador. Por ejemplo:

ssh -i /usr/local/google/home/me/.ssh/gke-admin-workstation ubuntu@172.16.20.49

Si necesitas encontrar este comando de nuevo, gkeadm genera un archivo llamado gke-admin-ws-... en el directorio de la máquina local donde ejecutaste gkeadm create admin-workstation. Contiene detalles sobre la estación de trabajo de administrador, incluido el comando SSH.

En la estación de trabajo de administrador, ingresa exit para finalizar la conexión SSH y volver a tu máquina local.

Copia la clave de registro de auditoría en la estación de trabajo de administrador

En la sección anterior, creaste un archivo de claves JSON para tu cuenta de servicio de registro de auditoría.

Copia el archivo de claves JSON en el directorio principal de la estación de trabajo de administrador. Por ejemplo, en tu máquina local, debes especificar lo siguiente:

scp -i /usr/local/google/home/me/.ssh/gke-admin-workstation audit-logging-key.json ubuntu@172.16.20.49:~

Visualiza archivos en la estación de trabajo de administrador

Una vez más, obtén una conexión SSH a la estación de trabajo de administrador.

En la estación de trabajo de administrador, enumera los archivos del directorio principal:

ls -1

El resultado debe incluir lo siguiente:

  • admin-cluster.yaml, un archivo de configuración de plantilla para crear el clúster de administrador.
  • user-cluster.yaml, un archivo de configuración de plantilla para crear el clúster de usuario.
  • El archivo de certificado de vCenter que especificaste en la configuración de la estación de trabajo de administrador
  • El archivo credential.yaml que especificaste en la configuración de la estación de trabajo de administrador.
  • El archivo de claves JSON para tu cuenta de servicio de registro de auditoría.
  • Archivos de claves JSON para dos cuentas de servicio que gkeadm creó para ti: una cuenta de servicio del registro de conexión y una cuenta de servicio de supervisión de registros, así como el archivo de claves para la cuenta de servicio de acceso a los componentes que creaste antes.

Por ejemplo:

admin-cluster.yaml
admin-ws-config.yaml
audit-logging-key.json
sa-key.json
connect-register-sa-2203040617.json
credential.yaml
log-mon-sa-2203040617.json
logs
vc01-cert.pem
user-cluster.yaml

Deberás especificar algunos de estos nombres de archivo en los archivos de configuración para crear clústeres. Usa los nombres de archivo como valores para los marcadores de posición en la siguiente tabla:

Nombre del archivo de claves de la cuenta de servicio del registro de conexión
Ejemplo: connect-register-sa-2203040617.json		 CONNECT_REGISTER_SA_KEY
Nombre del archivo de claves de la cuenta de servicio de supervisión de registros
Ejemplo: log-mon-sa-2203040617.json		 LOG_MON_SA_KEY
Nombre del archivo de claves de la cuenta de servicio del registro de auditoría
Ejemplo: audit-logging-key.json		 AUDIT_LOG_SA_KEY
Nombre del archivo de claves de la cuenta de servicio de acceso a los componentes
Ejemplo: sa-key.json		 COMPONENT_ACCESS_SA_KEY
Nombre del archivo de certificado de vCenter
Ejemplo: vc01-cert.pem		 CA_CERT_FILE

4. Crear un clúster de administrador

Ahora que tienes una estación de trabajo de administrador configurada con vCenter y otros detalles, puedes usarla para crear un clúster de administrador en el entorno de vSphere. Antes de comenzar este paso, asegúrate de tener una conexión SSH a la estación de trabajo de administrador, como se describió antes. Todos los comandos siguientes se ejecutan en la estación de trabajo de administrador.

Crea el archivo de configuración del clúster de administrador

Abre admin-cluster.yaml y reemplaza el contenido por lo siguiente:

apiVersion: v1
kind: AdminCluster
name: "minimal-installation-admin-cluster"
bundlePath: "/var/lib/gke/bundles/gke-onprem-vsphere-1.29.0-gke.1456-full.tgz"
vCenter:
  address: "ADDRESS"
  datacenter: "DATA_CENTER"
  cluster: "VSPHERE_CLUSTER"
  resourcePool: "RESOURCE_POOL"
  datastore: "DATASTORE"
  caCertPath: "CA_CERT_FILE"
  credentials:
    fileRef:
      path: "credential.yaml"
      entry: "vCenter"
network:
  hostConfig:
    dnsServers:
    - "DNS_SERVER_IP"
    ntpServers:
    - "NTP_SERVER_IP"
  serviceCIDR: "10.96.232.0/24"
  podCIDR: "192.168.0.0/16"
  vCenter:
    networkName: "NETWORK"
  controlPlaneIPBlock:
    netmask: "NETMASK"
    gateway: "DEFAULT_GATEWAY_IP"
    ips:
    - ip: "ADMIN_CONTROL_PLANE_NODE_IP_1"
      hostname: "admin-cp-vm-1"
    - ip: "ADMIN_CONTROL_PLANE_NODE_IP_2"
      hostname: "admin-cp-vm-2"
    - ip: "ADMIN_CONTROL_PLANE_NODE_IP_3"
      hostname: "admin-cp-vm-3"
loadBalancer:
  vips:
    controlPlaneVIP: "ADMIN_CONTROL_PLANE_VIP"
  kind: "MetalLB"
adminMaster:
  cpus: 4
  memoryMB: 16384
  replicas: 3
antiAffinityGroups:
  enabled: false
componentAccessServiceAccountKeyPath: "COMPONENT_ACCESS_SA_KEY"
gkeConnect:
  projectID: "PROJECT_ID"
  registerServiceAccountKeyPath: "CONNECT_REGISTER_SA_KEY"
stackdriver:
  projectID: "PROJECT_ID"
  clusterLocation: "us-central1"
  enableVPC: false
  serviceAccountKeyPath: "LOG_MON_SA_KEY"
  disableVsphereResourceMetrics: false
cloudAuditLogging:
  projectID: "PROJECT_ID"
  clusterLocation: us-central1
  serviceAccountKeyPath: "AUDIT_LOG_SA_KEY"

Valida el archivo de configuración de clústeres de administrador

Verifica que el archivo de configuración de tu clúster de administrador sea válido y se pueda usar para crear el clúster:

gkectl check-config --config admin-cluster.yaml

Importa imágenes de SO a vSphere

Ejecuta gkectl prepare con el archivo de configuración completo para importar imágenes de SO de nodo a vSphere:

gkectl prepare --config admin-cluster.yaml --skip-validation-all

Cuando ejecutas este comando, se importan las imágenes a vSphere y se marcan como plantillas de VM, incluida la imagen del clúster de administrador.

Este comando puede tardar unos minutos en mostrarse.

Crea el clúster de administrador

Crea el clúster de administrador:

gkectl create admin --config admin-cluster.yaml

Reanuda la creación del clúster de administrador después de una falla

Si la creación del clúster de administrador falla o se cancela, puedes volver a ejecutar el comando create:

gkectl create admin --config admin-cluster.yaml

Ubica el archivo kubeconfig del clúster de administrador

El comando gkectl create admin crea un archivo kubeconfig llamado kubeconfig en el directorio actual. Necesitarás este archivo kubeconfig más adelante para interactuar con tu clúster de administrador.

Verifica que el clúster de administrador esté en ejecución

Verifica que el clúster de administrador esté en ejecución:

kubectl get nodes --kubeconfig kubeconfig

En el resultado, se muestran los nodos del clúster de administrador. Por ejemplo:

admin-cp-vm-1   Ready    control-plane,master ...
admin-cp-vm-2   Ready    control-plane,master ...
admin-cp-vm-3   Ready    control-plane,master ...

Habilitar la autorización de RBAC

Para otorgar a tu cuenta de usuario el rol clusterrole/cluster-admin de Kubernetes en el clúster, ejecuta el siguiente comando:

gcloud container fleet memberships generate-gateway-rbac \
    --membership=minimal-installation-admin-cluster \
    --role=clusterrole/cluster-admin \
    --users=GOOGLE_ACCOUNT_EMAIL \
    --project=PROJECT_ID \
    --kubeconfig=kubeconfig \
    --context=minimal-installation-admin-cluster \
    --apply

El resultado de este comando es similar al siguiente, que se trunca para facilitar la lectura:

Validating input arguments.
Specified Cluster Role is: clusterrole/cluster-admin
Generated RBAC policy is:
--------------------------------------------
...
Applying the generate RBAC policy to cluster with kubeconfig: kubeconfig, context: minimal-installation-admin-cluster
Writing RBAC policy for user: GOOGLE_ACCOUNT_EMAIL to cluster.
Successfully applied the RBAC policy to cluster.

Entre otras cosas, la política de RBAC te permite acceder a tu clúster en la consola de Google Cloud mediante Google Identity para ver más detalles del clúster.

Inscripción automática en la API de GKE On-Prem

Debido a que la API de GKE On-Prem está habilitada en tu proyecto, el clúster se inscribe de forma automática en la API de GKE On-Prem. La inscripción del clúster de administrador en la API de GKE On-Prem te permite usar herramientas estándar, como la consola de Google Cloud, Google Cloud CLI o Terraform, para crear, actualizar, actualizar y borrar clústeres de usuario que administra el clúster de administrador. La inscripción del clúster también te permite ejecutar comandos de gcloud para obtener información sobre tu clúster.

5. Crea un clúster de usuario

En esta sección, se proporcionan pasos para crear el clúster de usuario mediante la consola, gkectl, Terraform o gcloud CLId.

gkectl

Asegúrate de tener una conexión SSH a la estación de trabajo de administrador, como se describió antes, antes de comenzar este procedimiento. Todos los comandos siguientes se ejecutan en la estación de trabajo de administrador.

Crea el archivo bloqueador de IP del clúster de usuario

  1. Crea un archivo llamado user-ipblock.yaml.

  2. Copia y pega el siguiente contenido en user-ipblock.yaml y guarda el archivo:

    blocks:
  - netmask: "NETMASK"
    gateway: "DEFAULT_GATEWAY_IP"
    ips:
    - ip: "USER_NODE_IP_1"
      hostname: "user-vm-1"
    - ip: "USER_NODE_IP_2"
      hostname: "user-vm-2"
    - ip: "USER_NODE_IP_3"
      hostname: "user-vm-3"
    - ip: "USER_NODE_IP_4"
      hostname: "user-vm-4"

Crea el archivo de configuración del clúster de usuario

  1. Crea un archivo llamado user-cluster.yaml en el mismo directorio que user-ipblock.yaml.

  2. Copia y pega el siguiente contenido en user-cluster.yaml y guarda el archivo:

apiVersion: v1
kind: UserCluster
name: "minimal-installation-user-cluster"
gkeOnPremVersion: "1.29.0-gke.1456"
enableControlplaneV2: true
network:
  hostConfig:
    dnsServers:
    - "DNS_SERVER_IP"
    ntpServers:
    - "NTP_SERVER_IP"
  ipMode:
    type: "static"
    ipBlockFilePath: "user-ipblock.yaml"
  serviceCIDR: "10.96.0.0/20"
  podCIDR: "192.168.0.0/16"
  controlPlaneIPBlock:
    netmask: "NETMASK"
    gateway: "DEFAULT_GATEWAY_IP"
    ips:
    - ip: "USER_CONTROL_PLANE_NODE_IP"
      hostname: "cp-vm-1"
loadBalancer:
  vips:
    controlPlaneVIP: "USER_CONTROL_PLANE_VIP"
    ingressVIP: "USER_INGRESS_VIP"
  kind: "MetalLB"
  metalLB:
    addressPools:
    - name: "uc-address-pool"
      addresses:
      - "USER_INGRESS_VIP/32"
      - "SERVICE_VIP_1/32"
      - "SERVICE_VIP_2/32"
enableDataplaneV2: true
nodePools:
- name: "uc-node-pool"
  cpus: 4
  memoryMB: 8192
  replicas: 3
  enableLoadBalancer: true
antiAffinityGroups:
  enabled: false
gkeConnect:
  projectID: "PROJECT_ID"
  registerServiceAccountKeyPath: "CONNECT_REGISTER_SA_KEY"
stackdriver:
  projectID: "PROJECT_ID"
  clusterLocation: "us-central1"
  enableVPC: false
  serviceAccountKeyPath: "LOG_MON_SA_KEY"
  disableVsphereResourceMetrics: false
autoRepair:
  enabled: true

Valida la configuración y crea el clúster

  1. Verifica que el archivo de configuración de tu clúster de usuario sea válido y se pueda usar para crear el clúster:

    gkectl check-config --kubeconfig kubeconfig --config user-cluster.yaml

  2. Crea el clúster de usuario:

    gkectl create cluster --kubeconfig kubeconfig --config user-cluster.yaml

    La creación de clústeres tarda alrededor de 30 minutos.

Ubica el archivo kubeconfig del clúster de usuario

El comando gkectl create cluster crea un archivo kubeconfig llamado USER_CLUSTER_NAME-kubeconfig en el directorio actual. Necesitarás este archivo kubeconfig más adelante para interactuar con tu clúster de usuario.

Verifica que el clúster de usuario esté en ejecución

Verifica que el clúster de usuario esté en ejecución:

kubectl get nodes --kubeconfig USER_CLUSTER_KUBECONFIG

Reemplaza USER_CLUSTER_KUBECONFIG con la ruta de tu archivo kubeconfig del clúster de usuario.

En el resultado, se muestran los nodos del clúster de usuario. Por ejemplo:

cp-vm-1     Ready    control-plane,master
user-vm-1   Ready
user-vm-2   Ready
user-vm-3   Ready

Habilitar la autorización de RBAC

Para otorgar a tu cuenta de usuario el rol clusterrole/cluster-admin de Kubernetes en el clúster, ejecuta el siguiente comando:

gcloud container fleet memberships generate-gateway-rbac \
  --membership=minimal-installation-user-cluster \
  --role=clusterrole/cluster-admin \
  --users=GOOGLE_ACCOUNT_EMAIL \
  --project=PROJECT_ID \
  --kubeconfig=USER_CLUSTER_KUBECONFIG \
  --context=minimal-installation-user-cluster \
  --apply

El resultado de este comando es similar al siguiente, que se trunca para facilitar la lectura:

Validating input arguments.
Specified Cluster Role is: clusterrole/cluster-admin
Generated RBAC policy is:
--------------------------------------------
...
Applying the generate RBAC policy to cluster with kubeconfig: kubeconfig, context: minimal-installation-admin-cluster
Writing RBAC policy for user: GOOGLE_ACCOUNT_EMAIL to cluster.
Successfully applied the RBAC policy to cluster.

Entre otras cosas, la política de RBAC te permite acceder a tu clúster en la consola de Google Cloud mediante Google Identity para ver más detalles del clúster.

Inscripción automática en la API de GKE On-Prem

Debido a que la API de GKE On-Prem está habilitada en tu proyecto, el clúster se inscribe de forma automática en la API de GKE On-Prem. Esto te permite usar la consola o gcloud CLI para ver los detalles del clúster y administrar su ciclo de vida. Por ejemplo, puedes ejecutar comandos de gcloud para obtener información sobre el clúster de usuario.

Console

  1. En la consola de Google Cloud, ve a la página Crea un clúster de GKE on VMware.

    Ir a Crea un clúster de GKE en VMware

  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.

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

Requisitos previos

  1. Familiarízate con la información de la página Requisitos previos.

  2. En la parte inferior de la página, haz clic en Siguiente.

Conceptos básicos del clúster

  1. En Nombre, ingresa un nombre para el clúster de usuario, por ejemplo, minimal-installation-user-cluster.

  2. En Clúster de administrador, selecciona minimal-installation-admin-cluster.

  3. En el campo Ubicación de la API de GCP, selecciona us-central1.

  4. En Versión, selecciona 1.29.0-gke.1456.

  5. No es necesario que abras la sección Authorization ni la sección vCenter configuration.

  6. Haz clic en Siguiente.

Plano de control

  1. En IP de nodo del plano de control, para Puerta de enlace, ingresa DEFAULT_GATEWAY_IP.

  2. En Máscara de subred, ingresa NETMASK.

  3. En Direcciones IP, para Dirección IP 1, ingresa USER_CONTROL_PLANE_NODE_IP. Deja Nombre de host 1 en blanco.

  4. Haz clic en Siguiente.

Herramientas de redes

En esta sección, debes especificar las direcciones IP para los nodos, los Pods y los objetos Service del clúster. Un clúster de usuario debe tener una dirección IP para cada nodo y una dirección IP adicional para un nodo temporal que se necesita durante las actualizaciones del clúster, las actualizaciones y las reparaciones automáticas. Para obtener más información, consulta ¿Cuántas direcciones IP necesita un clúster de usuario?

  1. En IP de nodo trabajador, para Modo IP, asegúrate de que esté seleccionado Estática.

  2. En Puerta de enlace, ingresa DEFAULT_GATEWAY_IP.

  3. En Máscara de subred, ingresa NETMASK.

  4. En Direcciones IP, ingresa estas direcciones:

  • USER_NODE_IP_1
  • USER_NODE_IP_2
  • USER_NODE_IP_3
  • USER_NODE_IP_4

Deja en blanco los campos Nombre de host.

  1. En CIDR del servicio, ingresa 10.96.0.0/20. En CIDR del pod, ingresa 192.168.0.0/16.

  2. En Servidor DNS 1, ingresa DNS_SERVER_IP.

  3. En Servidor NTP 1, ingresa NTP_SERVER_IP.

  4. Deja en blanco el campo Dominio de búsqueda de DNS.

  5. Haz clic en Siguiente.

Balanceador de cargas

  1. En Tipo de balanceador de cargas, selecciona Bundled with MetalLB.

  2. En Grupos de direcciones, usa el nombre predeterminado.

  3. En Direcciones IP, para Rango de direcciones IP 1, ingresa USER_INGRESS_VIP/32.

    Haz clic en Agregar rango de direcciones IP. En Rango de direcciones IP 1, ingresa SERVICE_VIP_1/32.

    Haz clic en Agregar rango de direcciones IP. En Rango de direcciones IP 2, ingresa SERVICE_VIP_2/32.

  4. En Asignación de direcciones IP, selecciona Automática.

  5. Deja desmarcada la opción Evitar direcciones IP con errores.

  6. En IP virtuales, en VIP del plano de control, ingresa USER_CONTROL_PLANE_VIP. La VIP de Ingress ya está completada.

  7. Haz clic en Continuar.

Funciones

  1. Deja todos los valores predeterminados.

  2. Haz clic en Siguiente.

Grupos de nodos

  1. Deja todos los valores predeterminados.

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

    Si se produce un error cuando se verifica la configuración, la consola mostrará un mensaje de error que debe ser lo suficientemente claro como para solucionar el problema de configuración y volver a crear el clúster.

    Para obtener más información sobre los posibles errores y cómo corregirlos, consulta Soluciona problemas de clústeres inscritos en la API de GKE On-Prem.

Terraform

En esta sección, se muestra cómo crear un clúster de usuario y un grupo de nodos con Terraform. Para obtener más información y otros ejemplos, consulta los siguientes vínculos:

  1. Crea un directorio y un archivo nuevo dentro de ese directorio. El nombre del archivo debe tener la extensión .tf. En esta guía, el archivo se llama main.tf.

    mkdir DIRECTORY && cd DIRECTORY && touch main.tf

  2. Verifica el recurso de Terraform del clúster de usuario:

    El siguiente ejemplo de recurso de Terraform se completa con los valores que ingresaste en la tabla de planificación en la sección anterior.

    resource "google_gkeonprem_vmware_cluster" "cluster-basic" {
  name = "minimal-installation-user-cluster"
  project = "PROJECT_ID"
  location = "us-central1"
  admin_cluster_membership = "projects/PROJECT_ID/locations/global/memberships/minimal-installation-admin-cluster"
  description = "User cluster config with MetalLB, static IPs, and Controlplane V2"
  enable_control_plane_v2 = "true"
  on_prem_version = "1.29.0-gke.1456"
  control_plane_node {
    cpus = 4
    memory = 8192
    replicas = 1
  }
  network_config {
    service_address_cidr_blocks = ["10.96.0.0/20"]
    pod_address_cidr_blocks = ["192.168.0.0/16"]
    host_config {
      dns_servers = ["DNS_SERVER_IP"]
      ntp_servers = ["NTP_SERVER_IP"]
    }
    static_ip_config {
      ip_blocks {
        netmask = "NETMASK"
        gateway = "DEFAULT_GATEWAY_IP"
        ips {
          ip = "USER_NODE_IP_1"
          hostname = "user-vm-1"
        }
        ips {
          ip = "USER_NODE_IP_2"
          hostname = "user-vm-2"
        }
        ips {
          ip = "USER_NODE_IP_3"
          hostname = "user-vm-3"
        }
        ips {
          ip = "USER_NODE_IP_4"
          hostname = "user-vm-4"
        }
      }
    }
    control_plane_v2_config {
      control_plane_ip_block {
        netmask = "NETMASK"
        gateway = "DEFAULT_GATEWAY_IP"
        ips {
          ip = "USER_CONTROL_PLANE_NODE_IP"
          hostname = "cp-vm-1"
        }
      }
    }
  }
  load_balancer {
    vip_config {
      control_plane_vip = "USER_CONTROL_PLANE_VIP"
      ingress_vip = "USER_INGRESS_VIP"
    }
    metal_lb_config {
      address_pools {
        pool = "uc-address-pool"
        manual_assign = "true"
        addresses = ["USER_INGRESS_VIP/32", "SERVICE_VIP_1/32", "SERVICE_VIP_2/32"]
      }
    }
  }
  authorization {
    admin_users {
    username = "GOOGLE_ACCOUNT_EMAIL"
  }
}
  provider = google-beta
}

resource "google_gkeonprem_vmware_node_pool" "my-node-pool-1" {
  name = "uc-node-pool"
  project = "PROJECT_ID"
  vmware_cluster = "minimal-installation-user-cluster"
  location = "us-central1"
  config {
    replicas = 3
    image_type = "ubuntu_containerd"
    enable_load_balancer = "true"
  }
  depends_on = [
    google_gkeonprem_vmware_cluster.cluster-basic
  ]
  provider = google-beta
}

  3. Copia el recurso de Terraform en main.tf y guarda el archivo.

  4. Inicializa y crea terraform plan:

    terraform init

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

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

    terraform plan

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

    terraform apply

    Cuando se te solicite, ingresa yes.

    La creación del clúster de usuario básico y el grupo de nodos tarda alrededor de 15 minutos (o más, según tu red).

gcloud

Crea el clúster:

gcloud container vmware clusters create minimal-installation-user-cluster \
  --project=PROJECT_ID \
  --admin-cluster-membership=projects/PROJECT_ID/locations/global/memberships/minimal-installation-admin-cluster \
  --location=us-central1 \
  --version=1.29.0-gke.1456 \
  --admin-users=GOOGLE_ACCOUNT_EMAIL \
  --service-address-cidr-blocks=10.96.0.0/20 \
  --pod-address-cidr-blocks=192.168.0.0/16 \
  --metal-lb-config-address-pools='pool=uc-address-pool,avoid-buggy-ips=False,manual-assign=False,addresses=USER_INGRESS_VIP/32;SERVICE_VIP_1/32;SERVICE_VIP_2/32' \
  --control-plane-vip=USER_CONTROL_PLANE_VIP \
  --ingress-vip=USER_INGRESS_VIP \
  --static-ip-config-ip-blocks='gateway=DEFAULT_GATEWAY_IP,netmask=NETMASK,ips=USER_NODE_IP_1;USER_NODE_IP_2;USER_NODE_IP_3;USER_NODE_IP_4' \
  --dns-servers=DNS_SERVER_IP \
  --ntp-servers=NTP_SERVER_IP \
  --enable-control-plane-v2 \
  --enable-dataplane-v2 \
  --control-plane-ip-block='gateway=DEFAULT_GATEWAY_IP,netmask=NETMASK,ips=USER_CONTROL_PLANE_NODE_IP'

El resultado del comando es similar al siguiente:

Waiting for operation [projects/example-project-12345/locations/us-central1/operations/operation-1679543737105-5f7893fd5bae9-942b3f97-75e59179] to complete.

En el resultado de ejemplo, la string operation-1679543737105-5f7893fd5bae9-942b3f97-75e59179 es la OPERATION_ID de la operación de larga duración. Puedes averiguar el estado de la operación con el siguiente comando:

gcloud container vmware operations describe OPERATION_ID \
  --project=PROJECT_ID \
  --location=us-central1

Para obtener más información, consulta gcloud container vmware operations.

La creación del clúster de usuario tarda 15 minutos o más. Puedes ver el clúster en la consola en la página de descripción general de los clústeres de Google Kubernetes Engine.

Crea un grupo de nodos:

gcloud container vmware node-pools create  uc-node-pool \
  --cluster=minimal-installation-user-cluster \
  --project=PROJECT_ID \
  --location=us-central1 \
  --image-type=ubuntu_containerd  \
  --boot-disk-size=40 \
  --cpus=4 \
  --memory=8192 \
  --replicas=3 \
  --enable-load-balancer

¿Qué sigue?

Completaste la instalación mínima de Google Distributed Cloud. Como seguimiento opcional, puedes ver la instalación en acción si implementas una aplicación.