Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

步驟 1：公開 Apigee 入口閘道

這個步驟說明如何為 Apigee Ingress 閘道設定 Kubernetes 服務。每個 Ingress 部署作業都需要 Kubernetes 服務，才能取得可公開的 IP 位址。用戶端呼叫 Proxy 時，會叫用解析為這個 IP 位址的主機名稱。

Apigee Ingress 閘道的 Kubernetes 服務選項

您可以透過兩種方式提供 Kubernetes 服務，指派 IP 位址 ...

為每個 Apigee Ingress 閘道建立自訂 Kubernetes 服務 (建議)。
使用預設 Kubernetes 服務。

建立自己的 Kubernetes 服務

在正式環境中，Apigee 建議您為每個 Ingress 閘道建立自訂 Kubernetes 服務。

Apigee 會刪除預設服務，但不會在清理時刪除自訂 Kubernetes 服務。因此，重新安裝 Apigee Hybrid 時，系統不會釋出 IP 位址。
如果是 EKS、AKS 和 OpenShift 等非 Google Cloud 平台，您需要自訂 Kubernetes 服務，才能與雲端服務供應商搭配使用。因此，建議您建立自訂 Kubernetes 服務，而非使用預設服務，因為 Apigee 不支援對預設 Kubernetes 服務進行所有自訂作業。

請按照下列步驟設定新的 Ingress 閘道，並將流量導向該閘道。

使用必要的 Pod 選取器標籤 (app、ingress_name 和 org) 建立 Kubernetes 服務。Apigee 進入閘道 Pod 中已有這些標籤。

使用下列範本建立服務檔案：

apiVersion: v1
kind: Service
metadata:
  name: SERVICE_NAME
  namespace: APIGEE_NAMESPACE
spec:
  ports:
  - name: status-port
    port: 15021
    protocol: TCP
    targetPort: 15021
  - name: https
    port: 443
    protocol: TCP
    targetPort: 8443
  selector:
    app: apigee-ingressgateway #required
    ingress_name: INGRESS_NAME
    org: ORG_NAME
  type: LoadBalancer
  loadBalancerIP: LOAD_BALANCER_IP

SERVICE_NAME 是用來識別這項服務的名稱。例如：apigee-prod-1。
注意：如要更輕鬆地識別服務，請使用 Ingress 名稱做為服務名稱的一部分。
INGRESS_NAME 是這個 Apigee 進入閘道的名稱。必須與您在 overrides.yaml 檔案中為 ingressGateways.name 提供的名稱相符。詳情請參閱「ingressGateways」中的「設定屬性參考資料」。
ORG_NAME 是 Apigee 機構的名稱。必須與您在 overrides.yaml 檔案中為 org 提供的名稱相符。詳情請參閱「org」中的「設定屬性參考資料」。
LOAD_BALANCER_IP 是負載平衡器的 IP 位址。
如果您已為負載平衡器預留 IP 位址，請輸入該位址。

如果沒有已保留的 IP 位址，可以使用預設 Apigee Ingress 服務傳回的 IP 位址。使用下列指令傳回的 EXTERNAL-IP：
```
kubectl get svc -n APIGEE_NAMESPACE -l app=apigee-ingressgateway
```
注意：由於 Google Cloud 內部應用程式負載平衡器有限制，這個 Apigee 路由選項不支援 HTTP 1.0 要求。指定 HTTP 1.0 通訊協定的傳入用戶端要求會失敗。支援後續的 HTTP 版本。

Apigee 輸入閘道會公開下列通訊埠：

通訊埠	說明
443	執行階段流量。
15021	健康檢查。`status-port` 會公開 `/healthz/ready` 端點，可用於 GKE Ingress 健康狀態檢查。

套用 SERVICE_FILENAME.yaml 建立服務：
```
kubectl apply -f SERVICE_FILENAME.yaml
```

使用下列指令找出 Apigee Ingress 閘道的外部 IP：

kubectl get svc -n APIGEE_NAMESPACE SERVICE_NAME

輸出內容大致如下：

NAME                                        TYPE           CLUSTER-IP    EXTERNAL-IP     PORT(S)                                      AGE
apigee-ingressgateway-prod-hybrid-37a39bd   LoadBalancer   192.0.2.123   233.252.0.123   15021:32049/TCP,80:31624/TCP,443:30723/TCP   16h

為預設的 Apigee Ingress 閘道服務停用負載平衡器：
1. 在覆寫檔案中，將 ingressGateways[].svcType 屬性更新為 ClusterIP：
```
ingressGateways:
  svcType: ClusterIP
```
2. 升級 apigee-org 圖表以套用變更：
```
helm upgrade ORG_NAME apigee-org/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --atomic \
  -f overrides.yaml
```
詳情請參閱「為預設 Apigee Ingress 閘道服務停用負載平衡器」。
進行健康狀態檢查呼叫，測試 Ingress Gateway。
```
curl -H 'User-Agent: GoogleHC' https://DOMAIN/healthz/ingress -k \
  --resolve "DOMAIN:443:INGRESS_IP_ADDRESS"
```
地點
- DOMAIN 是您在「專案和機構設定 - 步驟 3：建立環境群組」中，為建立的環境群組提供的主機名稱網域。
- INGRESS_IP_ADDRESS 是連入 IP 位址，例如 233.252.0.123。
如果成功，指令會傳回：
```
Apigee Ingress is healthy
```
使用這個 IP 位址更新註冊商或 DNS 供應商的 DNS 記錄 (通常是 A 或 CNAME 記錄)。

使用預設 Kubernetes 服務

如要測試非正式環境或透過 Apigee Ingress 閘道的初始流量，Apigee Hybrid 會為每個 Ingress 部署作業提供預設 Kubernetes 服務。

您可以在 overrides.yaml 檔案中對預設服務進行有限的設定變更。如要瞭解可用的設定選項，請參閱「管理 Apigee Ingress 閘道」。舉例來說，你可以新增註解。

在正式環境中，建議您為 Ingress 提供 Kubernetes 服務。按照「建立自己的 Kubernetes 服務」一文中的步驟操作。

使用下列指令找出預設 Apigee Ingress 服務的外部 IP：

kubectl get svc -n APIGEE_NAMESPACE -l app=apigee-ingressgateway