Immagini delle macchine personalizzate di Linux

Questa procedura consente di eseguire i passaggi per creare un'immagine di macchina personalizzata di Linux (Ubuntu) da utilizzare durante la creazione di cluster basati sulla classe in vSphere. È suddivisa nelle sezioni seguenti:

Prerequisiti dell'immagine di Linux indica ciò che è necessario per creare e utilizzare correttamente un'immagine di Linux personalizzata.
Recupero dela versione dell'immagine del sistema operativo indica come recuperare la versione dell'immagine del sistema operativo da un file OVA predefinito per vSphere.
Creazione di un'immagine di Linux illustra come utilizzare Kubernetes Image Builder e Docker per personalizzare e creare un'immagine.
Caricamento dell'immagine di Linux in vSphere indica come caricare l'immagine di Linux personalizzata in vSphere.

Per creare un'immagine di macchina personalizzata di Linux per i cluster basati sul piano (legacy), vedere Immagini delle macchine personalizzate di Linux (legacy). Per ulteriori informazioni sui tipi di cluster in Tanzu Kubernetes Grid, vedere Tipi di cluster del carico di lavoro.

Prerequisiti dell'immagine di Linux

Per creare un'immagine di macchina personalizzata di Linux, è necessario:

Un account in vSphere
Una workstation macOS o Linux in cui sia installato quanto segue:
- Docker Desktop
- La CLI Kubernetes, kubectl
- (Facoltativo) La CLI govc

Recupero della versione dell'immagine del sistema operativo

Questo passaggio consente di recuperare la versione dell'immagine del sistema operativo associata al file OVA di Ubuntu predefinito per la versione di Kubernetes che si desidera utilizzare per l'immagine personalizzata. Questa versione dell'immagine del sistema operativo verrà assegnata all'immagine personalizzata nel passaggio seguente Creazione di un'immagine di Linux.

Per recuperare la versione dell'immagine del sistema operativo, eseguire una delle operazioni seguenti in base al proprio caso d'uso:

Se si dispone di un cluster di gestione in esecuzione creato utilizzando la versione predefinita di Kubernetes per la versione di Tanzu Kubernetes Grid corrente, è possibile recuperare la versione dell'immagine del sistema operativo dal cluster:
1. Impostare il contesto di kubectl sul cluster di gestione.
2. Nell'elenco dei TKr disponibili, scegliere la versione di Tanzu Kubernetes (TKr) per la versione di Kubernetes che si desidera utilizzare per l'immagine personalizzata. Ad esempio, v1.25.7---vmware.1-tkg.1. Per visualizzare un elenco dei TKr disponibili, eseguire:
```
kubectl get tkr
```
3. Aprire il TKr e individuare la proprietà osImages. Questa proprietà specifica i nomi degli oggetti OSImage associati al TKr.
4. Individuare e aprire l'oggetto OSImage per il file OVA di Ubuntu predefinito. Il nome dell'oggetto OSImage corrisponde a uno dei nomi di osImages del TKr.
```
kubectl get osimages
```
5. Nell'oggetto OSImage per il file OVA di Ubuntu predefinito, individuare il valore della proprietà version in spec.image.ref e prenderne nota. Ad esempio, v1.25.7+vmware.1-tkg.1-765d418b72c247c2310384e640ee075e.
Se non si dispone di un cluster di gestione in esecuzione creato utilizzando la versione di Kubernetes predefinita per la versione di Tanzu Kubernetes Grid corrente, è possibile recuperare la versione dell'immagine del sistema operativo direttamente dal file OVA di Ubuntu predefinito, in locale o da vSphere:
- Per recuperare la versione dell'immagine del sistema operativo in locale:
  1. Scaricare il file OVA di Ubuntu predefinito per la versione di Kubernetes di destinazione da Customer Connect:
    1. Passare alla pagina dei download di Tanzu Kubernetes Grid accedendo con le credenziali di VMware Customer Connect e facendo clic su Vai ai download (Go to Downloads).
    2. Scaricare il file OVA. Ad esempio, Ubuntu 2004 Kubernetes v1.25.7 OVA.
  2. Decomprimere il file OVA scaricato utilizzando lo strumento di estrazione desiderato.
  3. Nella directory decompressa, individuare il file .ofv.
  4. Nel file .ofv cercare la proprietà VERSION di OVA e registrarne il valore. Ad esempio, v1.25.7+vmware.1-tkg.1-765d418b72c247c2310384e640ee075e. La proprietà è simile alla seguente:
```
<Property ovf:key="VERSION" ovf:type="string" ovf:userConfigurable="false" ovf:value="v1.25.7+vmware.1-tkg.1-765d418b72c247c2310384e640ee075e"/>
```
- Se il file OVA di Ubuntu predefinito per la versione di Kubernetes di destinazione è già stato caricato in vSphere, in alternativa è possibile recuperare la versione dell'immagine del sistema operativo ispezionando le proprietà della macchina virtuale di OVA nell'interfaccia utente di vSphere o utilizzando la CLI govc. Per utilizzare questo metodo, recuperare la versione dell'immagine del sistema operativo prima di convertire la macchina virtuale di OVA in un modello.
  - Per recuperare la versione dell'immagine del sistema operativo dall'interfaccia utente di vSphere:
    1. Individuare la macchina virtuale di OVA e aprire la scheda Configura (Configure) nella pagina di riepilogo della macchina virtuale di OVA.
    2. Passare a Impostazioni (Settings) -> Opzioni vApp (vApp Options).
    3. Nella tabella Proprietà (Properties) individuare la chiave VERSION e registrarne il Valore predefinito. Ad esempio, v1.25.7+vmware.1-tkg.1-765d418b72c247c2310384e640ee075e.
  - Per recuperare la versione dell'immagine del sistema operativo utilizzando la CLI govc, eseguire il comando govc vm.info. Ad esempio:
```
govc vm.info -json /dc0/vm/ubuntu-2004-kube-v1.25.7+vmware.1-tkg.1 | jq
```
    Nell'output, cercare "Id": "VERSION" e prendere nota del valore della proprietà "DefaultValue". Ad esempio:
```
{
"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": ""
}
```

Creazione di un'immagine di Linux

Per creare un'immagine di Linux:

Completare i passaggi di Creazione di un'immagine di Linux per i cluster basati sul piano in vSphere, ma con l'eccezione seguente. Quando si imposta la stringa della versione per l'immagine personalizzata in metadata.json, impostarla sul valore recuperato nel passaggio precedente Recupero della versione dell'immagine del sistema operativo anziché v1.25.7+vmware.1-myorg.0 come consigliato nella sezione Creazione di un'immagine di Linux. Ad esempio:
```
{
 "VERSION": "v1.25.7+vmware.1-tkg.1-765d418b72c247c2310384e640ee075e"
}
```
Dopo aver completato i passaggi della sezione Creazione di un'immagine di Linux, tornare in questa pagina e procedere con il passaggio Caricamento dell'immagine di Linux in vSphere di seguito.

Caricamento dell'immagine di Linux in vSphere

Dopo aver completato i passaggi della sezione Creazione di un'immagine di Linux, eseguire le operazioni seguenti:

Se il file OVA di Ubuntu predefinito per la versione di Kubernetes di destinazione è stato caricato in vSphere, eliminare il file OVA predefinito prima di caricare il file OVA personalizzato.
Caricare il file OVA personalizzato in vSphere. Per istruzioni, vedere Importazione del modello di immagine di base in vSphere in Preparazione della distribuzione dei cluster di gestione in vSphere.

Passaggi successivi

Ora è possibile distribuire cluster di gestione e del carico di lavoro utilizzando l'immagine personalizzata. Per istruzioni, vedere: