En esta página, se describe cómo crear un clúster de administrador mediante Google Cloud Console o Google Cloud CLI (gcloud CLI). Ambos clientes estándar de Google Cloud usan la API de Anthos On-Prem para crear el clúster.
¿Qué es la API de Anthos On-Prem?
La API de Anthos On-Prem es una API alojada en Google Cloud que te permite administrar el ciclo de vida de los clústeres locales mediante Terraform y las aplicaciones estándar de Google Cloud. La API de Anthos On-Prem se ejecuta en la infraestructura de Google Cloud. Terraform, la consola y gcloud CLI son clientes de la API y la usan para crear clústeres en tu centro de datos.
Para administrar el ciclo de vida de los clústeres, la API de Anthos On-Prem debe almacenar los metadatos sobre el estado del clúster en Google Cloud mediante la región de Google Cloud que especifiques cuando crees el clúster. Estos metadatos permiten que la API administre el ciclo de vida del clúster y no incluye datos específicos de la carga de trabajo.
Cuando creas un clúster con un cliente de la API de Anthos On-Prem, especificas un proyecto de Google Cloud. Después de crear el clúster, se registra automáticamente en la flota del proyecto especificado. Este proyecto se conoce como proyecto host de flota. El proyecto host de la flota no se puede cambiar después de que se crea el clúster.
Si lo prefieres, puedes crear un clúster de administrador si creas un archivo de configuración de clúster de administrador y usas bmctl
, como se describe en Crea un clúster de administrador.
Si deseas usar la consola o gcloud CLI para administrar el ciclo de vida de los clústeres que se crearon con bmctl
, consulta Configura clústeres para que los administre la API de Anthos On-Prem.
Permisos de IAM
Si no eres propietario de un proyecto de Google Cloud, debes tener uno que te otorgue las siguientes funciones:
Si quieres acceder a las páginas de Anthos y Google Kubernetes Engine en la consola, también debes tener roles/container.viewer.
Para obtener información sobre cómo otorgar roles, consulta Administración del acceso a proyectos, carpetas y organizaciones.
Acceso a la línea de comandos
Después de crear el clúster, si deseas usar la puerta de enlace de Connect para ejecutar comandos kubectl
en el clúster en computadoras que no sean la estación de trabajo de administrador, instala las siguientes herramientas de línea de comandos en la computadora que planeas usar.
La versión más reciente de la CLI de gcloud
kubectl
para ejecutar comandos en clústeres de Kubernetes. Si necesitas instalarkubectl
, sigue estas instrucciones
Elige el cliente para crear el clúster de administrador
Puedes usar la consola o gcloud CLI para crear un clúster de administrador que esté administrado por la API de Anthos On-Prem. Si es la primera vez que instalas clústeres de Anthos alojados en Bare Metal, es posible que la consola sea más fácil de usar que gcloud CLI.
Una vez que estés más familiarizado con la información que debes proporcionar para crear clústeres, gcloud CLI podría ser más conveniente porque puedes guardar el comando con sus argumentos en un archivo de texto. Si usas una herramienta de CI/CD, como Cloud Build, puedes usar los comandos de gcloud
para crear un clúster y especificar la marca --impersonate-service-account
a fin de automatizar la creación.
Requisitos previos
Consola
En la consola de Google Cloud, ve a la página Clústeres de Anthos.
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.
Haz clic en Crear clúster.
En el cuadro de diálogo, haz clic en Local.
Junto a Bare metal, haz clic en Configure. Asegúrate de que la opción Crear un clúster de administrador esté seleccionada.
En la página Requisitos, se muestran los requisitos para tu estación de trabajo de administrador y las máquinas de nodo del clúster. El planificador de direcciones IP en la sección Requisitos de red te ayuda a planificar las direcciones IP necesarias para una instalación mínima de un clúster de administrador y de usuario.
Requisitos de la estación de trabajo de administrador
Expande esta sección para mostrar los requisitos de hardware, sistema operativo y conectividad de la estación de trabajo de administrador.
Requisitos previos para la máquina del nodo del clúster
Expande esta sección para mostrar los requisitos de hardware, sistema operativo y conectividad de las máquinas de nodo del clúster.
Requisitos de red
En esta sección, podrás planificar las direcciones IP que necesitas para un entorno mínimo. De manera opcional, en la sección IP de nodo y direcciones IP virtuales, puedes proporcionar una dirección IP de nodo inicial y una dirección IP virtual (VIP), y la consola mostrará una tabla de direcciones IP que necesitas. Estas direcciones IP no se aplican a la configuración del clúster de administrador. Se diseñaron como una guía que te ayuda a planificar las direcciones IP que necesitas para la instalación. Puedes descargar la tabla en un archivo CSV y, luego, importarla a una hoja de cálculo o una herramienta de planificación de direcciones IP para usarla como punto de partida a fin de hacer un seguimiento de las direcciones IP necesarias para tus clústeres.
Revisa los recursos de Google Cloud:
Asegúrate de que las APIs de Google obligatorias estén habilitadas en el proyecto host de la flota. Además, debes habilitar la API de Anthos On-Prem:
gcloud services enable --project FLEET_HOST_PROJECT_ID \ gkeonprem.googleapis.com
Reemplaza FLEET_HOST_PROJECT_ID
por el ID del proyecto host de la flota.
Antes de crear el clúster, ejecuta el comando bmctl register bootstrap
en la estación de trabajo de administrador, como se describe en Prepara el entorno de arranque. Este comando puede crear las cuentas de servicio necesarias con los permisos de IAM mínimos necesarios para crear el clúster de administrador.
Si lo prefieres, puedes configurar las cuentas de servicio de forma manual.
Cuando estés listo para comenzar, haz clic en Instalar el entorno de arranque en la barra de navegación izquierda.
CLI de gcloud
Requisitos previos de hardware, redes y sistema operativo
La creación de un clúster de administrador mediante un cliente de la API de Anthos On-Prem requiere los mismos requisitos de hardware, herramientas de redes y del sistema operativo que se usan para crear el clúster mediante bmctl
. Para obtener más detalles, consulta los Requisitos previos de instalación.
APIs de Google obligatorias
Asegúrate de que las APIs de Google obligatorias estén habilitadas en el proyecto host de la flota. Además, debes habilitar la API de Anthos On-Prem:
gcloud services enable --project FLEET_HOST_PROJECT_ID \ gkeonprem.googleapis.com
Reemplaza FLEET_HOST_PROJECT_ID
por el ID del proyecto host de la flota.
Permisos y cuentas de servicio obligatorios
Antes de crear el clúster, ejecuta el comando bmctl register bootstrap
en la estación de trabajo de administrador, como se describe en Prepara el entorno de arranque. Este comando puede crear las cuentas de servicio necesarias con los permisos de IAM mínimos necesarios para crear el clúster de administrador.
Si lo prefieres, puedes configurar las cuentas de servicio de forma manual.
Planifica direcciones IP
Antes de crear el clúster de administrador, debes planificar las direcciones IP para tus clústeres. Revisa Planifica tus direcciones IP para ver un ejemplo de cómo asignar direcciones IP para un clúster de administrador de alta disponibilidad (HA) y dos clústeres de usuario con alta disponibilidad. Incluso si usarás gcloud CLI para crear el clúster de administrador, recomendamos que sigas los pasos de la consola de esta sección para usar el planificador de direcciones IP.
Prepara el entorno de arranque
Antes de crear el clúster de administrador, debes ejecutar el comando bmctl register bootstrap
en la estación de trabajo de administrador. Este comando implementa un clúster de Kubernetes en Docker (similares) en la estación de trabajo de administrador. Este clúster de arranque aloja los controladores de Kubernetes necesarios para crear el clúster de administrador. Cuando creas el clúster de administrador, los controladores en el clúster de arranque aprovisionarán nodos, ejecutarán comprobaciones previas y registrarán el clúster de administrador en la flota. El clúster de arranque se borra de forma automática después de que se crea el clúster de forma correcta.
Consola
Ingresa un Nombre para el clúster de administrador. Ten en cuenta que el nombre del clúster de arranque se deriva cuando se antepone boot- al nombre del clúster de administrador.
Selecciona los clústeres de Anthos alojados en Bare Metal de tu clúster de administrador.
En el campo Ubicación de la API de Google Cloud, selecciona la región de Google Cloud de la lista. En 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 que necesita la API de Anthos On-Prem 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 identifican de forma única el clúster en Google Cloud.
La consola muestra los comandos que necesitas para ejecutar en tu estación de trabajo de administrador. La herramienta de línea de comandos de
bmctl
debe coincidir con la versión del clúster que creas. Si ya descargaste la versión debmctl
aplicable en tu estación de trabajo de administrador, no es necesario que vuelvas a descargarla.
CLI de gcloud
Asegúrate de tener la versión más reciente de la CLI de gcloud, incluidos los componentes beta de gcloud CLI.
Si aún no tienes los componentes beta, ejecuta el siguiente comando para instalarlos:
gcloud components install beta
Actualiza los componentes de gcloud CLI, si es necesario:
gcloud components update
Ejecuta el siguiente comando para acceder con tu Cuenta de Google:
gcloud auth login
Enumera los clústeres de Anthos disponibles en las versiones de equipos físicos que puedes instalar. La versión de
bmctl
que descargues para crear el entorno de arranque debe coincidir con la versión que instalarás en el clúster de administrador.gcloud beta container bare-metal admin-clusters query-version-config \ --location=REGION
Reemplaza
REGION
por la región de Google Cloud en la que se ejecuta la API de Anthos On-Prem. Especificaus-west1
o una región compatible.
Crea el clúster de arranque
Realiza los siguientes pasos en la estación de trabajo de administrador. Estos comandos se muestran en la consola.
Configura tus credenciales de usuario como Credenciales predeterminadas de la aplicación (ADC):
gcloud auth application-default login
Sigue las indicaciones a fin de seleccionar tu Cuenta de Google para ADC.
Si es necesario, descarga la herramienta de línea de comandos de
bmctl
en el directorio de trabajo actual.gsutil cp gs://anthos-baremetal-release/bmctl/VERSION/linux-amd64/bmctl . chmod a+x ./bmctl
Reemplaza
VERSION
por la versión de clústeres de Anthos alojados en Bare Metal que deseas instalar. Si copiaste el comando de la consola, la versión ya está en el comando.Crea el clúster de arranque. Puedes permitir que
bmctl
cree las cuentas de servicio (SA) requeridas, o puedes crear las cuentas de servicio y los archivos de claves por tu cuenta, y pasarlos al comandobmctl register bootstrap
.
bmctl
crea SA
Usa el siguiente comando si deseas que bmctl
cree las cuentas de servicio necesarias con los permisos mínimos requeridos para crear el clúster de administrador. Este comando supone que bmctl
está en el directorio de trabajo actual.
./bmctl register bootstrap \ --ssh-key=YOUR_PRIVATE_KEY \ --name=bootstrap-ADMIN_CLUSTER_NAME \ --project-id=FLEET_HOST_PROJECT_ID
Reemplaza lo siguiente:
YOUR_PRIVATE_KEY
: Es la ruta a tu Llave SSH privada. Creaste la Llave SSH cuando configuraste el acceso SSH raíz a los nodos.
Si copiaste el comando que se muestra en la consola, ya se completaron los siguientes campos.
ADMIN_CLUSTER_NAME
: Es el nombre del clúster de administrador. El formato del nombre del clúster de arranque debe serbootstrap-ADMIN_CLUSTER_NAME
.FLEET_HOST_PROJECT_ID
: Es el proyecto en el que se registrará automáticamente el clúster de administrador después de su creación.
El comando bmctl register bootstrap
crea las siguientes cuentas de servicio.
Las claves de la cuenta de servicio se almacenan en el directorio
bmctl-workspace/.sa-keys
.
Cuenta de servicio | Purpose | Roles de IAM |
---|---|---|
Anthos-baremetal-gcr | Anthos alojado en Bare Metal usa esta cuenta de servicio para descargar imágenes de contenedor de Google Container Registry. | Ninguna |
anthos-baremetal-connect | El agente de Connect usa esta cuenta de servicio para mantener una conexión entre tu clúster y Google Cloud | roles/gkehub.connect |
anthos-baremetal-register | El agente de Connect usa esta cuenta de servicio para registrar tus clústeres en la flota de Google Cloud. | roles/gkehub.admin |
anthos-baremetal-cloud-ops | El agente de Stackdriver usa esta cuenta de servicio para exportar registros y métricas de clústeres a Cloud Logging y Cloud Monitoring. |
roles/logging.logWriter roles/monitoring.metricWriter roles/stackdriver.resourceMetadata.writer roles/opsconfigmonitoring.resourceMetadata.writer roles/monitoring.dashboardEditor |
Especifica los archivos de claves de SA
Si lo prefieres, puedes pasar bmctl
a los archivos de claves de cuenta de servicio que creaste. El siguiente comando usa los nombres de archivo de claves en Configura cuentas de servicio de forma manual y supone que bmctl
y los archivos de claves se encuentran en el directorio de trabajo actual.
./bmctl register bootstrap \ --ssh-key=YOUR_PRIVATE_KEY \ --name=bootstrap-ADMIN_CLUSTER_NAME \ --project-id=FLEET_HOST_PROJECT_ID \ --gcr-service-account-key=anthos-baremetal-gcr.json \ --gke-agent-service-account-key=connect-agent.json \ --gke-register-service-account-key=connect-register.json \ --cloud-operation-service-account-key=anthos-baremetal-cloud-ops.json
Reemplaza lo siguiente:
YOUR_PRIVATE_KEY
: Es la ruta a tu Llave SSH privada. Creaste la Llave SSH cuando configuraste el acceso SSH raíz a los nodos.ADMIN_CLUSTER_NAME
: Es el nombre del clúster de administrador. El formato del nombre del clúster de arranque debe serbootstrap-ADMIN_CLUSTER_NAME
.FLEET_HOST_PROJECT_ID
: Es el proyecto en el que se registrará automáticamente el clúster de administrador después de su creación.
Las siguientes marcas especifican la ruta a los archivos de claves:
-gcr-service-account-key
: Es la ruta al archivo de claves para la cuenta de servicio que extrae las imágenes del contenedor (anthos-baremetal-gcr).--gke-agent-service-account-key
: Es la ruta de acceso al archivo de claves para la cuenta de servicio del agente de Connect (anthos-baremetal-connect).--gke-register-service-account-key
: Es la ruta al archivo de claves para la cuenta de servicio del agente de Connect que registra el clúster en la flota (anthos-baremetal-register).--cloud-operation-service-account-key
: Es la ruta al archivo de claves para que la cuenta de servicio audite los registros y supervise los proyectos (anthos-baremetal-cloud-ops).
Después de que bmctl
cree correctamente el clúster de arranque, verás un resultado similar al siguiente:
[2023-03-22 17:35:24+0000] Waiting for the temporary cluster to be registered... OK [2023-03-22 17:35:37+0000] Please go to https://console.cloud.google.com/home/dashboard?project=example-project-12345 to create the cluster [2023-03-22 17:35:37+0000] Waiting for preflight checks and cluster to run..
Crea el clúster de administrador
Consola
En la página Instalar entorno de arranque, haz clic en Verificar conexión.
Si se realiza de forma correcta, la consola mostrará
Conexión establecida.La conexión al clúster de arranque debe establecerse antes de continuar. Si no se establece la conexión, verifica los argumentos que especificaste en el comando
bmctl register bootstrap
:Asegúrate de que el valor de
--name
coincida con el Nombre de arranque derivado que se muestra en la sección Aspectos básicos del entorno de arranque.Asegúrate de que el valor de
--project-id
coincida con el ID del proyecto que seleccionaste en la consola.
Si necesitas cambiar el nombre del clúster de arranque o el ID del proyecto, ingresa
Ctrl-C
para salir debmctl register bootstrap
y volver a ejecutar el comando.Haz clic en Siguiente para comenzar a configurar el clúster de administrador. La mayor parte de la configuración de la consola corresponde a los campos del archivo de configuración del clúster.
En Configuración de nodo, ingresa un valor entre 64 y 250 en Máximo de pods por nodo, o acepta el valor predeterminado, 110. Después de crear el clúster, no puedes actualizar este valor.
La cantidad máxima de pods por nodo (denominada densidad de pod) también está limitada por los recursos de IP disponibles del clúster. Para obtener más información, consulta Herramientas de redes de Pods.
Haz clic en Siguiente.
En la página Herramientas de redes, define la forma en que los nodos y los componentes del clúster se comunican entre sí y con el plano de control de Kubernetes.
Para obtener información detallada, mantén el puntero sobre el
junto a cada campo.Haz clic en Verificar y crear.
La consola mostrará los mensajes de estado mientras verifica la configuración y crea el clúster en su centro de datos.
Si hay un problema con la configuración, la consola muestra un mensaje de error que debe ser lo suficientemente claro para que puedas solucionar el problema de configuración y volver a intentar crear el clúster.
CLI de gcloud
Antes de crear el clúster de administrador, confirma que el clúster de arranque se haya registrado como miembro de la flota:
gcloud container fleet memberships list \ --project=FLEET_HOST_PROJECT_ID
Si el clúster de arranque no aparece en la lista, verifica el nombre del clúster de arranque y el ID del proyecto que especificaste en bmctl register bootstrap
. Si necesitas cambiar el nombre del clúster de arranque o el ID del proyecto, ingresa Ctrl-C
para salir de bmctl register bootstrap
y volver a ejecutar el comando.
Usa el siguiente comando para crear un clúster de administrador:
gcloud beta container bare-metal admin-clusters create
La mayoría de las marcas que especificas en el comando corresponden a los campos del archivo de configuración del clúster de usuario.
Para crear un clúster de administrador con el balanceador de cargas en paquetes, haz lo siguiente:
gcloud beta container bare-metal admin-clusters create ADMIN_CLUSTER_NAME \ --project=FLEET_HOST_PROJECT_ID \ --location=REGION \ --version=VERSION \ --max-pods-per-node=MAX_PODS_PER_NODE \ --control-plane-vip=CONTROL_PLANE_VIP \ --control-plane-load-balancer-port=CONTROL_PLANE_LOAD_BALANCER_PORT \ --control-plane-node-configs 'CONTROL_PLANE_NODE_CONFIG' \ --island-mode-service-address-cidr-blocks=SERVICE_ADDR_CIDR \ --island-mode-pod-address-cidr-blocks=POD_ADDR_CIDR \ --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
Si quieres usar el balanceo de cargas manual, agrega --enable-manual-lb
al comando.
Reemplaza lo siguiente:
ADMIN_CLUSTER_NAME
: Es el nombre del clúster de administrador. No se puede cambiar el nombre después de que se crea el clúster.FLEET_HOST_PROJECT_ID
: Es el proyecto en el que se registrará automáticamente el clúster de administrador después de su creación. El proyecto host de la flota no se puede cambiar después de que se crea el clúster.REGION
: Es la región de Google Cloud en la que se ejecuta la API de Anthos On-Prem. Especificaus-west1
o una región compatible. No se puede cambiar la región después de que se crea el clúster. Esta configuración especifica la región en la que se almacenan los siguientes elementos:- Los metadatos del clúster que necesita la API de Anthos On-Prem 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 identifican de forma única el clúster en Google Cloud.
VERSION
: Son los clústeres de Anthos alojados en Bare Metal. La versión debe coincidir con la versión debmctl
que usaste para ejecutarbmctl register bootstrap
. Para verificar la versiónbmctl
, ejecutabmctl version
en la estación de trabajo de administrador.MAX_PODS_PER_NODE
: En los clústeres de administrador, los valores permitidos son 32-250 y 64-250 para los clústeres sin alta disponibilidad. El valor predeterminado si--max-pods-per-node
no se incluye en el comando es 110. Después de crear el clúster, este valor no se puede actualizar.La cantidad máxima de Pods por nodo (denominada densidad del Pod) también está limitada por los recursos de IP disponibles del clúster. Para obtener más información, consulta Herramientas de redes de Pods.
CONTROL_PLANE_VIP
: La IP virtual (VIP) en el balanceador de cargas para el servidor de la API de Kubernetes del clúster. Incluye la VIP del plano de control en la misma subred que los nodos del balanceador de cargas. No incluyas la VIP del plano de control en los grupos de direcciones del balanceador de cargas.CONTROL_PLANE_LOAD_BALANCER_PORT
: Es el puerto en el que el balanceador de cargas entrega el plano de control. Aunque puedes configurar otro valor, el puerto443
es el puerto estándar que se usa para las conexiones HTTPS.CONTROL_PLANE_NODE_CONFIG
: La dirección IPv4 de un nodo del plano de control. Los nodos del plano de control ejecutan la carga de trabajo del sistema. Especifica esta marca para cada nodo del plano de control. 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 un quórum de mayoría para la HA. Puedes cambiar estas direcciones cada vez que actualices o actualices el clúster.El valor de la marca tiene el siguiente formato:
'node-ip=CP_IP_ADDRESS_1,labels=CP_KEY_1.1=CP_VALUE_1.1;CP_KEY_1.2=CP_VALUE_1.2;...' \
El valor tiene segmentos que comienzan con las palabras clave
node-ip
ylabels
. Separe cada segmento con una coma.node-ip
: La dirección IP de un nodo del plano de control. Solo puedes especificar unnode-ip
por marca. Si necesitas especificar más de un nodo, incluye la marca nuevamente para cada nodo.labels
: Uno o más pares clave=valor adjuntos al nodo.
Ten en cuenta las siguientes reglas de sintaxis:
- Rodea el valor completo con comillas simples.
- No se permiten los espacios en blanco.
- Separa cada par clave-valor en el segmento
labels
con un punto y coma.
Por ejemplo:
--control-plane-node-configs 'node-ip=192.0.2.1' \ --control-plane-node-configs 'node-ip=192.0.2.2,labels=key2.1=value2.1' \ --control-plane-node-configs 'node-ip=192.0.2.3,labels=key3.1=value3.1;key3.2=value3.2' \
SERVICE_ADDR_CIDR
: Es un rango de direcciones IPv4, en formato CIDR, para los objetos Service de tu clúster. El rango CIDR debe estar entre /24 y /12, donde /12 proporciona la mayor cantidad de direcciones IP. Te recomendamos que uses un rango en el espacio de direcciones IP para Internet privada, definido en RFC 1918, por ejemplo,172.26.232.0/24
.POD_ADDR_CIDR
: Es un rango de direcciones IPv4, en formato CIDR, que se usará para los Pods en el clúster de usuario. El rango CIDR debe estar entre /18 y /8, donde /8 proporciona la mayor cantidad de direcciones IP. Te recomendamos que uses un rango en el espacio de direcciones IP para Internet privada, definido en RFC 1918, por ejemplo,192.168.0.0/16
.
Debes especificar las siguientes marcas de almacenamiento. El comando de ejemplo incluye valores típicos. Para obtener más información, consulta Configura el almacenamiento local.
--lvp-share-path
: Esta es la ruta de acceso de la máquina anfitrión en la que se pueden crear subdirectorios. Se crea un PersistentVolume local (PV) para cada subdirectorio.--lvp-share-storage-class
: Esta es la StorageClass que se usará para crear volúmenes persistentes. StorageClass se crea durante la creación del clúster.--lvp-node-mounts-config-path
: Esta es la ruta de acceso de la máquina anfitrión en la que se pueden descubrir los discos activados. Se crea un PersistentVolume local (PV) para cada activación.--lvp-node-mounts-config-storage
: Es la clase de almacenamiento con la que se crean los PV durante la creación del clúster.
Para obtener una lista completa de las marcas y sus descripciones, consulta la referencia de la CLI de gcloud.
El resultado del comando es similar al siguiente:
Waiting for operation [projects/example-project-12345/locations/us-west1/operations/operation-1679543737105-5f7893fd5bae9-942b3f97-75e59179] to complete.
En el resultado de ejemplo, la string operation-1679543737105-5f7893fd5bae9-942b3f97-75e59179
es el OPERATION_ID
de la operación de larga duración. Para averiguar el estado de la operación, usa el siguiente comando:
gcloud beta container bare-metal operations describe OPERATION_ID \ --project=FLEET_HOST_PROJECT_ID \ --location=REGION
Para obtener más información, consulta gcloud beta container Bare-metal operations.
Corrige los errores de la comprobación previa
Antes de crear el clúster, bmctl
ejecuta una serie de verificaciones previas para verificar la configuración. Si hay un problema con la configuración, el comando gcloud ... create
se cierra con un error similar al siguiente:
ERROR: (gcloud.alpha.container.bare-metal.admin-clusters.create) Invalid resource state for "projects/694677185633/locations/us-west1/bareMetalAdminClusters/abm-cluster-1": cluster preflight checks failed
Por ejemplo, supongamos que falló una verificación previa porque no se pudo acceder al nodo del plano de control. En la estación de trabajo de administrador, verás algo similar a lo siguiente:
[2023-03-27 20:34:38+0000] Waiting for preflight check job to finish... OK [2023-03-27 20:35:58+0000] - Validation Category: machines and network [2023-03-27 20:35:58+0000] - [PASSED] pod-cidr [2023-03-27 20:35:58+0000] - [FAILED] node-network (log: bmctl-workspace/log/register-bootstrap-20230327-201548/node-network) [2023-03-27 20:35:58+0000] - Failed to connect to the host via ssh: ssh: connect to host 10.100.0.5 port 22: Connection timed out [2023-03-27 20:35:58+0000] Flushing logs... OK [2023-03-27 20:35:58+0000] Error polling the preflight check abm-cluster-mar-27 in the cluster-abm-cluster-mar-27: preflight check failed
En la estación de trabajo de administrador, asegúrate de que el proceso
bmctl register bootstrap
aún se esté ejecutando. Si no es así, vuelve a ejecutar el comando con los mismos argumentos y agrega la marca--reuse-bootstrap-cluster=true
.Ejecuta
gcloud ... update
para corregir la dirección IP no válida:gcloud beta container bare-metal admin-clusters update ADMIN_CLUSTER_NAME \ --project=FLEET_HOST_PROJECT_ID \ --location=REGION \ --control-plane-node-configs 'node-ip=NEW_NODE_ID_ADDRESS'
Para obtener más información, consulta gcloud beta container bare-metal admin-clusters update.
Los detalles del proceso de creación del clúster se muestran en tu estación de trabajo de administrador. Si se aprueban las verificaciones previas, verás algo como lo siguiente:
[2023-03-22 23:12:47+0000] Waiting for cluster kubeconfig to become ready OK [2023-03-22 23:15:47+0000] Writing kubeconfig file [2023-03-22 23:15:47+0000] kubeconfig of cluster being created is present at bmctl-workspace/abm-cluster-1/abm-cluster-1-kubeconfig [2023-03-22 23:15:47+0000] Please restrict access to this file as it contains authentication credentials of your cluster. [2023-03-22 23:15:47+0000] Waiting for cluster to become ready OK [2023-03-22 23:20:17+0000] Please run [2023-03-22 23:20:17+0000] kubectl --kubeconfig bmctl-workspace/abm-cluster-1/abm-cluster-1-kubeconfig get nodes [2023-03-22 23:20:17+0000] to get cluster nodes status. [2023-03-22 23:20:17+0000] Waiting for node pools to become ready OK [2023-03-22 23:20:37+0000] Waiting for metrics to become ready in GCP OK [2023-03-22 23:25:38+0000] Waiting for cluster API provider to install in the created admin cluster OK [2023-03-22 23:25:48+0000] Moving admin cluster resources to the created admin cluster [2023-03-22 23:25:51+0000] Waiting for node update jobs to finish OK [2023-03-22 23:27:41+0000] Flushing logs... OK [2023-03-22 23:27:41+0000] Deleting membership... OK [2023-03-22 23:27:42+0000] Deleting bootstrap cluster.
Conéctate al clúster de administrador
El comando bmctl register bootstrap
crea un archivo kubeconfig
para el clúster de administrador en la estación de trabajo de administrador. El directorio en el que se encuentra el kubeconfig
y el nombre del archivo se basan en el nombre del clúster de administrador:
bmctl-workspace/ADMIN_CLUSTER_NAME/ADMIN_CLUSTER_NAME-kubeconfig
Debes restringir el acceso a este kubeconfig
porque contiene credenciales de autenticación para el clúster.
Si deseas usar tu identidad de Google para acceder al clúster, puedes configurar la puerta de enlace de Connect de la siguiente manera:
En la estación de trabajo de administrador, configura la variable de entorno
KUBECONFIG
:export KUBECONFIG=$HOME/bmctl-workspace/ADMIN_CLUSTER_NAME/ADMIN_CLUSTER_NAME-kubeconfig
Establece el contexto actual en una variable de entorno:
export CONTEXT="$(kubectl config current-context)"
Ejecuta el siguiente comando
gcloud
: Este comando hace lo siguiente:- Otorga a tu cuenta de usuario la función
clusterrole/view
de Kubernetes en el clúster. - Configura el clúster para que puedas ejecutar comandos de
kubectl
de solo lectura en tu computadora local sin tener que establecer una conexión SSH a la estación de trabajo de administrador.
Reemplaza
GOOGLE_ACCOUNT_EMAIL
por la dirección de correo electrónico asociada con tu cuenta de Google Cloud. Por ejemplo:--users=alex@example.com
gcloud container fleet memberships generate-gateway-rbac \ --membership=ADMIN_CLUSTER_NAME \ --role=clusterrole/view \ --users=GOOGLE_ACCOUNT_EMAIL \ --project=FLEET_HOST_PROJECT_ID \ --kubeconfig=$KUBECONFIG \ --context=$CONTEXT\ --apply
El resultado de este comando es similar al siguiente, que se trunca para leer:
Validating input arguments. Specified Cluster Role is: clusterrole/view Generated RBAC policy is: -------------------------------------------- ... Writing RBAC policy for user: GOOGLE_ACCOUNT_EMAIL to cluster. Successfully applied the RBAC policy to cluster.
- Otorga a tu cuenta de usuario la función
Con estas políticas de RBAC implementadas, puedes acceder al clúster desde la consola con tu identidad de Google. Además, puedes ejecutar comandos de kubectl
de solo lectura en computadoras que no sean la estación de trabajo de administrador mediante un kubeconfig
especial que enruta solicitudes a través de la puerta de enlace de Connect.
Ejecuta el siguiente comando en una computadora que no sea la estación de trabajo de administrador para obtener la entrada
kubeconfig
que puede acceder al clúster a través de la puerta de enlace de Connect.gcloud container fleet memberships get-credentials ADMIN_CLUSTER_NAME \ --project=FLEET_HOST_PROJECT_ID
El resultado es similar a este:
Starting to build Gateway kubeconfig... Current project_id: FLEET_HOST_PROJECT_ID A new kubeconfig entry "connectgateway_FLEET_HOST_PROJECT_ID_global_ADMIN_CLUSTER_NAME" has been generated and set as the current context.
Ahora puedes ejecutar comandos de
kubectl
a través de la puerta de enlace de Connect:kubectl get pods -A
¿Qué sigue?
- Borra un clúster de administrador
- Cancela el registro de un clúster no disponible
- Cómo agregar un clúster de usuario
- Administra clústeres desde la consola de Google Cloud