Implementar clústeres de administración independientes

En esta sección se resume cómo implementar un clúster de administración de Tanzu Kubernetes Grid independiente. La implementación de un clúster de administración completa el proceso de instalación de Tanzu Kubernetes Grid y hace que Tanzu Kubernetes Grid funcione.

Después de realizar los pasos descritos en Instalar la CLI de Tanzu y la CLI de Kubernetes para su uso con clústeres de administración independientes, puede implementar clústeres de administración en vSphere 6.7, vSphere 7, vSphere 8, AWS o Azure.

Importante

En vSphere with Tanzu de vSphere 8, puede utilizar la CLI de Tanzu para conectarse al supervisor integrado e implementar clústeres de carga de trabajo de TKG 2.x, por lo que no es necesario implementar un clúster de administración. Para obtener más información, consulte El supervisor de vSphere with Tanzu es un clúster de administración. Se admite la implementación de un clúster de administración independiente en vSphere 8 cuando vSphere with Tanzu no está habilitado, pero la opción preferida es habilitar vSphere with Tanzu y utilizar el supervisor si es posible.

El clúster de administración es un clúster de Kubernetes que ejecuta operaciones de API de clúster en un proveedor de nube específico para crear y administrar clústeres de carga de trabajo en ese proveedor. El clúster de administración también es donde se configuran los servicios compartidos y en el clúster que utilizan los clústeres de carga de trabajo.

Nota

VMware recomienda nunca implementar cargas de trabajo en el propio clúster de administración independiente debido a lo siguiente:

• Los clústeres de administración y los clústeres de carga de trabajo independientes tienen inquietudes independientes.
• No se realiza una copia de seguridad de los clústeres de administración independientes como los clústeres de carga de trabajo. Para garantizar la resistencia, la configuración del clúster de administración independiente se administra mejor como código.

Proceso de implementación de clústeres

El siguiente diagrama muestra los pasos de alto nivel para implementar clústeres de administración y clústeres de carga de trabajo para diferentes proveedores de IaaS, como vSphere 6.7, 7 y 8, AWS y Azure, y las interfaces que se utilizan para ejecutarlos.

Interfaz de usuario del instalador frente a la CLI

Puede implementar un clúster de administración de dos formas:

• Ejecute el instalador de Tanzu Kubernetes Grid, una interfaz de asistente que le guiará a través del proceso de implementación de un clúster de administración. Este es el método recomendado.
• Cree y edite un archivo de configuración YAML y utilícelo para implementar un clúster de administración solo con la CLI de Tanzu.
  • Este método de implementación es necesario para configuraciones de clústeres de administración como:
    • Redes IPv6
    • Redes de pila dual
    • Directivas de almacenamiento personalizadas establecidas por VSPHERE_STORAGE_POLICY_ID
    • Node IPAM para el clúster de administración
  • Puede volver a crear un archivo de configuración YAML o ejecutar la interfaz del instalador, hacer clic en Revisar configuración (Review Configuration) > Exportar configuración (Export Configuration) y modificar el archivo de configuración que genera la interfaz del instalador.

Plataformas

Puede implementar y administrar clústeres de administración de Tanzu Kubernetes Grid independientes en:

• vSphere 6.7u3
• vSphere 7, si el clúster supervisor no está habilitado.
• vSphere 8, si el supervisor no está habilitado.
• Amazon Web Services (AWS)
• Microsoft Azure

Puede implementar el clúster de administración como un plano de control de nodo único, para desarrollo, o como un plano de control de varios nodos de alta disponibilidad, para entornos de producción.

• Para obtener información sobre la configuración necesaria para la implementación del clúster de administración en la infraestructura que elija, consulte Requisitos del clúster de administración independiente.
• Cuando haya configurado la infraestructura, consulte Implementar clústeres de administración con la interfaz del instalador o Implementar clústeres de administración desde un archivo de configuración.
• Después de implementar un clúster de administración en la plataforma que elija, para comprobar la implementación y registrar el clúster de administración implementado con Tanzu Mission Control, consulte Examinar y registrar un clúster de administración independiente recién implementado.
• Después de implementar uno o varios clústeres de administración en una o varias plataformas, utilice la CLI de Tanzu para Administrar sus clústeres de administración.
• Si es necesario, puede realizar Copia de seguridad y restauración de la infraestructura del clúster de carga de trabajo y de administración.

Clústeres de administración y sus archivos de configuración

Implementa el clúster de administración ejecutando el comando tanzu mc create en la máquina de arranque. Para implementar un clúster de administración, debe especificar la opción --ui o --file con tanzu mc create.

• Interfaz del instalador: tanzu mc create --ui crea el clúster de administración con la interfaz del instalador y guarda la configuración de la entrada del instalador en un archivo de configuración del clúster ~/.config/tanzu/tkg/clusterconfigs/UNIQUE-ID.yaml, donde UNIQUE-ID es un nombre de archivo generado. El instalador también genera una especificación de objeto basada en clases del tipo Kubernetes para el objeto Cluster del clúster de administración, que se guarda en un archivo con el mismo nombre que el clúster de administración. Esta especificación de objeto basada en clases se proporciona solo para información. Aún no se admite la implementación de clústeres de administración desde una especificación de objeto basada en clases. Para obtener más información sobre los tipos de clúster en TKG 2.x, consulte Clústeres de carga de trabajo en Acerca de Tanzu Kubernetes Grid.

• CLI: tanzu mc create --file crea el clúster de administración mediante un archivo de configuración del clúster. Antes de ejecutar tanzu mc create, establezca los parámetros de configuración, como INFRASTRUCTURE_PROVIDER, en el archivo de configuración del clúster y, a continuación, pase a la opción --file. La práctica recomendada es utilizar un archivo de configuración dedicado para cada clúster de administración que implemente.

También puede establecer parámetros de configuración como variables de entorno. Si establece parámetros en conflicto, las variables de entorno anulan los parámetros de configuración establecidos en el archivo que se pasan a la opción --file:

• Variables de entorno local: Persistir durante una sesión de terminal. Estas variables también reemplazan a las variables de entorno en el archivo de configuración de la CLI de Tanzu, ~/.config/tanzu/config.yaml.
• Variables de entorno en ~/.config/tanzu/config.yaml, establecidas ejecutando tanzu config set: Persista hasta que las anule la configuración; para ello, ejecute tanzu config unset.

El comando tanzu mc create utiliza estos orígenes y entradas en el siguiente orden de aumento de prioridad:

1. ~/.config/tanzu/tkg/providers/config_default.yaml: Este archivo contiene los valores predeterminados del sistema y no debe cambiarse.
2. Con la opción --file: El archivo de configuración del clúster, que de forma predeterminada es ~/.config/tanzu/tkg/cluster-config.yaml. Este archivo configura invocaciones específicas de tanzu mc create. Utilice diferentes archivos de configuración para guardar varias configuraciones.
3. Variables de entorno establecidas al ejecutar tanzu config set: El archivo ~/.config/tanzu/config.yaml. Estas variables se aplican a todos los comandos tanzu. Las variables de entorno local reemplazan a las variables de ~/.config/tanzu/config.yaml.
4. Variables de entorno local: La configuración de los parámetros en el entorno local anula la configuración de los archivos de configuración. Utilícelos para realizar opciones de configuración rápidas sin tener que buscar y editar un archivo de configuración.
5. Con la opción --ui: Entrada de la interfaz del instalador. Cuando se ejecuta tanzu mc create --ui, el instalador establece todos los valores de configuración del clúster de administración a partir de la entrada del usuario.

Qué sucede al crear un clúster de administración

Al ejecutar tanzu mc create se crea un clúster de administración temporal mediante un clúster Kubernetes en Docker (kind) en la máquina de arranque. Después de crear el clúster de administración temporal localmente, Tanzu Kubernetes Grid lo utiliza para aprovisionar el clúster de administración final en la plataforma de su elección.

En el proceso, tanzu mc create crea o modifica los archivos de estado y configuración de la CLI en el directorio principal del usuario en la máquina de arranque local:

Ubicación	Contenido	Cambiar
~/.config/tanzu/tkg/bom/	Los archivos de la lista de materiales (BoM) que enumeran versiones específicas de todos los paquetes que Tanzu Kubernetes Grid requiere cuando crea un clúster con una versión específica del sistema operativo y Kubernetes. Tanzu Kubernetes Grid se agrega a este directorio a medida que se publican nuevas versiones de Tanzu Kubernetes.	Agregar si aún no está presente
~/.config/tanzu/tkg/providers/	Archivos de plantilla de configuración para la API del clúster, los proveedores de nube y otras dependencias, organizados con superposiciones ytt para modificaciones no destructivas.	Agregar si aún no está presente
~/.config/tanzu/tkg/providers-TIMESTAMP-HASH/	Copias de seguridad de directorios /providers de instalaciones anteriores.	Agregar si no es la primera instalación
~/.config/tanzu/config.yaml	Nombres, contextos y ubicaciones de archivos de certificado para los clústeres de administración que conoce la CLI del Tanzu y que es el actual. En este archivo también se enumeran los orígenes de detección de los complementos de la CLI de Tanzu, las variables de entorno establecidas por tanzu config set y las funciones que están activadas o desactivadas de forma predeterminada en la CLI de Tanzu.	Agregue la información del nuevo clúster de administración y establézcalo como current.
~/.config/tanzu/tkg/cluster-config.yaml	Archivo de configuración del clúster predeterminado que utilizan los comandos tanzu cluster create y tanzu mc create si no especifica uno con –file. La práctica recomendada es utilizar un archivo de configuración único para cada clúster.	Agregue un archivo vacío si aún no está presente.
~/.config/tanzu/tkg/clusterconfigs/IDENTIFIER.yaml	Archivo de configuración del clúster plano que tanzu mc create –ui escribe con la entrada de valores de la interfaz del instalador. IDENTIFIER es un identificador único generado por el instalador.	Crear archivo
~/.config/tanzu/tkg/clusterconfigs/MGMT-CLUSTER-NAME.yaml	Archivo de configuración del clúster basado en clases que tanzu mc create –ui genera en función del archivo de configuración plano.	Crear archivo
~/.config/tanzu/tkg/config.yaml	Lista de configuraciones y ubicaciones para el núcleo de Tanzu Kubernetes Grid y todos sus proveedores.	Agregar si aún no está presente
~/.config/tanzu/tkg/providers/config.yaml	De forma similar a~/.config/tanzu/tkg/config.yaml, pero solo enumera proveedores y configuraciones en el directorio ~/.config/tanzu/tkg/providers, no los archivos de configuración utilizados por Tanzu Kubernetes Grid principal.	Agregar si aún no está presente
~/.config/tanzu/tkg/providers/config_default.yaml	Configuraciones predeterminadas de todo el sistema para proveedores. La práctica recomendada es no editar este archivo, sino cambiar las configuraciones del proveedor a través de archivos de superposición ytt.	Agregar si aún no está presente
~/.kube-tkg/config	Archivo kubeconfig del clúster de administración que contiene nombres y certificados para los clústeres de administración que conoce la CLI de tanzu. Ubicación anulada por la variable de entorno KUBECONFIG.	Agregue nueva información del clúster de administración y establezca el clúster como current-context.
~/.kube/config	Configuración y estado de la CLI de kubectl, incluidos todos los clústeres de carga de trabajo y administración, y que es el contexto actual.	Agregue el nuevo nombre del clúster de administración, el contexto y la información del certificado. No cambie el contexto de kubectl actual al nuevo clúster.