Después de crear un clúster con bmctl
, puedes cambiar algunos aspectos de la configuración del clúster mediante la siguiente secuencia de acciones:
Cambia los valores de ciertos campos en el archivo de configuración del clúster, que se encuentra aquí de forma predeterminada:
bmctl-workspace/CLUSTER-NAME/CLUSTER-NAME.yaml
.Actualiza el clúster mediante la ejecución del comando
bmctl update
.
De esta manera, puedes, por ejemplo, agregar o quitar nodos en un clúster o reemplazar los nodos de un clúster. En este documento, se describe cómo realizar estas y otras actualizaciones de un clúster.
Sin embargo, es importante tener en cuenta que muchos aspectos de la configuración de tu clúster son inmutables y no se pueden actualizar después de crear el clúster. Para obtener una lista completa de campos inmutables y mutables, consulta la referencia del campo de configuración de clústeres. La referencia del campo es una tabla ordenable. Haz clic en los encabezados de las columnas para cambiar el orden de clasificación. Haz clic en el nombre de un campo para ver su descripción.
Agrega o quita nodos en un clúster
Un grupo de nodos es un grupo de nodos dentro de un clúster que tiene la misma configuración. Ten en cuenta que un nodo siempre pertenece a un grupo de nodos. Para agregar un nodo nuevo a un clúster, debes agregarlo a un grupo de nodos en particular. Quitar un nodo de un grupo de nodos equivale a quitar el nodo del clúster.
Hay tres tipos de grupos de nodos en clústeres de Anthos alojados en Bare Metal: plano de control, balanceador de cargas y grupos de nodos trabajadores.
Puedes agregar o quitar un nodo de un grupo de nodos si agregas o quitas la dirección IP del nodo de una sección determinada del archivo de configuración del clúster. En la siguiente lista, se muestra la sección de un manifiesto que debes editar para un grupo de nodos determinado:
- Grupo de nodos trabajadores: agrega o quita la dirección IP del nodo del campo
spec.nodes
que aparece en la secciónkind: NodePool
. - Grupo de nodos del plano de control: agrega o quita la dirección IP del nodo del campo
spec.controlPlane.nodePoolSpec.nodes
que aparece en la secciónkind: Cluster
. - Grupo de nodos del balanceo de cargas: No puedes modificar (agregar o quitar direcciones IP) de un grupo de direcciones del balanceador de cargas existente ni puedes quitar un grupo de direcciones del balanceador de cargas existente. Una vez que creaste un clúster, solo puedes agregar grupos de direcciones nuevos.
Ejemplo: cómo quitar un nodo trabajador
Este es un archivo de configuración de clúster de muestra que muestra las especificaciones de dos nodos trabajadores:
---
apiVersion: baremetal.cluster.gke.io/v1
kind: NodePool
metadata:
name: nodepool1
namespace: cluster-cluster1
spec:
clusterName: cluster1
nodes:
- address: 172.18.0.5
- address: 172.18.0.6
Puedes quitar un nodo del grupo de nodos trabajadores si realizas los siguientes pasos:
Borra la entrada de la dirección IP del nodo del archivo de configuración del clúster:
--- apiVersion: baremetal.cluster.gke.io/v1 kind: NodePool metadata: name: nodepool1 namespace: cluster-cluster1 spec: clusterName: cluster1 nodes: - address: 172.18.0.5
Actualiza el clúster:
bmctl update cluster -c CLUSTER_NAME \ --kubeconfig=KUBECONFIG
Realiza los siguientes cambios:
- Reemplaza CLUSTER_NAME por el nombre del clúster que deseas actualizar.
- Si el clúster es autoadministrado (como de administrador o independiente), reemplaza KUBECONFIG por la ruta de acceso al archivo kubeconfig del clúster. Si el clúster es de usuario, reemplaza KUBECONFIG por la ruta de acceso al archivo kubeconfig del clúster admin.
Es importante tener en cuenta que bmctl
debe desviar los pods de un nodo antes de que se pueda quitar el nodo. Los nodos no se quitan del clúster si los pods no se pueden reprogramar para otros nodos.
Después de que el comando bmctl update
se haya ejecutado de forma correcta, las tareas machine-preflight
y machine-init
tardan un poco en completarse. Puedes ver el estado de los nodos y sus grupos de nodos respectivos si ejecutas los comandos descritos en la sección Verifica tus actualizaciones de este documento.
Fuerza la eliminación de un nodo
Si el comando bmctl update
no puede quitar un nodo, es posible que debas forzar su eliminación del clúster. Para obtener más información, consulta Cómo quitar nodos dañados de manera automática.
Reemplaza los nodos del plano de control de alta disponibilidad
Puedes reemplazar los nodos del plano de control de alta disponibilidad (HA) en clústeres de administrador, de usuario, independientes y híbridos.
Para reemplazar un nodo en un clúster, debes realizar los siguientes pasos:
- Quita la dirección IP del nodo del archivo de configuración del clúster.
- Actualiza el clúster.
- Verifica el estado de los nodos en el clúster.
- Agrega la dirección IP de un nodo nuevo al mismo archivo de configuración del clúster.
- Actualiza el clúster.
El resto de esta sección es un ejemplo.
Este es un archivo de configuración de clúster de muestra que muestra tres nodos del plano de control en un clúster de usuario:
---
apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
metadata:
name: user-cluster
namespace: cluster-user-cluster
spec:
controlPlane:
nodePoolSpec:
nodes:
- address: 10.200.0.11
- address: 10.200.0.12
- address: 10.200.0.13
Para reemplazar el último nodo que aparece en la sección spec.controlPlane.nodePoolSpec.nodes
, realiza los siguientes pasos:
Para quitar el nodo, borra su entrada de dirección IP en el archivo de configuración del clúster. Después de realizar este cambio, el archivo de configuración del clúster debería verse así:
--- apiVersion: baremetal.cluster.gke.io/v1 kind: Cluster metadata: name: user-cluster namespace: cluster-user-cluster spec: controlPlane: nodePoolSpec: nodes: - address: 10.200.0.11 - address: 10.200.0.12
Actualiza el clúster mediante la ejecución del siguiente comando:
bmctl update cluster -c CLUSTER_NAME \ --kubeconfig=KUBECONFIG
Realiza los siguientes cambios:
- Reemplaza CLUSTER_NAME por el nombre del clúster que deseas actualizar.
- Si el clúster es autoadministrado (como de administrador o independiente), reemplaza KUBECONFIG por la ruta de acceso al archivo kubeconfig del clúster. Si el clúster es de usuario, como en este ejemplo, reemplaza KUBECONFIG por la ruta de acceso al archivo kubeconfig del clúster admin.
Después de que el comando
bmctl update
se haya ejecutado de forma correcta, las tareasmachine-preflight
ymachine-init
tardan un poco en completarse. Puedes ver el estado de los nodos y sus grupos de nodos respectivos si ejecutas los comandos descritos en la sección Verifica tus actualizaciones de este documento. Una vez que el grupo de nodos y los nodos estén listos, puedes continuar con el siguiente paso.Agrega un nodo del plano de control nuevo al grupo de nodos. Para ello, agrega la dirección IP del nodo del plano de control nuevo a la sección
spec.controlPlane.nodePoolSpec.nodes
del archivo de configuración del clúster. Después de realizar este cambio, el archivo de configuración del clúster debería verse así:--- apiVersion: baremetal.cluster.gke.io/v1 kind: Cluster metadata: name: user-cluster namespace: cluster-user-cluster spec: controlPlane: nodePoolSpec: nodes: - address: 10.200.0.11 - address: 10.200.0.12 - address: 10.200.0.14
Actualiza el clúster mediante la ejecución del siguiente comando:
bmctl update cluster -c CLUSTER_NAME \ --kubeconfig=KUBECONFIG
Realiza los siguientes cambios:
- Reemplaza CLUSTER_NAME por el nombre del clúster que deseas actualizar.
- Si el clúster es autoadministrado (como de administrador o independiente), reemplaza KUBECONFIG por la ruta de acceso al archivo kubeconfig del clúster. Si el clúster es de usuario, como en este ejemplo, reemplaza KUBECONFIG por la ruta de acceso al archivo kubeconfig del clúster admin.
Verifica tus actualizaciones
Puedes ver el estado de los nodos y sus respectivos grupos de nodos con el comando kubectl get
.
Por ejemplo, el siguiente comando muestra el estado de los grupos de nodos en el espacio de nombres del clúster cluster-my-cluster
:
kubectl -n cluster-my-cluster get nodepools.baremetal.cluster.gke.io
El sistema muestra resultados similares al siguiente:
NAME READY RECONCILING STALLED UNDERMAINTENANCE UNKNOWN
cluster-my-cluster 3 0 0 0 0
cluster-my-cluster-lb 2 0 0 0 0
np1 3 0 0 0 0
Reconciling=1
significa que el paso de conciliación aún está en curso. Debes esperar hasta que el estado cambie a Reconciling=0
.
También puedes verificar el estado de los nodos en un clúster si ejecutas el siguiente comando:
kubectl get nodes --kubeconfig=KUBECONFIG
Si necesitas más información sobre cómo diagnosticar tus clústeres, consulta Crea instantáneas para diagnosticar clústeres.
Funciones que puedes cambiar con una actualización
Además de agregar, quitar o reemplazar nodos, puedes usar el comando bmctl update
para modificar ciertos valores de campo mutables, recursos personalizados (CR) y anotaciones en el archivo de configuración del clúster.
Para actualizar un recurso de clúster, edita el archivo de configuración de clúster y usa bmctl update
a fin de aplicar los cambios.
En las siguientes secciones, se describen algunos ejemplos comunes para actualizar un clúster existente mediante el cambio de un valor de campo, una CR o una anotación.
loadBalancer.addressPools
La sección addressPools
contiene campos a fin de especificar grupos de balanceo de cargas para balanceadores de cargas en paquetes. Puedes agregar más grupos de direcciones de balanceo de cargas en cualquier momento, pero no puedes quitar ni modificar ningún grupo de direcciones existente.
addressPools:
- name: pool1
addresses:
- 192.168.1.0-192.168.1.4
- 192.168.1.240/28
- name: pool2
addresses:
- 192.168.1.224/28
Evita la eliminación accidental de clústeres
Si agregas la anotación baremetal.cluster.gke.io/prevent-deletion: "true"
al archivo de configuración del clúster, no puedes borrar el clúster.
Por ejemplo, ejecutar kubectl delete cluster
o bmctl reset cluster
produce un error.
apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
metadata:
name: ci-10c3c6f4d9c698e
namespace: cluster-ci-10c3c6f4d9c698e
annotations:
baremetal.cluster.gke.io/prevent-deletion: "true"
spec:
clusterNetwork:
bypassPreflightCheck
El valor predeterminado del campo bypassPreflightCheck
es false
. Si estableces este campo en true
en el archivo de configuración del clúster, se ignoran las comprobaciones preliminares internas si aplicas recursos a los clústeres existentes.
apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
metadata:
name: cluster1
namespace: cluster-cluster1
annotations:
baremetal.cluster.gke.io/private-mode: "true"
spec:
bypassPreflightCheck: true
loginUser
Puedes establecer el campo loginUser
en la configuración de acceso al nodo. Este campo admite la capacidad sudo
sin contraseña para el acceso a la máquina.
apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
metadata:
name: cluster1
namespace: cluster-cluster1
annotations:
baremetal.cluster.gke.io/private-mode: "true"
spec:
nodeAccess:
loginUser: abm
NetworkGatewayGroup
El recurso personalizado NetworkGatewayGroup
se usa para proporcionar direcciones IP flotantes para funciones avanzadas de redes, como la puerta de enlace NAT de salida o el balanceo de cargas en paquetes con BGP.
Para usar el recurso personalizado NetworkGatewayGroup
y las funciones de red relacionadas, debes configurar clusterNetwork.advancedNetworking
como true
cuando crees los clústeres.
apiVersion: networking.gke.io/v1
kind: NetworkGatewayGroup
name: default
namespace: cluster-bm
spec:
floatingIPs:
- 10.0.1.100
- 10.0.2.100
BGPLoadBalancer
Cuando configuras balanceadores de cargas en paquetes con BGP, el balanceo de cargas del plano de datos usa de forma predeterminada los mismos pares externos que se especificaron para el intercambio de tráfico del plano de control. Como alternativa, puedes configurar el balanceo de cargas del plano de datos por separado mediante el recurso personalizado BGPLoadBalancer
(y el recurso personalizado BGPPeer
). Para obtener más información, consulta Configura balanceadores de cargas en paquetes con BGP.
apiVersion: networking.gke.io/v1
kind: BGPLoadBalancer
metadata:
name: default
namespace: cluster-bm
spec:
peerSelector:
cluster.baremetal.gke.io/default-peer: "true"
BGPPeer
Cuando configuras balanceadores de cargas en paquetes con BGP, el balanceo de cargas del plano de datos usa de forma predeterminada los mismos pares externos que se especificaron para el intercambio de tráfico del plano de control. Como alternativa, puedes configurar el balanceo de cargas del plano de datos por separado mediante el recurso personalizado BGPPeer
(y el recurso personalizado BGPLoadBalancer
). Para obtener más información, consulta Configura balanceadores de cargas en paquetes con BGP.
apiVersion: networking.gke.io/v1
kind: BGPPeer
metadata:
name: bgppeer1
namespace: cluster-bm
labels:
cluster.baremetal.gke.io/default-peer: "true"
spec:
localASN: 65001
peerASN: 65002
peerIP: 10.0.3.254
sessions: 2
NetworkAttachmentDefinition
Puedes usar el comando bmctl update
para modificar los recursos personalizados NetworkAttachmentDefinition
que corresponden a la red.
apiVersion: "k8s.cni.cncf.io/v1"
kind: NetworkAttachmentDefinition
metadata:
name: gke-network-1
namespace: cluster-my-cluster
spec:
config: '{
"type": "ipvlan",
"master": "enp2342",
"mode": "l2",
"ipam": {
"type": "whereabouts",
"range": "172.120.0.0/24"
Después de modificar el archivo de configuración, actualiza el clúster mediante la ejecución del siguiente comando de bmctl update
:
bmctl update cluster -c CLUSTER_NAME --kubeconfig=KUBECONFIG
Realiza los siguientes cambios:
- Reemplaza CLUSTER_NAME por el nombre del clúster que deseas actualizar.
- Si el clúster es autoadministrado (como de administrador o independiente), reemplaza KUBECONFIG por la ruta de acceso al archivo kubeconfig del clúster. Si el clúster es de usuario, reemplaza KUBECONFIG por la ruta de acceso al archivo kubeconfig del clúster admin.