Linux カスタムマシンイメージ

この手順では、vSphere でクラスベースのクラスタを作成するときに使用する Linux (Ubuntu) カスタムマシンイメージをビルドする方法について説明します。次のセクションに分かれています。

「Linux イメージの前提条件」には、カスタムの Linux イメージを正常にビルドして使用するために必要な情報が一覧表示されています。
「OS イメージバージョンの取得」では、vSphere のデフォルトの OVA から OS イメージバージョンを取得する方法について説明します。
「Linux イメージのビルド」では、Kubernetes Image Builder と Docker を使用してイメージをカスタマイズおよびビルドする方法について説明します。
「vSphere への Linux イメージのアップロード」では、カスタムの Linux イメージを vSphere にアップロードする方法について説明します。

プランベース（レガシー）クラスタの Linux カスタムマシンイメージを構築するには、「Linux カスタムマシンイメージ（レガシー）」を参照してください。Tanzu Kubernetes Grid のクラスタタイプの詳細については、「Workload クラスタタイプ」を参照してください。

Linux イメージの前提条件

Linux カスタムマシンイメージをビルドするには、以下が必要です。

vSphere 上のアカウント
以下がインストールされた macOS または Linux ワークステーション：
- Docker デスクトップ
- Kubernetes CLI、kubectl。
- （オプション）govc CLI

OS イメージバージョンの取得

この手順では、カスタムイメージに使用する Kubernetes バージョンのデフォルトの Ubuntu OVA に関連付けられている OS イメージバージョンを取得します。この OS イメージバージョンは、以下の「Linux イメージのビルド」の手順でカスタムイメージに割り当てます。

OS イメージバージョンを取得するには、使用事例に応じて次のいずれかを実行します。

現在の Tanzu Kubernetes Grid バージョンのデフォルトの Kubernetes バージョンを使用して作成された実行中の管理クラスタがある場合は、クラスタから OS イメージバージョンを取得できます。
1. kubectl コンテキストを管理クラスタに設定します。
2. 使用可能な TKr のリストから、カスタムイメージに使用する Kubernetes バージョンの Tanzu Kubernetes リリース (TKr) を選択します。たとえば、v1.24.10---vmware.1-tkg.1 などです。使用可能な TKr を一覧表示するには、次のコマンドを実行します。
```
kubectl get tkr
```
3. TKr を開き、osImages プロパティを見つけます。このプロパティは、TKr に関連付けられている OSImage オブジェクトの名前を指定します。
4. デフォルトの Ubuntu OVA の OSImage オブジェクトを見つけて開きます。OSImage オブジェクトの名前は、TKr の osImages のいずれかの名前と一致します。
```
kubectl get osimages
```
5. デフォルトの Ubuntu OVA の OSImage オブジェクトで、spec.image.ref の下にある version プロパティの値を見つけて記録します。たとえば、v1.24.10+vmware.1-tkg.1-765d418b72c247c2310384e640ee075e などです。
現在の Tanzu Kubernetes Grid バージョンのデフォルトの Kubernetes バージョンを使用して作成された実行中の管理クラスタがない場合は、ローカルまたは vSphere で、デフォルトの Ubuntu OVA から OS イメージバージョンを直接取得できます。
- OS イメージバージョンをローカルで取得するには、次の手順を実行します。
  1. Customer Connect からターゲット Kubernetes バージョンのデフォルトの Ubuntu OVA をダウンロードします。
    1. Tanzu Kubernetes Grid のダウンロードページに移動し、VMware Customer Connect 認証情報を使用してログインして、[ダウンロードに移動 (Go to Downloads)] をクリックします。
    2. OVA をダウンロードします。たとえば、Ubuntu 2004 Kubernetes v1.24.10 OVA などです。
  2. 選択した抽出ツールを使用してダウンロードした OVA を展開します。
  3. 解凍したディレクトリで、.ofv ファイルを見つけます。
  4. .ofv ファイルで、OVA の VERSION プロパティを検索し、その値を記録します。たとえば、v1.24.10+vmware.1-tkg.1-765d418b72c247c2310384e640ee075e などです。プロパティは次のようになります。
```
<Property ovf:key="VERSION" ovf:type="string" ovf:userConfigurable="false" ovf:value="v1.24.10+vmware.1-tkg.1-765d418b72c247c2310384e640ee075e"/>
```
- ターゲット Kubernetes バージョンのデフォルトの Ubuntu OVA を vSphere にすでにアップロードしている場合は、vSphere ユーザーインターフェイスで OVA 仮想マシンのプロパティを調べることや、govc CLI を使用して OS イメージバージョンを取得することもできます。この方法を使用するには、OVA 仮想マシンをテンプレートに変換する前に OS イメージバージョンを取得します。
  - vSphere ユーザーインターフェイスから OS イメージバージョンを取得するには、次の手順を実行します。
    1. OVA 仮想マシンを見つけて、OVA 仮想マシンのサマリページで [構成 (Configure)] タブを開きます。
    2. [設定 (Settings)] > [vApp Options (vApp オプション)] に移動します。
    3. [プロパティ (Properties)] テーブルで、VERSION キーを見つけて、その[デフォルト値 (Default Value)] を記録します。たとえば、v1.24.10+vmware.1-tkg.1-765d418b72c247c2310384e640ee075e などです。
  - govc CLI を使用して OS イメージバージョンを取得するには、govc vm.info コマンドを実行します。例：
```
govc vm.info -json /dc0/vm/ubuntu-2004-kube-v1.24.10+vmware.1-tkg.1 | jq
```
    出力で、"Id": "VERSION" を検索し、"DefaultValue" プロパティの値を記録します。例：
```
{
"Key": 10,
"ClassId": "",
"InstanceId": "",
"Id": "VERSION",
"Category": "Cluster API Provider (CAPI)",
"Label": "VERSION",
"Type": "string",
"TypeReference": "",
"UserConfigurable": false,
"DefaultValue": "v1.24.10+vmware.1-tkg.1-765d418b72c247c2310384e640ee075e",
"Value": "",
"Description": ""
}
```

Linux イメージのビルド

Linux イメージをビルドするには、次の手順を実行します。

vSphere 上のプランベースのクラスタの「Linux イメージのビルド」の手順を次の例外を除いて完了します。カスタムイメージのバージョン文字列を metadata.json で設定する場合は、「Linux イメージのビルド」セクションで推奨されている v1.24.10+vmware.1-myorg.0 ではなく、上記の「OS イメージバージョンの取得」の手順で取得した値に設定します。例：
```
{
 "VERSION": "v1.24.10+vmware.1-tkg.1-765d418b72c247c2310384e640ee075e"
}
```
「Linux イメージのビルド」セクションの手順を完了したら、このページに戻り、以下の「Linux イメージを vSphere にアップロード」に進みます。

Linux イメージを vSphere にアップロード

「Linux イメージのビルド」セクションの手順を完了したら、次の手順を実行します。

ターゲットの Kubernetes バージョンのデフォルトの Ubuntu OVA を vSphere にアップロードした場合は、カスタム OVA をアップロードする前にデフォルトの OVA を削除します。
カスタム OVA を vSphere にアップロードします。手順については、「vSphere への管理クラスタの展開の準備」の「基本イメージテンプレートの vSphere へのインポート」を参照してください。

次の手順

これで、カスタムイメージを使用して、管理クラスタとワークロードクラスタを展開できるようになりました。手順については、以下を参照してください。