虚拟主机缺少选择器

您正在查看 Apigee 和 Apigee Hybrid 文档。
此主题没有等效的 Apigee Edge 文档。

症状

查看 apigee 命名空间中的资源时，系统会显示 Reason 为 AIS_VIRTUALHOST_MISSING_SELECTOR 的 ApigeeIssue。

错误消息

运行 kubectl -n apigee get apigeeissues 后，系统会显示如下错误： 

NAME                                           SEVERITY   REASON                             DOCUMENTATION                                                                                  AGE
vhost-missing-selector-my-org-my-virtualhost   ERROR      AIS_VIRTUALHOST_MISSING_SELECTOR   https://cloud.google.com/apigee/docs/hybrid/troubleshooting/AIS_VIRTUALHOST_MISSING_SELECTOR   5h18m

原因：虚拟主机缺少入站流量选择器

在 overrides.yaml 中声明的虚拟主机未设置入站流量选择器字段。

诊断

运行以下命令： 

kubectl -n apigee describe apigeeissue ISSUE_NAME

其中，ISSUE_NAME 是问题的名称。例如：vhost-missing-selector-my-org-my-virtualhost。

输出应类似如下所示： 

Name:         vhost-missing-selector-my-org-my-virtualhost
Namespace:    apigee
Labels:       ais-reason=AIS_VIRTUALHOST_MISSING_SELECTOR
Annotations:  <none>
API Version:  apigee.cloud.google.com/v1alpha1
Kind:         ApigeeIssue
Metadata:
  Creation Timestamp:  2023-06-12T17:03:43Z
  Generation:          1
  Owner References:
    API Version:     apigee.cloud.google.com/v1alpha2
    Kind:            ApigeeOrganization
    Name:            my-org
    UID:             7e83a52c-ce00-4bed-98be-55835ada1817
  Resource Version:  3281563
  UID:               adc775c2-376d-4bf9-9860-500b2b2b8273
Spec:
  Details:        Expected ingress selector in ApigeeRouteConfig "my-org-my-virtualhost". Environment Group/virtual host "my-virtualhost" is missing an ingress selector.
  Documentation:  https://cloud.google.com/apigee/docs/hybrid/troubleshooting/AIS_VIRTUALHOST_MISSING_SELECTOR
  Reason:         AIS_VIRTUALHOST_MISSING_SELECTOR
  Severity:       WARNING
Events:           <none>
 
Spec:
  Details:        Expected ingress selector in ApigeeRouteConfig "my-org-my-virtualhost". Environment Group/virtual host "my-virtualhost" is missing an ingress selector.

Spec.Details 的内容说明了缺少入站流量选择器的虚拟主机的名称。

解决方法

  1. 使用 kubectl describe 查看问题的详细信息： 

    kubectl -n apigee describe apigeeissue ISSUE_NAME

    其中，ISSUE_NAME 是问题的名称。例如 vhost-missing-selector-my-org-my-virtualhost。

  2. 通过 Spec.Details 字段确定 virtualhost 名称。

    在此示例中，虚拟主机名为 my-virtualhost。

  3. 在 overrides.yaml 中找到相应的虚拟主机。

    virtualhosts:
...
- name: my-virtualhost
  sslCertPath: ./certs/vhost.pem
  sslKeyPath: ./certs/vhost.key
...

  4. 更新虚拟主机并添加入站流量选择器： 

    virtualhosts:
...
- name: my-virtualhost
  selector:
    app: apigee-ingressgateway
  sslCertPath: ./certs/vhost.pem
  sslKeyPath: ./certs/vhost.key
...

  5. 将更改应用于虚拟主机：

    helm upgrade ENV_GROUP_NAME apigee-virtualhost/ \
  --namespace apigee \
  --set envgroup=ENV_GROUP_NAME \
  -f overrides.yaml

必须收集的诊断信息

如果按照上述说明操作后问题仍然存在，请收集以下诊断信息，然后与 Google Cloud Customer Care 联系：

  1. Google Cloud 项目 ID。
  2. Apigee Hybrid 组织的名称。
  3. ApigeeIssue 的 Spec.Details 字段。