This site will be decommissioned on December 31st 2024. After that date content will be available at techdocs.broadcom.com.

 

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

このトピックでは、Windows ワーカー ノード上で Windows ベースのワークロードを実行するワークロード クラスタを作成および管理するために Tanzu Kubernetes Grid (TKG) が使用できる、Windows カスタム マシン イメージを作成する方法について説明します。

レガシー Windows コンポーネント（.NET Framework など）に基づいてアプリケーションをビルドし、vSphere に Windows コンテナを展開する場合は、次の手順に従って Windows カスタム マシン イメージをビルドします。次のセクションに分かれています。

注

VMware は、プロキシが設定された環境またはエアギャップされた環境での Windows ワーカー ノードを持つ TKG ワークロード クラスタをサポートしていません。

Windows イメージの前提条件

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

  • vSphere 6.7 Update 3 以降。

  • Linux ワークステーション。

    注

    Kubernetes Image Builder で使用されるオープンソースの packer ユーティリティの問題により、MacOS マシンで Windows マシン イメージをビルドできません。

  • Docker デスクトップ。インストールするには、「Docker 製品のダウンロード ページ」を参照してください。CLI から Docker をインストールするには、snap の代わりに apt を使用します。
  • Tanzu CLI。インストールするには、「スタンドアローン管理クラスタで使用する Tanzu CLI およびその他のツールのインストール」の「Tanzu CLI および kubectl のダウンロードと展開」を参照してください。
  • TKG v2.2 スタンドアローン管理クラスタ。
  • 最近（2021 年 4 月以降）の Windows Server 2019 ISO イメージ。Microsoft Developer Network (MSDN) または Volume Licensing (VL) アカウントからダウンロードします。評価メディアの使用はサポートも推奨もされていません。
  • 最新の VMware Tools Windows ISO イメージ。VMware Tools からダウンロードします。
  • カスタム Windows仮想マシン テンプレートに対応できる vCenter Server 上のデータストア。起動サイズが 10 GB（シン プロビジョニング）を超える場合があります。

Windows イメージのビルド

  1. 次の手順に従って、Ubuntu または Photon OVA イメージを vCenter Server にインポートし、カスタム イメージのテンプレートとして使用します。

    1. https://customerconnect.vmware.com にアクセスし、VMware Customer Connect の認証情報を使用してログインします。
    2. Tanzu Kubernetes Grid のダウンロード ページに移動します。
    3. VMware Tanzu Kubernetes Grid の行で、[ダウンロードに移動] をクリックします。
    4. [バージョンの選択 (Select Version)] ドロップダウンで、[2.2.0] を選択します。
    5. [製品のダウンロード (Product Downloads)] で、Kubernetes OVAs for VMware Tanzu Kubernetes Grid 2.2.0 というラベルの付いたセクションまでスクロールして、Ubuntu 2004 Kubernetes v1.25.7 OVA または Photon v3 Kubernetes v1.25.7 OVA を見つけ、[今すぐダウンロード (Download Now)] をクリックします。
    6. vCenter Server にログインします。
    7. ホストまたはクラスタを右クリックし、[OVF テンプレートの展開]… をクリックしてイメージをインポートします。
    8. インポートしたイメージを右クリックし、[テンプレート] にカーソルを合わせ、[テンプレートに変換] をクリックします。
    9. テンプレートの準備ができていることを確認するには、ホストまたはクラスタを選択し、[仮想マシン] タブ、[仮想マシン テンプレート] の順に選択して、テンプレートが一覧表示されていることを確認します。

  2. 次の手順に従って、Windows Server 2019 ISO および VMware Tools Windows ISO イメージをデータストアにインポートします。

    1. vCenter Server にログインします。
    2. データストアに移動し、[ファイル] タブをクリックします。
    3. iso フォルダを開くか、フォルダが存在しない場合は [新規フォルダ] をクリックして作成します。
    4. 両方の ISO ファイルを iso フォルダにアップロードします。

  3. 次の構成を使用して、builder.yaml という名前の YAML ファイルを作成します。

    apiVersion: v1
kind: Namespace
metadata:
 name: imagebuilder
---
apiVersion: v1
kind: Service
metadata:
 name: imagebuilder-wrs
 namespace: imagebuilder
spec:
 selector:
   app: image-builder-resource-kit
 type: NodePort
 ports:
 - port: 3000
   targetPort: 3000
   nodePort: 30008
---
apiVersion: apps/v1
kind: Deployment
metadata:
 name: image-builder-resource-kit
 namespace: imagebuilder
spec:
 selector:
   matchLabels:
     app: image-builder-resource-kit
 template:
   metadata:
     labels:
       app: image-builder-resource-kit
   spec:
     nodeSelector:
       kubernetes.io/os: linux
     containers:
     - name: windows-imagebuilder-resourcekit
       image: projects.registry.vmware.com/tkg/windows-resource-bundle:v1.25.7_vmware.2-tkg.1
       imagePullPolicy: Always
       ports:
         - containerPort: 3000

  4. 次のコマンドを実行して、Kubernetes CLI を管理クラスタに接続します。

    kubectl config use-context MY-MGMT-CLUSTER-admin@MY-MGMT-CLUSTER

    ここで、MY-MGMT-CLUSTER は管理クラスタの名前です。

  5. builder.yaml 構成ファイルを適用します。

    kubectl apply -f ./builder.yaml

    これにより、マシンがイメージのビルド プロセス中に必要なファイルを HTTP の場所から取得できるコンテナが展開されます。出力は次のようになります。

    namespace/imagebuilder created
service/imagebuilder-wrs created
deployment.apps/image-builder-resource-kit created

  6. コンテナが実行されていることを確認するには、次のコマンドを実行します。

    kubectl get pods -n imagebuilder

    出力は次のようになります。

    NAME                                          READY   STATUS    RESTARTS   AGE
image-builder-resource-kit-756ccdc4ff-rcxpq   1/1     Running   0          4m16s

  7. 管理クラスタの制御プレーン IP アドレスを取得します。

    1. クラスタのノードを wide 出力とともにリストします。

      kubectl get nodes -o wide

    2. 出力から、ROLE が control-plane としてリストされているノードの INTERNAL-IP 値を記録します。

  8. 次の構成を使用して、空のフォルダに windows.json という名前の JSON ファイルを作成します。

    {
  "additional_executables_destination_path": "C:\\ProgramData\\Temp",
  "additional_executables_list": "http://CONTROLPLANE-IP:30008/files/antrea-windows/antrea-windows-advanced.zip,http://CONTROLPLANE-IP:30008/files/kubernetes/kube-proxy.exe",
  "additional_executables": "true",
  "additional_prepull_images": "mcr.microsoft.com/windows/servercore:ltsc2019",
  "build_version": "windows-2019-kube-v1.25.7",
  "cloudbase_init_url": "http://CONTROLPLANE-IP:30008/files/cloudbase_init/CloudbaseInitSetup_1_1_4_x64.msi",
  "cluster": "VSPHERE-CLUSTER-NAME",
  "containerd_sha256_windows": "2e0332aa57ebcb6c839a8ec807780d662973a15754573630bea249760cdccf2a",
  "containerd_url": "http://CONTROLPLANE-IP:30008/files/containerd/cri-containerd-v1.6.18+vmware.1.windows-amd64.tar",
  "containerd_version": "v1.6.18",
  "convert_to_template": "true",
  "create_snapshot": "false",
  "datacenter": "DATACENTER-NAME",
  "datastore": "DATASTORE-NAME",
  "disable_hypervisor": "false",
  "disk_size": "40960",
  "goss_inspect_mode": "true",
  "insecure_connection": "true",
  "kubernetes_base_url": "http://CONTROLPLANE-IP:30008/files/kubernetes/",
  "kubernetes_semver": "v1.25.7+vmware.2",
  "kubernetes_series": "v1.25.7",
  "linked_clone": "false",
  "load_additional_components": "true",
  "netbios_host_name_compatibility": "false",
  "network": "NETWORK",
  "nssm_url": "http://CONTROLPLANE-IP:30008/files/nssm/nssm.exe",
  "os_iso_path": "OS-ISO-PATH",
  "password": "VCENTER-PASSWORD",
  "pause_image": "mcr.microsoft.com/oss/kubernetes/pause:3.6",
  "prepull": "false",
  "resource_pool": "",
  "runtime": "containerd",
  "template": "",
  "unattend_timezone": "WINDOWS-TIMEZONE",
  "username": "VCENTER-USERNAME",
  "vcenter_server": "VCENTER-IP",
  "vmtools_iso_path": "VMTOOLS-ISO-PATH",
  "windows_updates_categories": "CriticalUpdates SecurityUpdates UpdateRollups",
  "windows_updates_kbs": "",
  "wins_version": ""
}

    ここで、

    • WINDOWS-TIMEZONE は、環境の Windows タイムゾーンです。たとえば、GMT Standard Timeです。
    • VSPHERE-CLUSTER-NAME は、vSphere クラスタの名前です。たとえば、VSAN-Clusterです。
    • VCENTER-PASSWORD は vCenter Server のパスワードです。
    • VCENTER-USERNAME は vCenter Server のユーザー名です。
    • DATASTORE-NAME は、vCenter Server に表示されるデータストアの名前です。たとえば、vsanDatastore などです。
    • DATACENTER-NAME は、vCenter Server に表示されるデータセンターの名前です。たとえば、VSAN-DC などです。
    • VMTOOLS-ISO-PATH は、次のような構造を持つ VMware Tools ISO ファイルへのパスです。[DATASTORE-NAME] iso/VMware-tools-windows-11.2.5-17337674.iso。
    • NETWORK は、vCenter Server の [メニュー] > [ネットワーク] > [ネットワーク] に表示されるネットワークまたはポート グループの名前です。たとえば、VM Networkです。
    • OS-ISO-PATH は、次のような構造を持つ Windows Server 2019 ISO ファイルへのパスです。[DATASTORE-NAME] iso/en-us_windows_server_2019_updated_aug_2022_x64_dvd_a6431a28.iso。
    • VCENTER-IP は、vCenter Server の IP アドレスまたは FQDN です。
    • CONTROLPLANE-IP は、上記で取得した管理クラスタの IP アドレスです。
    • CONTAINERD-URL および CONTAINERD-SHA は、上記で取得した containerd.path および containerd.sha256 値です。

  9. 制御プレーンの nodePort エンドポイントで Windows リソース バンドルをクエリし、既存のファイル パスを検証します。

    curl http://CONTROLPLANE-IP:30008

  10. 次の手順に従って、Windows 設定を含む XML ファイルを追加します。

    1. VMware {code} Sample Exchange の autounattend.xml に移動します。
    2. [ダウンロード] を選択します。
    3. Windows Server 2019 評価版を使用している場合は、<ProductKey>...</ProductKey> を削除します。
    4. ファイル autounattend.xml に名前を付けます。
    5. そのファイルを、windows.json ファイルと同じフォルダに保存します。

  11. windows.json および autounattend.xml ファイルを含むフォルダから、次のコマンドを実行してカスタム イメージをビルドします。

    docker run -it --rm --mount type=bind,source=$(pwd)/windows.json,target=/windows.json --mount type=bind,source=$(pwd)/autounattend.xml,target=/home/imagebuilder/packer/ova/windows/windows-2019/autounattend.xml -e PACKER_VAR_FILES="/windows.json" -e IB_OVFTOOL=1 -e IB_OVFTOOL_ARGS='--skipManifestCheck' -e PACKER_FLAGS='-force -on-error=ask' -t projects.registry.vmware.com/tkg/image-builder:v0.1.13_vmware.3 build-node-ova-vsphere-windows-2019

    エラーが表示されたり、ビルドがハングしたりする場合は、ワークステーションの Packer ログを参照して、windows.json 構成ファイルの問題をトラブルシューティングします。また、上記のコマンド ラインに -e PACKER_LOG=1 を追加して、コンソールでより詳細なログを受信することもできます。

  12. Windows イメージが使用できる状態になっていることを確認するには、vCenter Server でホストまたはクラスタを選択し、[仮想マシン] タブ、[仮想マシン テンプレート] の順に選択して、Windows イメージが一覧表示されていることを確認します。

ワークロード クラスタに Windows イメージを使用する

この手順では、Windows ワークロード クラスタの構成ファイルを作成し、構成ファイルで Windows イメージを参照してから、Tanzu CLI を使用してワークロード クラスタを作成します。

  1. 「スタンドアローン管理クラスタを使用する vSphere の構成ファイル」の手順に従って、管理クラスタ構成ファイルをコピーして新しい名前で保存します。

  2. 新しい構成ファイルで、以下を追加または変更します。

    IS_WINDOWS_WORKLOAD_CLUSTER: "true"

  3. 「ワークロード クラスタの作成」の説明に従って、ワークロード クラスタを展開します。

check-circle-line exclamation-circle-line close-line
Scroll to top icon