Imágenes de máquinas personalizadas de Linux

Este procedimiento le guiará por el proceso de creación de una imagen de máquina personalizada de Linux (Ubuntu) para usarla al crear clústeres basados en clases en vSphere. Se divide en las siguientes secciones:

Requisitos previos de imagen de Linux muestra lo que necesita para compilar y utilizar correctamente una imagen de Linux personalizada.
Recuperar la versión de imagen del sistema operativo muestra cómo recuperar la versión de la imagen del sistema operativo de un archivo OVA predeterminado para vSphere.
Compilar una imagen de Linux muestra cómo utilizar Kubernetes Image Builder y Docker para personalizar y compilar una imagen.
Cargar la imagen de Linux en vSphere muestra cómo cargar la imagen de Linux personalizada en vSphere.

Para crear una imagen de máquina personalizada de Linux para clústeres basados en planes (heredados), consulte Imágenes de máquina personalizadas de Linux (heredado) . Para obtener más información sobre los tipos de clústeres en Tanzu Kubernetes Grid, consulte Tipos de clústeres de carga de trabajo.

Requisitos previos de imagen de Linux

Para crear una imagen de máquina personalizada de Linux, necesita:

Una cuenta en vSphere
Una estación de trabajo macOS o Linux con lo siguiente instalado:
- Escritorio de Docker
- La CLI de Kubernetes, kubectl
- (Opcional) CLI govc

Recuperar la versión de imagen del sistema operativo

En este paso, se recupera la versión de la imagen del sistema operativo que está asociada con el archivo OVA de Ubuntu predeterminado para la versión de Kubernetes que desea utilizar para la imagen personalizada. Asignará esta versión de imagen del sistema operativo a la imagen personalizada en el paso Compilar una imagen de Linux a continuación.

Para recuperar la versión de imagen del sistema operativo, realice una de las siguientes acciones en función de su caso práctico:

Si tiene un clúster de administración en ejecución que se creó con la versión de Kubernetes predeterminada para la versión actual de Tanzu Kubernetes Grid, puede recuperar la versión de la imagen del sistema operativo del clúster:
1. Establezca el contexto kubectl en el clúster de administración.
2. En la lista de TKr disponibles, elija la versión de Tanzu Kubernetes (TKr) para la versión de Kubernetes que desea utilizar para la imagen personalizada. Por ejemplo, v1.25.7---vmware.1-tkg.1. Para enumerar las TKr disponibles, ejecute:
```
kubectl get tkr
```
3. Abra la TKr y busque la propiedad osImages. Esta propiedad especifica los nombres de los objetos OSImage asociados con la TKr.
4. Busque y abra el objeto OSImage para el archivo OVA de Ubuntu predeterminado. El nombre del objeto OSImage coincide con uno de los nombres osImages de la TKr.
```
kubectl get osimages
```
5. En el objeto OSImage para el archivo OVA de Ubuntu predeterminado, busque y registre el valor de la propiedad version en spec.image.ref. Por ejemplo, v1.25.7+vmware.1-tkg.1-765d418b72c247c2310384e640ee075e.
Si no tiene un clúster de administración en ejecución que se creó con la versión de Kubernetes predeterminada para la versión actual de Tanzu Kubernetes Grid, puede recuperar la versión de la imagen del sistema operativo directamente desde el archivo OVA de Ubuntu predeterminado, ya sea de forma local o desde vSphere:
- Para recuperar la versión de imagen del sistema operativo de forma local:
  1. Descargue el archivo OVA de Ubuntu predeterminado para la versión de Kubernetes de destino desde Customer Connect:
    1. Vaya a la página de descargas de Tanzu Kubernetes Grid, inicie sesión con sus credenciales de VMware Customer Connect y haga clic en Ir a descargas (Go to Downloads).
    2. Descargue el OVA. Por ejemplo, Ubuntu 2004 Kubernetes v1.25.7 OVA.
  2. Descomprima el OVA descargado mediante la herramienta de extracción que desee.
  3. En el directorio descomprimido, busque el archivo .ofv.
  4. En el archivo .ofv, busque la propiedad VERSION de OVA y registre su valor. Por ejemplo, v1.25.7+vmware.1-tkg.1-765d418b72c247c2310384e640ee075e. La propiedad debe ser similar al siguiente mensaje:
```
<Property ovf:key="VERSION" ovf:type="string" ovf:userConfigurable="false" ovf:value="v1.25.7+vmware.1-tkg.1-765d418b72c247c2310384e640ee075e"/>
```
- Si ya cargó el archivo OVA de Ubuntu predeterminado para la versión de Kubernetes de destino en vSphere, puede recuperar la versión de la imagen del sistema operativo inspeccionando las propiedades de la máquina virtual de OVA en la interfaz de usuario de vSphere o mediante la CLI govc. Para utilizar este método, recupere la versión de la imagen del sistema operativo antes de convertir la máquina virtual de OVA en una plantilla.
  - Para recuperar la versión de imagen del sistema operativo de la interfaz de usuario de vSphere:
    1. Busque la máquina virtual de OVA y abra la pestaña Configurar (Configure) en la página de resumen de la máquina virtual de OVA.
    2. Vaya a Ajustes –> Opciones de vApp (Settings –> vApp Options).
    3. En la tabla Propiedades (Properties), busque la clave VERSIÓN (VERSION) y registre su Valor predeterminado (Default Value). Por ejemplo, v1.25.7+vmware.1-tkg.1-765d418b72c247c2310384e640ee075e.
  - Para recuperar la versión de la imagen del sistema operativo mediante la CLI govc, ejecute el comando govc vm.info. Por ejemplo:
```
govc vm.info -json /dc0/vm/ubuntu-2004-kube-v1.25.7+vmware.1-tkg.1 | jq
```
    En el resultado, busque "Id": "VERSION" y registre el valor de la propiedad "DefaultValue". Por ejemplo:
```
{
"Key": 10,
"ClassId": "",
"InstanceId": "",
"Id": "VERSION",
"Category": "Cluster API Provider (CAPI)",
"Label": "VERSION",
"Type": "string",
"TypeReference": "",
"UserConfigurable": false,
"DefaultValue": "v1.25.7+vmware.1-tkg.1-765d418b72c247c2310384e640ee075e",
"Value": "",
"Description": ""
}
```

Compilar una imagen de Linux

Para compilar una imagen de Linux:

Complete los pasos de Crear una imagen de Linux para clústeres basados en planes en vSphere, pero con la siguiente excepción. Al configurar la cadena de versión para la imagen personalizada en metadata.json, establézcala en el valor que recuperó en el paso Recuperar la versión de imagen del sistema operativo anterior, en lugar de v1.25.7+vmware.1-myorg.0 como se recomienda en la sección Compilar una imagen de Linux. Por ejemplo:
```
{
 "VERSION": "v1.25.7+vmware.1-tkg.1-765d418b72c247c2310384e640ee075e"
}
```
Después de completar los pasos de la sección Compilar una imagen de Linux, vuelva a esta página y continúe con Cargar la imagen de Linux en vSphere a continuación.

Cargar la imagen de Linux en vSphere

Después de completar los pasos descritos en la sección Compilar una imagen de Linux, realice lo siguiente:

Si cargó el archivo OVA de Ubuntu predeterminado para la versión de Kubernetes de destino en vSphere, elimine el OVA predeterminado antes de cargar el OVA personalizado.
Cargue el archivo OVA personalizado en vSphere. Para obtener instrucciones, consulte Importar la plantilla de imagen base en vSphere en Preparar para implementar clústeres de administración para vSphere.

Qué hacer a continuación

Ahora puede implementar clústeres de carga de trabajo y administración mediante la imagen personalizada. Para obtener instrucciones, consulte: