步骤 10：检查集群就绪情况

检查混合集群就绪情况

在应用配置并安装 Hybrid Helm 之前，您应检查 Kubernetes 集群是否已准备好进行 Apigee Hybrid 安装。

如需检查集群的就绪性，您需要创建一个包含 Kubernetes 作业定义的 YAML 文件，并使用 kubectl 命令应用该文件来检查集群。然后，使用 kubectl get jobs 命令检查 Kubernetes 测试作业的状态。

使用以下命令验证 kubectl 是否设置为正确的上下文。当前上下文应设置为您要为其部署 Apigee Hybrid 的集群。
```
kubectl config current-context
```
结果应包含要在其中部署 Apigee Hybrid 的集群的名称。例如，在 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
```
在 helm-charts 目录中，创建一个 cluster-check 目录：
```
mkdir $APIGEE_HELM_CHARTS_HOME/cluster-check
```

在 $APIGEE_HELM_CHARTS_HOME/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.11.1
          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 $APIGEE_HELM_CHARTS_HOME/cluster-check/apigee-k8s-cluster-ready-check.yaml

使用以下命令检查 Kubernetes 作业的状态：
```
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 Hybrid。
- 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 作业：
```
kubectl delete -f $APIGEE_HELM_CHARTS_HOME/cluster-check/apigee-k8s-cluster-ready-check.yaml
```

提示：在某些平台（例如 Anthos on Bare Metal 或 GKE On-Prem）上，您可能会看到 DNS 解析错误。如果 DNS 解析不起作用，请尝试此解决方法。

在每个 Cassandra 工作器节点的 /etc/hosts 文件中添加静态主机条目，如下所示：

echo -e "\\n127.0.1.1 ${HOSTNAME}" >> "/etc/hosts"

或

"\\nWORKER-NODE-IP ${HOSTNAME}" >> "/etc/hosts"

现在，您已确保 Apigee Hybrid 集群已准备就绪。接下来，安装图表以将配置应用于 Hybrid 运行时。

问题排查

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 （下一步）第 11 步：使用 Helm 图表安装 Apigee Hybrid 12

步骤 10：检查集群就绪情况

检查混合集群就绪情况

区域级集群

可用区级集群

问题排查