ワークロードクラスタの問題のトラブルシューティング

このセクションでは、ワークロードクラスタのトラブルシューティングに役立つヒントを示します。スタンドアローン管理クラスタの展開のトラブルシューティングの詳細については、「管理クラスタの問題のトラブルシューティング」を参照してください。

一般的なタスク

`kubectl` を使用したユーザー、コンテキスト、およびクラスタの削除

ユーザー、コンテキスト、およびクラスタの一部またはすべてを削除して kubectl 状態をクリーンアップするには、以下の手順を実行します。

~/.kube/config ファイルを開きます。
削除する user オブジェクトに対して、次のコマンドを実行します。
```
kubectl config unset users.USER-NAME
```
ここで、USER-NAME は、config ファイルにリストされている各トップレベルの user オブジェクトの name プロパティです。
削除する context オブジェクトに対して、次のコマンドを実行します。
```
kubectl config unset contexts.CONTEXT-NAME
```
ここで、CONTEXT-NAME は、config ファイルにリストされている各トップレベルの context オブジェクトの name プロパティで、通常は contexts.mycontext-admin@mycontext の形式になります。
削除する cluster オブジェクトに対して、次のコマンドを実行します。
```
kubectl config unset clusters.CLUSTER-NAME
```
ここで、CLUSTER-NAME は、config ファイルにリストされている各トップレベルの cluster オブジェクトの name プロパティです。
config ファイルに、現在のコンテキストが削除されたクラスタとして一覧表示されている場合は、コンテキストを設定解除します。
```
kubectl config unset current-context
```

パッケージ

デフォルトの YAML ファイルから Grafana をインストールするときにシークレットが作成されない

問題

デフォルトの Grafana 構成ファイルを生成して Grafana のインストールを試みると、インストールが失敗し、「error: Secret in version "v1" cannot be handled as a Secret: illegal base64 data at input byte 4 (reason: BadRequest)」というメッセージが表示される。

解決方法

シークレットを手動で作成し、シークレットタグなしで同じ YAML ファイルを使用して Grafana をインストールします。

「ワークロードクラスタへの Grafana の展開」の手順を実行して、Grafana 構成用の構成ファイルを作成します。
生成された構成ファイルから grafana.secret.* エントリを削除します。

シークレットを手動で作成します。

kubectl create secret generic grafana -n tanzu-system-dashboards  --from-literal=admin=admin

パッケージをデプロイします。

tanzu package install grafana \
--package grafana.tanzu.vmware.com \
--version AVAILABLE-PACKAGE-VERSION \
--values-file grafana-data-values.yaml \
--namespace TARGET-NAMESPACE

「ワークロードクラスタへの Grafana の展開」の残りの手順を実行します。

`tanzu package repository` の実行中にエラーが発生しました

問題

tanzu package repository コマンドがエラーで失敗する。

解決方法

kubectl get pkgr REPOSITORY-NAME -n NAMESPACE -o yaml を実行してエラーの詳細を取得します。

ここで、

REPOSITORY-NAME はパッケージリポジトリの名前です。
NAMESPACE は、パッケージリポジトリのターゲット名前空間です。

tanzu package repository コマンドが失敗し、次のようなエラーが表示されることがあります。

エラー	説明	解決方法
`NOT_FOUND`	リポジトリの URL パスが無効です。	パッケージリポジトリの URL にクラスタからアクセスできることを確認します。
`UNKNOWN` または `UNAUTHORIZED`	このエラーは、リポジトリに接続しようとすると発生する可能性があります。
`Ownership`	同じパッケージリポジトリ URL を持つリポジトリがすでにクラスタにインストールされています。	次のいずれかの処理を行います。 `tanzu package available list -n NAMESPACE` を実行して、インストールするパッケージがすでにインストールのために利用可能であるかどうかを確認します。現在失敗したリポジトリの追加を元に戻すには、`tanzu package repository delete REPOSITORY-NAME -n NAMESPACE` を実行します。 `tanzu package repository list -A` を実行して、同じ URL を持つ既存のパッケージリポジトリを取得します。パッケージリポジトリを取得した場合は、自己責任で削除を続行できます。

`tanzu package installed` の実行中にエラーが発生しました

問題

tanzu package installed コマンドがエラーで失敗する。

解決方法

kubectl get pkgi INSTALLED-PACKAGE-NAME -n NAMESPACE -o yaml を実行してエラーの詳細を取得します。

ここで、

INSTALLED-PACKAGE-NAME はインストール済みパッケージの名前です。
NAMESPACE は、インストール済みパッケージの名前空間です。

tanzu package installed コマンドが失敗し、次のようなエラーが表示されることがあります。

エラー	説明	解決方法
`Ownership`	同じ名前のパッケージがすでにクラスタにインストールされています。	`tanzu package installed list -A` を実行して、インストールするパッケージがすでにインストールされているかどうかを確認します。インストールされている場合は、インストール済みのパッケージを使用するか、そのバージョンを更新するか、パッケージを削除してインストールを続行することができます。
`Evaluating starlark template`	このエラーは、リストされた構成値がない場合に発生する可能性があります。	`tanzu package available get AVAILABLE-PACKAGE-NAME/VERSION -n NAMESPACE –values-schema` を実行して、使用可能なすべての構成値を確認し、必要な構成値を `tanzu package install` コマンドに指定します。
`Failed to find a package with name PACKAGE-NAME in namespace NAMESPACE`	指定したパッケージおよびパッケージメタデータは、ターゲット名前空間で使用できません。	指定したパッケージが、`tanzu package available list AVAILABLE-PACKAGE-NAME -n NAMESPACE` の出力にリストされていることを確認します。リストされていない場合は、パッケージを包含するパッケージリポジトリをターゲット名前空間に追加します。
`Namespace NAMESPACE not found`	パッケージをインストールする名前空間が存在しません。	TKG v2.1 では、`tanzu package` コマンドは `kctrl` をベースとし、`—create-namespace` フラグはサポートされなくなりました。パッケージまたはパッケージリポジトリをインストールする前に、対象の名前空間がすでに存在している必要があります。
`Provided service account SERVICE-ACCOUNT-NAME is already used by another package in namespace NAMESPACE`	`service-account-name` フラグで指定されたサービスアカウントは、すでに別のインストール済みパッケージで使用されています。	パッケージプラグインがサービスアカウントを作成できるようにするか、別のサービスアカウント名を選択します。

ポッド

vCenter Server の接続により、クラスタでポッドが保留中のまま停止する

問題

作成されたクラスタで kubectl get pods -A を実行すると、一部のポッドが保留状態のままになります。

影響を受けるポッドで kubectl describe pod -n pod-namespace pod-name を実行すると、次のイベントが表示されます。

n node(s) had taint {node.cloudprovider.kubernetes.io/uninitialized: true}, that the pod didn't tolerate

解決方法

クラスタと vCenter Server 間の通信を確実に行うために、接続ルールとファイアウォールルールが指定されていることを確認します。ファイアウォールポートとプロトコルの要件については、「VMware Ports and Protocols」の vSphere 8 リストを参照してください。