ステップ 8: クラスタの準備状況を確認する

ハイブリッドクラスタの準備状況を確認する

構成を適用してハイブリッドランタイムをインストールする前に、Kubernetes クラスタで Apigee ハイブリッドインストールの準備ができていることを確認する必要があります。

クラスタの準備状況を確認するには、Kubernetes Job 定義が含まれている YAML ファイルを作成し、kubectl コマンドを使用してそのファイルを適用してクラスタを確認します。その後、kubectl get jobs コマンドを使用して Kubernetes テスト Job のステータスを確認します。

次のコマンドを使用して、kubectl が正しいコンテキストに設定されていることを確認します。現在のコンテキストは、Apigee ハイブリッドをデプロイするクラスタに設定する必要があります。
```
kubectl config current-context
```
結果に、Apigee ハイブリッドをデプロイするクラスタの名前が含まれている必要があります。たとえば、GKE では、コンテキスト名は通常、gke_project-id_cluster-location_cluster-name の形式になります。
```
gke_my-project_us-central1_my-cluster
```
コンテキスト内のクラスタ名が一致しない場合は、次のコマンドを使ってクラスタの gcloud 認証情報を取得し、kubectl コンテキストを設定します。
リージョンクラスタ
```
gcloud container clusters get-credentials $CLUSTER_NAME \
  --region $CLUSTER_LOCATION \
  --project $PROJECT_ID
```
ゾーンクラスタ
```
gcloud container clusters get-credentials $CLUSTER_NAME \
  --zone $CLUSTER_LOCATION \
  --project $PROJECT_ID
```
ハイブリッドファイルディレクトリに、cluster-check ディレクトリを作成します。
```
mkdir $HYBRID_FILES/cluster-check
```

$HYBRID_FILES/cluster-check ディレクトリに、次の内容を含む apigee-k8s-cluster-ready-check.yaml という名前のファイルを作成します。

apiVersion: v1
kind: ServiceAccount
metadata:
  name: apigee-k8s-cluster-ready-check
---
apiVersion: batch/v1
kind: Job
metadata:
  name: apigee-k8s-cluster-ready-check
spec:
  template:
    spec:
      hostNetwork: true
      serviceAccountName: apigee-k8s-cluster-ready-check
      containers:
        - name: manager
          image: gcr.io/apigee-release/hybrid/apigee-operators:1.10.0
          command:
            - /manager
          args:
          - --k8s-cluster-ready-check
          env:
          - name: POD_IP
            valueFrom:
              fieldRef:
                fieldPath: status.podIP
          securityContext:
            runAsGroup: 998
            runAsNonRoot: true
            runAsUser: 999
      restartPolicy: Never
  backoffLimit: 1

次の kubectl コマンドを使用して、apigee-k8s-cluster-ready-check.yaml を適用します。これにより、テストが実行されます。
```
kubectl apply -f $HYBRID_FILES/cluster-check/apigee-k8s-cluster-ready-check.yaml
```
次のコマンドを使用して、Kubernetes Job のステータスを確認します。
```
kubectl get jobs apigee-k8s-cluster-ready-check
```
クラスタの準備が整うと、出力は次のようになります。
```
NAME                            COMPLETIONS   DURATION   AGE
apigee-k8s-cluster-ready-check  1/1           8s         1h23m
```
テストに失敗し、クラスタの準備ができていない場合、出力は次のようになります。
```
NAME                            COMPLETIONS   DURATION   AGE
apigee-k8s-cluster-ready-check  0/1           44s         44s
```
完了の数を確認します。
- 1/1 成功です。クラスタは Apigee ハイブリッドをインストールする準備が整っています。
- 0/1 テストに失敗しました。クラスタの準備ができていません。クラスタのトラブルシューティングを行う手順は次のとおりです。
テストが失敗した場合は、次のコマンドを使用してログを確認します。
1. クラスタの事前チェックジョブの Pod 名を取得します。
```
kubectl get pods | grep apigee-k8s-cluster-ready-check
```
2. Pod の Kubernetes ログを取得します。
```
kubectl logs pod_name
```
  ここで、pod_name は apigee-k8s-cluster-ready-check Pod の名前です。
次のステップに進む前にクリーンアップします。次のコマンドを使用して、Kubernetes Job を削除します。
```
kubectl delete -f $HYBRID_FILES/cluster-check/apigee-k8s-cluster-ready-check.yaml
```

これで、Apigee ハイブリッドクラスタの準備が整いました。次に、ハイブリッドランタイムに構成を適用し、Apigee ハイブリッドのインストールを完了します。

トラブルシューティング

Cassandra DNS チェック: DNS resolution was successful but IP doesn't match POD IP、could not resolve hostname、error determining hostname に類似したエラーログが見つかった場合、クラスタ DNS がマルチリージョン設定用に正しく構成されていないことを意味します。マルチリージョンを設定しない場合は、このエラーを無視できます。
コントロールプレーンの接続チェック: error creating TCP connection with host のようなエラーログが見つかった場合は、クラスタから apigee.googleapis.com への接続を解決し、ジョブを再実行する必要があります。

1 2 3 4 5 6 7 8 （次）ステップ 9: ハイブリッドランタイムをインストールする 10

ステップ 8: クラスタの準備状況を確認する

ハイブリッド クラスタの準備状況を確認する

リージョン クラスタ

ゾーンクラスタ

トラブルシューティング

ハイブリッドクラスタの準備状況を確認する

リージョンクラスタ