GDC 上の VM ランタイムを使用して、特定の CPU とメモリリソースを持つ VM を作成する

このドキュメントは、Google Distributed Cloud を実行するアプリケーションオーナーとプラットフォーム管理者を対象としています。このドキュメントでは、GDC 上の VM ランタイムを使用する VM を作成する際に、VM タイプを作成して使用する方法、または CPU リソースとメモリリソースを手動で指定する方法について説明します。

始める前に

このドキュメントの内容を実施するには、次のリソースへのアクセス権が必要です。

Google Distributed Cloud バージョン 1.12.0（anthosBareMetalVersion: 1.12.0）以降のクラスタへのアクセス権。ワークロードを実行可能な、どのクラスタタイプでも使用できます。必要に応じて、Compute Engine 上の Google Distributed Cloud を試すか、クラスタ作成の概要をご覧ください。
kubectl のプラグインとしてインストールされた virtctl クライアントツール。必要に応じて、virtctl クライアントツールをインストールします。

VM を作成する

VM を作成する際は、CPU とメモリの要件を手動で指定できます。これができることにより、アプリケーションのニーズに合わせて適切なコンピューティングリソースを持つ VM を作成できます。

VM を作成し、CPU とメモリの要件を手動で指定するには、次の手順を実行します。

CLI

kubectl を使用して VM を作成します。
```
kubectl virt create vm VM_NAME \
  --image ubuntu20.04 \
  --cpu CPU_NUMBER \
  --memory MEMORY_SIZE
```
次の値を置き換えます。
- VM_NAME: VM の名前。名前の制約の詳細については、オブジェクト名と ID をご覧ください。
- CPU_NUMBER: VM に割り当てる仮想 CPU（vCPU）の数。
  - 1～96 個の vCPU を VM に割り当てることができます。
- MEMORY_SIZE: VM に割り当てるメモリ量。
  - 1M～1T のメモリを VM に割り当てることができます。詳細については、メモリリソースユニットをご覧ください。
注: ~/google-virtctl ディレクトリに VM_NAME.yaml ファイルが作成されます。このファイルの内容を表示して、GDC 上の VM ランタイムによって作成された Kubernetes リソースの定義を確認できます。

マニフェスト

選択したエディタで VirtualMachine マニフェスト（my-custom-vm.yaml など）を作成します。
```
nano my-custom-vm.yaml
```
次の YAML マニフェストをコピーして貼り付けます。
```
apiVersion: vm.cluster.gke.io/v1
kind: VirtualMachine
metadata:
  name: VM_NAME
spec:
  compute:
    cpu:
      vcpus: VCPU_NUMBER
    memory:
      capacity: MEMORY_SIZE
  interfaces:
    - name: eth0
      networkName: pod-network
      default: true
  disks:
    - virtualMachineDiskName: VM_NAME-boot-dv
      boot: true
```
この YAML ファイルで、以下の設定を定義します。
- VM_NAME: VM の名前。名前の制約の詳細については、オブジェクト名と ID をご覧ください。
- VCPU_NUMBER: VM に割り当てる vCPU の数（省略可）。
  - 1～96 個の vCPU を VM に割り当てることができます。
- MEMORY_SIZE: VM に割り当てるメモリ量。
  - 1M～1T のメモリを VM に割り当てることができます。詳細については、メモリリソースユニットをご覧ください。
VM が eth0 をデフォルトの pod-network ネットワークに接続します。

VM_NAME-boot-dv という名前のブートディスクがすでに存在している必要があります。詳細については、仮想ディスクを作成して管理するをご覧ください。
エディタで、VM マニフェストを保存して閉じます。
kubectl を使用して VM を作成します。
```
kubectl apply -f my-custom-vm.yaml
```

VM タイプを作成して使用する

GDC 上の VM ランタイムを有効にすると、新しい VirtualMachineType カスタムリソース定義が利用可能になります。この定義は、VM の CPU リソースとメモリリソースの指定に使用されます。必要なワークロードに合わせて VM タイプを作成し、それらのタイプに基づいて一貫性のあるコンピューティングリソースのセットを VM に適用できます。

Google Distributed Cloud で GDC 上の VM ランタイムが有効になっている場合、vm-controller-manager は事前定義された VM タイプをインストールします。デフォルトの example-machinetype VM タイプの定義は次のとおりです。

  apiVersion: vm.cluster.gke.io/v1
  kind: VirtualMachineType
  metadata:
    name: "example-machinetype"
    labels:
      vm.cluster.gke.io/predefined-machinetype: "true"
  spec:
    cpu:
      vcpus: 2
    memory:
      capacity: 4G

この事前定義された VM タイプは更新できません。vm-controller-manager が起動または再起動したとき、この VM タイプがクラスタに存在しない場合（この VM タイプを削除した場合など）は、再インストールされます。

VM タイプを作成する

VM タイプは、ワークロードのコンピューティングニーズに合わせて独自のものを作成できます。

選択したエディタで VirtualMachineType マニフェスト（my-vm-type.yaml など）を作成します。
```
nano my-vm-type.yaml
```
次の YAML マニフェストをコピーして貼り付けます。
```
apiVersion: vm.cluster.gke.io/v1
kind: VirtualMachineType
metadata:
  name: my-vm-type
spec:
  cpu:
    vcpus: VCPU_NUMBER
  memory:
    capacity: MEMORY_SIZE
```
この VM タイプでは、次の設定を定義します。
- VM_NAME: VM の名前。名前の制約の詳細については、オブジェクト名と ID をご覧ください。
- VCPU_NUMBER: VM に割り当てる vCPU の数（省略可）。
  - 1～96 個の vCPU を VM に割り当てることができます。
- MEMORY_SIZE: VM に割り当てるメモリ量。
  - 1M～1T のメモリを VM に割り当てることができます。詳細については、メモリリソースユニットをご覧ください。
VM タイプのマニフェストをエディタに保存して閉じます。
kubectl を使用して VM タイプを作成します。
```
kubectl apply -f my-vm-type.yaml
```

VM タイプを使用して VM を作成する

VirtualMachine マニフェストで VM タイプを指定して、事前定義された compute 設定を VM に適用します。

選択したエディタで VirtualMachine マニフェスト（my-custom-vm.yaml など）を作成します。
```
nano my-custom-vm.yaml
```
次の YAML マニフェストをコピーして貼り付けます。
```
apiVersion: vm.cluster.gke.io/v1
kind: VirtualMachine
metadata:
  name: VM_NAME
spec:
  compute:
    virtualMachineTypeName: my-vm-type
  interfaces:
    - name: eth0
      networkName: pod-network
      default: true
  disks:
    - virtualMachineDiskName: VM_NAME-boot-dv
      boot: true
```
この YAML ファイルで、my-vm-type など、前のセクションで作成したカスタム VM タイプの名前を virtualMachineTypeName の値として指定します。

VM が eth0 をデフォルトの pod-network ネットワークに接続します。

VM_NAME-boot-dv という名前のブートディスクがすでに存在している必要があります。詳細については、仮想ディスクを作成して管理するをご覧ください。
エディタで、VM マニフェストを保存して閉じます。
kubectl を使用して VM を作成します。
```
kubectl apply -f my-custom-vm.yaml
```

次のステップ

Google Distributed Cloud で VM を編集する。
VM が不要になった場合は、Google Distributed Cloud で VM を削除します。