Agregar un nodo de trabajador
Utilice este procedimiento para agregar un nodo de trabajo a un clúster de OpenShift.
Proporcionamos este procedimiento de ejemplo únicamente con fines informativos. Consulte la documentación de Red Hat OpenShift (https://docs.openshift.com/) para ver el procedimiento oficial.
Este procedimiento muestra un ejemplo de enlace temprano. En el enlace temprano, genera una ISO preconfigurada para el clúster existente. Cuando el nodo se inicia con esa ISO, el nodo se acerca automáticamente al clúster existente.
Esto hace que una o más CertificateSigningRequests (CSR) se envíen desde el nuevo nodo al clúster existente. Una CSR es simplemente una solicitud para obtener los certificados de cliente para el clúster (existente). Deberá aprobar explícitamente estas solicitudes. Una vez aprobado, el clúster existente proporciona los certificados de cliente al nuevo nodo y se le permite unirse al clúster existente.
- Inicie sesión en la máquina (VM o BMS) que usa como cliente del instalador asistido. El equipo cliente del instalador asistido es donde se emiten llamadas a la API del instalador asistido al servicio de instalador asistido alojado por Red Hat.
- Prepare la implementación estableciendo las variables de entorno que usará en pasos posteriores.
- Configure la misma clave SSH que usa para el clúster existente.
En este ejemplo, recuperamos esa clave SSH de su ubicación predeterminada ~/.ssh/id_rsa.pub y la almacenamos en una variable.
export CLUSTER_SSHKEY=$(cat ~/.ssh/id_rsa.pub)
- Si ya no tiene el secreto de extracción de imagen, descargue el secreto de extracción de imagen de su cuenta de Red Hat en su computadora local. El secreto de extracción permite que su instalación acceda a los servicios y registros que sirven imágenes de contenedor para componentes OpenShift.
Si usa el instalador asistido alojado en Red Hat, puede descargar el archivo secreto de extracción (pull-secret) de la página de https://console.redhat.com/openshift/downloads . Copie el archivo pull-secret en el equipo cliente del instalador asistido. En este ejemplo, almacenamos el pull-secret en un archivo llamado pull-secret.txt.
Elimine cualquier espacio en blanco, convierta el contenido en formato de cadena JSON y guárdelo en una variable de entorno, de la siguiente manera:
export PULL_SECRET=$(sed '/^[[:space:]]*$/d' pull-secret.txt | jq -R .)
- Si ya no tiene su token de acceso sin conexión, copie el token de acceso sin conexión desde su cuenta de Red Hat. El token de API de OpenShift Cluster Manager le permite (en el equipo cliente del instalador asistido) interactuar con el servicio de API de instalador asistido alojado en Red Hat.
El token es una cadena que puede copiar y pegar en una variable de entorno local. Si usa el instalador asistido alojado en Red Hat, puede copiar el token de API de https://console.redhat.com/openshift/downloads.
export OFFLINE_ACCESS_TOKEN='<paste offline access token here>'
- Genere (actualice) el token desde el OFFLINE_ACCESS_TOKEN. Usará este token generado cada vez que emita comandos de API.
export TOKEN=$(curl --silent --data-urlencode "grant_type=refresh_token" --data-urlencode "client_id=cloud-services" --data-urlencode "refresh_token=${OFFLINE_ACCESS_TOKEN}" https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token | jq -r .access_token)Nota:Este token caduca regularmente. Cuando este token expire, recibirá una respuesta HTTP 4xx cada vez que emita un comando de API. Actualice el token cuando expire o, alternativamente, actualice el token regularmente antes de que expire. No hay ningún daño en la actualización del token cuando no ha expirado.
- Obtenga el ID de clúster de OpenShift del clúster existente.
Por ejemplo:
oc get clusterversion -o jsonpath='{.items[].spec.clusterID}{"\n"}' 1777102a-1fe1-407a-9441-9d0bad4f5968export $OS_CLUSTER_ID="1777102a-1fe1-407a-9441-9d0bad4f5968"
- Configure las variables de entorno restantes.
La tabla 1 enumera todas las variables de entorno que debe establecer en este procedimiento, incluidas las descritas en los pasos anteriores.
Tabla 1: Variables de entorno Ejemplo de descripción de variables CLUSTER_SSHKEY La clave SSH (pública) que usa para el clúster existente. Debe usar esta misma clave para el nuevo nodo que va a agregar. – PULL_SECRET La imagen extrae el secreto que descargó, desencadenó y convirtió al formato de cadena JSON. – OFFLINE_ACCESS_TOKEN El token de API de OpenShift Cluster Manager que copió. – TOKEN El token que generó (actualizado) desde el OFFLINE_ACCESS_TOKEN. – CLUSTER_NAME El nombre del clúster existente. micluster CLUSTER_DOMAIN El dominio base del clúster existente. contrail.lan OS_CLUSTER_ID El ID de clúster de OpenShift del clúster existente. 1777102a-1fe1-407a-9441-9d0bad4f5968 AI_URL La DIRECCIÓN URL del servicio de instalador asistido. En este ejemplo, se utiliza el instalador asistido alojado en Red Hat. https://api.openshift.com
- Configure la misma clave SSH que usa para el clúster existente.
- Importe el clúster existente.
curl -X POST "$AI_URL/api/assisted-install/v2/clusters/import" -H "accept: application/json" -H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" -d "{\"name\":\"$CLUSTER_NAME\",\"openshift_cluster_id\":\"$OS_CLUSTER_ID\",\"api_vip_dnsname\":\"api.$CLUSTER_NAME.$CLUSTER_DOMAIN\"}"Cuando importa el clúster, el servicio de instalador asistido devuelve un ID de clúster para AddHostsCluster. Busque atentamente el ID de clúster integrado en la respuesta. Por ejemplo:
"id":"19b809b5-69c4-42d8-9e5e-56aae4aba386"
- Genere la ISO de arranque de descubrimiento. Usará esta ISO para arrancar el nodo que va a agregar al clúster.
La ISO se personaliza para su infraestructura según el entorno de infraestructura que configure.
- Cree un archivo que describa el entorno de infraestructura. En este ejemplo, lo denominamos infra-envs-addhost.json.
cat << EOF > ./infra-envs-addhost.json { "name": "<InfraEnv Name>", "ssh_authorized_key": "$CLUSTER_SSHKEY", "pull_secret": $PULL_SECRET, "cluster_id": "<AddHostsCluster ID>", "openshift_version": "4.8", "user_managed_networking": <same as for existing cluster>, "vip_dhcp_allocation": <same as for existing cluster>, "base_dns_domain": "$CLUSTER_DOMAIN", } EOF- InfraEnv Name es el nombre que desea llamar infraEnv.
- AddHostsCluster ID es el ID de clúster del AddHostsCluster (obtenido en el paso anterior).
user_managed_networkingyvip_dhcp_allocationse establecen en los mismos valores que para el clúster existente.
- Inscríbalo en InfraEnv. En respuesta, el servicio de instalador asistido asigna un ID de InfraEnv y crea la ISO de arranque de descubrimiento según el entorno de infraestructura especificado.
curl -X POST "$AI_URL/api/assisted-install/v2/infra-envs" -H "accept: application/json" -H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" -d @infra-envs-addhosts.json
Cuando registre infraEnv, el servicio de instalador asistido devuelve un ID de InfraEnv. Busque atentamente el ID de InfraEnv integrado en la respuesta. Por ejemplo:
"id":"78d20699-f25b-462c-bc1d-4738590a9344"
Almacene el ID de InfraEnv en una variable. Por ejemplo:
export INFRA_ENV_ID="78d20699-f25b-462c-bc1d-4738590a9344"
- Obtenga la URL de descarga de imagen.
curl -s $AI_URL/api/assisted-install/v2/infra-envs/$INFRA_ENV_ID/downloads/image-url -H "accept: application/json" -H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" | jq '.url'
- Descargue la ISO y guárdela en un archivo. En este ejemplo, lo guardamos en ai-liveiso-addhosts.iso.
curl -L "<image URL>" -H "Authorization: Bearer $TOKEN" -o ./ai-liveiso-addhosts.iso
- Cree un archivo que describa el entorno de infraestructura. En este ejemplo, lo denominamos infra-envs-addhost.json.
- Inicie el nuevo nodo de trabajo con la ISO de arranque de descubrimiento. Elija el método de arranque más conveniente para su infraestructura. Asegúrese de que el nuevo nodo inicie conectado a una red que tenga acceso al instalador asistido alojado en Red Hat.
- Instale el nuevo nodo en el clúster existente.
- Inspeccione el nuevo nodo para asegurarse de que su rol está establecido en trabajador.
curl -s -X GET --header "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" $AI_URL/api/assisted-install/v2/infra-envs/$INFRA_ENV_ID/hosts | jq '.'
Continúe solo cuando el rol host se establece en trabajador.
- Obtenga el ID de host del nuevo nodo.
export HOST_ID=$(curl -s -X GET --header "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" $AI_URL/api/assisted-install/v2/infra-envs/$INFRA_ENV_ID/hosts | jq -r '.[].id')
- Instale el nuevo nodo.
curl -X POST "$AI_URL/api/assisted-install/v2/infra-envs/$INFRA_ENV_ID/hosts/$HOST_ID/actions/install" -H "accept: application/json" -H "Authorization: Bearer $TOKEN" | jq -r
- Compruebe el progreso de la instalación.
curl -s -X GET --header "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" $AI_URL/api/assisted-install/v2/infra-envs/$INFRA_ENV_ID/hosts | jq '.'
- Inspeccione el nuevo nodo para asegurarse de que su rol está establecido en trabajador.
- Una vez que el nuevo nodo se haya reiniciado, intentará unirse al clúster existente. Esto hace que una o más CertificateSigningRequests (CSR) se envíen desde el nuevo nodo al clúster existente. Deberá aprobar las solicitudes de CSR.
- Compruebe si hay CSR pendientes.
Por ejemplo:
root@ai-client:~/contrail# oc get csr -A NAME AGE SIGNERNAME REQUESTOR CONDITION csr-gblnm 20s kubernetes.io/kube-apiserver-client-kubelet system:serviceaccount:openshift-machine-config-operator:node-bootstrapper Pending
Es posible que tenga que repetir este comando periódicamente hasta que vea una CSR pendiente.
- Apruebe los CSR.
Por ejemplo:
root@ai-client:~/contrail# oc adm certificate approve csr-gblnm certificatesigningrequest.certificates.k8s.io/csr-gblnm approved
- Compruebe si hay CSR pendientes.
- Compruebe que el nuevo nodo esté activo y en ejecución en el clúster existente.
oc get nodes