GDC 上の VM ランタイムを使用して VM 情報を一覧取得する

このドキュメントは、Google Distributed Cloud を実行するアプリケーション オーナーを対象としています。このドキュメントでは、GDC 上の VM ランタイムを使用して Google Distributed Cloud で実行される VM を一覧取得する方法について説明します。各 VM に関する追加情報を表示することもできます。

始める前に

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

VM を一覧取得する

すべての Namespace の VM とそれらのステータス、または特定の Namespace の VM のみを一覧取得できます。

すべての Namespace

クラスタ内の VM のリストを表示するには、kubectl コマンドを使用します。

  • kubectl get gvm を使用してすべての VM の一覧を表示します。

    kubectl get gvm --all-namespaces

    次の出力例は、VM の情報を示しています。

    NAME   STATUS    AGE   IP
vm1    Running   7m    192.168.2.72
vm2    Running   4m    192.168.2.73

単一の Namespace

特定の Namespace 内の VM の一覧を表示するには、kubectl コマンドで --namespace パラメータを使用します。

  • kubectl get gvm を使用して、Namespace 内の VM の一覧を表示します。

    kubectl get gvm --namespace NAMESPACE_NAME

    NAMESPACE_NAME は、表示する Namespace に置き換えます。

    次の出力例は、VM の情報を示しています。

    NAME   STATUS    AGE   IP
vm1    Running   7m    192.168.2.72

VM の情報を表示する

クラスタ内の特定の VM に関する情報を表示するには、kubectl を使用します。このオプションは、ストレージやネットワーキングなどの VM の追加構成情報を表示する場合に活用できます。

  • kubectl describe gvm を使用して、VM の詳細情報を表示します。

    kubectl describe gvm VM_NAME --namespace NAMESPACE_NAME

    次の値を置き換えます。

    • VM_NAME: VM の名前。
    • NAMESPACE_NAME: VM の Namespace。

    次の出力例のスニペットは、指定した VM に関する詳細情報を示しています。

    Name:         vm1
Namespace:    default
Labels:       <none>
Annotations:  <none>
API Version:  vm.cluster.gke.io/v1
Kind:         VirtualMachine
Metadata:
  Creation Timestamp:  2022-04-25T23:36:24Z
  Finalizers:
    vm.cluster.gke.io/vm-finalizer
  Generation:  1
  Managed Fields:
    API Version:  vm.cluster.gke.io/v1
    Fields Type:  FieldsV1
    fieldsV1:
...
Spec:
  Compute:
  Interfaces:
    Name:          eth0
    Network Name:  pod-network
  Virt Spec:
    Template:
      Metadata:
        Creation Timestamp:  <nil>
        Labels:
          kubevirt.io/vm:  vm1
      Spec:
        Domain:
          Cpu:
            Cores:  2
          Devices:
            Disks:
              Boot Order:  1
              Disk:
                Bus:  virtio
              Name:   vm1-boot-dv
          Resources:
            Requests:
              Memory:  4Gi
        Volumes:
          Data Volume:
            Name:  vm1-boot-dv
          Name:    vm1-boot-dv
Status:
  ...
  Interfaces:
    Dns Config:
      Nameservers:
        172.26.232.10
    Ip Addresses:
      192.168.4.118
    Mac Address:    f8:8f:ca:00:00:01
    Name:           eth0
    Resource Name:  vm1-eth0-f8b63
    Routes:
      To:  192.168.0.0/16
      To:  172.26.232.0/24
  State:   Running
Events:    <none>

次のステップ