迁移到 Apigee 入站流量网关

此过程会将现有的 Apigee Hybrid v1.8 安装从使用入站流量的 Anthos Service Mesh 迁移到使用 Apigee 入站流量网关。

Apigee Hybrid 1.8 版中的 Apigee 入站流量网关

从 1.8 版开始，Apigee Hybrid 提供了一种新功能，用于管理 Hybrid 安装的入站流量网关：Apigee 入站流量网关。Anthos Service Mesh 不再是混合安装的前提条件，Apigee 将停止向 Anthos Service Mesh 提供路由配置。升级后，您必须将流量迁移到新的 Apigee 入站流量网关。

迁移的两种场景如下：

多集群或多区域迁移（推荐）：
在切换到新的 Ingress for Apigee 之前，请从要迁移的集群将所有流量转移到其他集群或区域。这样，您就有时间测试新的 Apigee 入站流量网关是否按预期运行。然后，将流量移回升级后的集群。
就地升级（生产环境中不推荐）：
升级期间 Apigee 将使用新的 IP 地址启动新的入站流量网关。然后，您可以测试新的 Apigee 入站流量网关是否按预期工作，然后将流量迁移到新的入站流量。此升级过程中可能会出现停机时间。

安装 Apigee 入站流量网关

如需安装 Apigee 入站流量网关，您需要将 ingressGateways 属性添加到替换文件。
语法
```
ingressGateways:
- name: INGRESS_NAME
  replicaCountMin: REPLICAS_MIN
  replicaCountMax: REPLICAS_MAX
  resources:
    requests:
      cpu: CPU_COUNT_REQ
      memory: MEMORY_REQ
    limits:
      cpu: CPU_COUNT_LIMIT
      memory: MEMORY_LIMIT
  svcAnnotations:  # optional. See Known issue 243599452.
    SVC_ANNOTATIONS_KEY: SVC_ANNOTATIONS_VALUE
  svcLoadBalancerIP: SVC_LOAD_BALANCER_IP # optional
```
示例
```
ingressGateways:
- name: prod1
  replicaCountMin: 2
  replicaCountMax: 100
  resources:
    requests:
      cpu: 1
      memory: 1Gi
    limits:
      cpu: 2
      memory: 2Gi
  svcAnnotations:  # optional. See Known issue 243599452.
    networking.gke.io/load-balancer-type: "Internal"
  svcLoadBalancerIP: 198.252.0.123 
```
- INGRESS_NAME 是入站流量部署的名称。该字段可以是满足以下要求的任何名称：
  - 长度不得超过 17 个字符
  - 只能包含小写字母数字字符、“-”或“.”
  - 以字母数字字符开头
  - 以字母数字字符结尾
  请参阅配置属性参考文档中的 ingressGateways[].name。
- REPLICAS_MIN 和 REPLICAS_MAX 是安装中 Apigee 入站流量网关的最小和最大副本数。如需了解详情和默认设置，请参阅配置属性参考文档中的 ingressGateways[].replicaCountMin 和 ingressGateways[].replicaCountMax。
- CPU_COUNT_REQ 和 MEMORY_REQ 是安装中每个 Apigee 入站流量网关副本的 CPU 和内存请求。
  如果您先前已为 Anthos Service Mesh 入站流量网关设置了这些属性（例如在 overlay.yaml 文件中），则可以在这里进行该设置。
  如需了解详情和默认设置，请参阅配置属性参考文档中的 ingressGateways[].resources.requests.cpu 和 ingressGateways[].resources.requests.memory。
- CPU_COUNT_LIMIT 和 MEMORY_LIMIT：安装中每个 Apigee 入站流量网关副本的 CPU 和内存上限。
  如果您先前已为 Anthos Service Mesh 入站流量网关设置了这些属性（例如在 overlay.yaml 文件中），则可以在这里进行该设置。
  如需了解详情和默认设置，请参阅配置属性参考文档中的 ingressGateways[].resources.limits.cpu 和 ingressGateways[].resources.limits.memory。
- SVC_ANNOTATIONS_KEY SVC_ANNOTATIONS_VALUE（可选）：
  注意：overrides.yaml 中的 ingressGateways[].svcAnnotations 字段未按预期起作用。请参阅已知问题 243599452
  。
  这是一个键值对，用于为默认入站流量服务提供注解。云平台会使用注解来帮助您配置 Hybrid 安装，例如将 loadbalancer 类型设置为内部或外部。例如：
```
ingressGateways:
  svcAnnotations:
    networking.gke.io/load-balancer-type: "Internal"
```
  注解因平台而异。如需了解必需和建议的注解，请参阅平台文档。
  
  注意：如果您要为入站流量部署创建自己的 Kubernetes 服务，则无需设置 Annotations，如公开 Apigee 入站流量网关中所述。
  请参阅配置属性参考文档中的 ingressGateways[].svcAnnotations。
- SVC_LOAD_BALANCER_IP（可选）可让您为负载均衡器分配静态 IP 地址。在支持指定负载均衡器 IP 地址的平台上，系统会使用此 IP 地址创建负载均衡器。在不允许指定负载均衡器 IP 地址的平台上，系统会忽略此属性。
  如果您没有为负载均衡器分配静态 IP 地址，请将此属性从替换文件中排除。
  
  注意：切勿指定与当前 istio-ingressgateway 相同的 IP 地址。当该服务仍在集群上时，这可能会导致问题。
  注意：如果您要为入站流量部署创建自己的 Kubernetes 服务，则无需设置 LoadBalancerIP，如公开 Apigee 入站流量网关中所述。
  请参阅配置属性参考文档中的 ingressGateways[].svcLoadBalancerIP。
使用以下命令应用更改以安装 Apigee 入站流量网关：
```
$APIGEECTL_HOME/apigeectl apply -f overrides/overrides.yaml
```

将流量切换到 Apigee 入站流量网关

如需将流量从 Anthos Service Mesh 迁移到 Apigee 入站流量网关，请按照“升级到 Apigee Hybrid v1.8”主题中的将流量从 Anthos Service Mesh 切换到 Apigee 入站流量网关部分所述步骤操作。