ステートフル ワークロードを検査する

このページでは、Google Distributed Cloud（GDC）エアギャップ アプライアンス Kubernetes クラスタで実行されている既存のステートフル ワークロードを検査する方法について説明します。ステートフル ワークロードを使用すると、永続コンテナ ストレージでアプリケーションを実行できます。GDC コンソールまたは kubectl CLI を使用してステートフル ワークロードを表示し、リソース使用量とワークロードの健全性をモニタリングできます。

このページは、組織のアプリケーション ワークロードの管理を担当するアプリケーション オペレーター グループ内のデベロッパーを対象としています。

始める前に

事前構成されたベアメタル Kubernetes クラスタに対してコマンドを実行するには、次のリソースがあることを確認してください。

  1. Kubernetes クラスタ名を確認するか、プラットフォーム管理者にクラスタ名を確認します。

  2. まだ Kubernetes クラスタの kubeconfig ファイルがない場合は、ログインして生成します。

  3. これらの手順では、Kubernetes クラスタの kubeconfig パスを使用して CLUSTER_KUBECONFIG を置き換えます。

プロジェクトにデプロイされたすべてのワークロードを表示するために必要な権限を取得するには、プロジェクト Namespace でワークロード閲覧者ロール（workload-viewer）を付与するよう組織の IAM 管理者に依頼してください。

ステートフル ワークロードを検査するために必要な権限を取得するには、組織の IAM 管理者に、プロジェクトの Namespace で Namespace 管理者ロール（namespace-admin）を付与するよう依頼してください。

プロジェクトのコンテナ ワークロードを表示する

次のコマンドを実行して、プロジェクト内のすべての Pod を一覧表示します。

kubectl get pods -n PROJECT_NAMESPACE

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

NAME                        READY   STATUS    RESTARTS   AGE
nginx-workload-ah-aa-1228   1/1     Running   0          12h
nginx-workload-ah-ab-6784   1/1     Running   0          11h
nginx-workload-ah-ac-0045   1/1     Running   0          12h

StatefulSet リソースを検査する

StatefulSet リソースのコンポーネントに関する詳細情報をリクエストするには、検査するエンティティを直接ターゲットにするコマンドを実行します。

StatefulSet オブジェクト情報を取得する

StatefulSet オブジェクトの詳細情報を取得するには、次のコマンドを実行します。

kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
    describe statefulset STATEFULSET_NAME

次のように置き換えます。

  • CLUSTER_KUBECONFIG: StatefulSet オブジェクトを実行している Kubernetes クラスタの kubeconfig ファイル。

  • NAMESPACE: プロジェクトの Namespace。

  • STATEFULSET_NAME: StatefulSet オブジェクトの名前。

ライブ構成を YAML 形式で表示する

StatefulSet リソースのライブ構成を YAML 形式で表示するには、次のコマンドを実行します。

kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
    get statefulset STATEFULSET_NAME -o yaml

次のように置き換えます。

  • CLUSTER_KUBECONFIG: StatefulSet オブジェクトを実行している Kubernetes クラスタの kubeconfig ファイル。

  • NAMESPACE: プロジェクトの Namespace。

  • STATEFULSET_NAME: StatefulSet オブジェクトの名前。

ポッドの一覧表示

StatefulSet によって作成された Pod オブジェクトを一覧表示するには、次のコマンドを実行します。

kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
    get pods -l app=APP_NAME

このコマンドで -l フラグを指定すると、APP_NAME ラベルが付いたすべての Pod オブジェクトが一覧表示されます。

次のように置き換えます。

  • CLUSTER_KUBECONFIG: StatefulSet オブジェクトを実行している Kubernetes クラスタの kubeconfig ファイル。

  • NAMESPACE: プロジェクトの Namespace。

  • APP_NAME: StatefulSet オブジェクトによって管理されるステートフル アプリケーションの名前。

特定の Pod の情報を取得する

クラスタ内の特定の Pod に関する情報を取得するには、次のコマンドを実行します。

kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
    describe pod POD_NAME

次のように置き換えます。

  • CLUSTER_KUBECONFIG: Pod を実行している Kubernetes クラスタの kubeconfig ファイル。

  • NAMESPACE: プロジェクトの Namespace。

  • POD_NAME: StatefulSet オブジェクトによって管理される Pod の名前。

PVC を一覧表示する

クラスタ内の PersistentVolumeClaim（PVC）オブジェクトを一覧表示するには、次のコマンドを実行します。

kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
    get pvc

次のように置き換えます。

  • CLUSTER_KUBECONFIG: PVC を実行している Kubernetes クラスタの kubeconfig ファイル。

  • NAMESPACE: プロジェクトの Namespace。

特定の PVC 情報を取得する

クラスタ内の特定の PersistentVolumeClaim（PVC）に関する情報を取得するには、次のコマンドを実行します。

kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
    describe pvc PVC_NAME

次のように置き換えます。

  • CLUSTER_KUBECONFIG: PVC を実行している Kubernetes クラスタの kubeconfig ファイル。

  • NAMESPACE: プロジェクトの Namespace。

  • PVC_NAME: StatefulSet オブジェクト用に構成された PVC の名前。

PV 情報を取得する

クラスタ内の特定の PersistentVolume（PV）に関する情報を取得するには、次のコマンドを実行します。

kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
    describe pv PV_NAME

次のように置き換えます。

  • CLUSTER_KUBECONFIG: PV を実行している Kubernetes クラスタの kubeconfig ファイル。

  • NAMESPACE: プロジェクトの Namespace。

  • PV_NAME: StatefulSet オブジェクト用に構成された PV の名前。