您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件。 資訊
本主題說明在 Kubernetes 叢集中將 Edge Microgateway 安裝為「服務」之前必須完成的步驟。
這個主題將討論:
- Kubernetes 叢集的最低需求。
- 如何安裝及設定 Edge Microgateway。
- 如何將 Edge Microgateway 的基本設定安裝到您的 Kubernetes 叢集中。
Kubernetes 叢集需求
Kubernetes 叢集要求:
- Kubernetes 1.9 以上版本。
- Kubernetes CLI kubectl v1.9 以上版本。
- 至少有 3 個節點的叢集,每個節點各有 2 個 vCPU。
範例:在 Google Kubernetes Engine (GKE) 上建立 Kubernetes 叢集
設定 Kubernetes 管理機器
Kubernetes 管理機器是 用來對 Kubernetes 叢集執行指令的本機電腦。這部機器通常是可存取 Kubernetes VM 的桌上型電腦。
您必須在 Kubernetes 管理機器上安裝下列公用程式:
在 GKE 中建立 Kubernetes 叢集
- 登入 Google Cloud Platform (GCP) 上的 Google Kubernetes Engine (GKE) 資訊主頁。
- 按一下 [建立叢集]。
- 選取「Standard Cluster」(標準叢集)。
- 輸入叢集的名稱。
- 選取區域。
- 選取「
Cluster Version 1.9.7-gke-*
」。例如1.9.7-gke.6
。 - 選取 3 個節點的大小。
- 請選取 2 個具備 7.5 GB 記憶體的 vCPU。
點選「建立」。
以下螢幕截圖顯示已按照上述步驟所述內容填寫的 GKE 資訊主頁:
取得叢集憑證
設定 GKE 專案名稱:
gcloud config set project projectName
設定 GKE 專案可用區:
gcloud config set compute/zone zoneName
取得您的 gcloud container credentials:
gcloud container clusters get-credentials cluster-name --zone zone --project project-name
其中:
cluster-name
是您建立的 Kubernetes 叢集名稱。zone
是叢集所在的可用區。project-name
是您的 GCP 專案名稱。
例如:
gcloud container clusters get-credentials edgemicrogateway-cluster --zone us-central1-a --project edgemicro-project
完整執行下列指令。這個指令會將叢集管理員權限授予目前使用者。您必須具備管理員權限,才能為 Edge Microgateway 服務建立必要的 RBAC 規則:
kubectl create clusterrolebinding cluster-admin-binding --clusterrole=cluster-admin --user=$(gcloud config get-value core/account)
安裝 Kubernetes 適用的 Edge Microgateway
下載 Kubernetes 適用的 Edge Microgateway。如果使用的是 MacOS 或 Linux 電腦,您可以透過指定版本名稱來下載最新版本或特定版本。
如何取得最新版本:
curl -L https://raw.githubusercontent.com/apigee-internal/microgateway/master/kubernetes/release/downloadEdgeMicrok8s.sh | sh -
依版本號碼取得特定版本。請注意,版本號碼前面必須加上「v」字母。例如「3.0.2 版」
curl -L https://raw.githubusercontent.com/apigee-internal/microgateway/master/kubernetes/release/downloadEdgeMicrok8s.sh | sh -s version
例如:
curl -L https://raw.githubusercontent.com/apigee-internal/microgateway/master/kubernetes/release/downloadEdgeMicrok8s.sh | sh -s v3.0.2
將目錄變更為安裝目錄
microgateway_Version_OS_ARCH
。例如:cd microgateway_2.5.26_Darwin_x86_64
檢查安裝目錄:
/install/kubernetes
- 設定.yaml
檔案以部署至 Kubernetes。/samples
:用於測試安裝的範例應用程式。/bin
-edgemicroctl
執行檔。edgemicroctl
指令會將 Edge Microgateway 植入 Kubernetes 中
將
edgemicroctl
用戶端新增至PATH
。舉例來說,在 MacOS 或 Linux 系統中執行下列指令:export PATH=$PWD/bin:$PATH
將基本 Edge Microgateway 設定套用至 Kubernetes 叢集。下列指令會建立
edgemicro-system
命名空間和叢集角色。kubectl apply -f install/kubernetes/edgemicro.yaml
在叢集內安裝 NGINX Ingress 控制器。確認沒有其他 Nginix 控制器正在執行。您可以執行
kubectl get pods
進行確認。kubectl apply -f install/kubernetes/edgemicro-nginx-gke.yaml
驗證安裝
如要檢查 Ingress 控制器是否已啟動,請執行下列指令:
kubectl get pods --all-namespaces -l app=edgemicro-ingress --watch
如下列範例輸出所示,處理程序會在一到兩分鐘內開始。在
STATUS
變更為Running
之前,通常會看到數個錯誤和重新啟動週期。NAMESPACE NAME READY STATUS RESTARTS AGE edgemicro-system edgemicro-ingress-controller-64444469bf-wjhrn 0/1 CrashLoopBackOff 1 33s edgemicro-system edgemicro-ingress-controller-64444469bf-wjhrn 0/1 Error 2 33s edgemicro-system edgemicro-ingress-controller-64444469bf-wjhrn 0/1 CrashLoopBackOff 2 40s edgemicro-system edgemicro-ingress-controller-64444469bf-wjhrn 0/1 Running 3 1m edgemicro-system edgemicro-ingress-controller-64444469bf-wjhrn 1/1 Running 3 1m
Ingress 執行後,您可以輸入
Ctrl+C
來取消上述指令。執行這個指令,檢查是否已部署 Kubernetes 服務。畫面會顯示類似以下輸出內容的範例輸出內容:
kubectl get svc -n edgemicro-system
輸出內容範例:
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE default-http-backend ClusterIP 10.19.255.106 <none> 80/TCP 2h edgemicro-ingress LoadBalancer 10.19.247.156 35.224.24.13 80:30176/TCP,443:32325/TCP 2h
確認所有 Pod 都在運作中:
kubectl get pods -n edgemicro-system
輸出內容範例:
NAME READY STATUS RESTARTS AGE default-http-backend-55c6c69b88-2lvtw 1/1 Running 0 4m edgemicro-ingress-controller-64444469bf-wjhrn 1/1 Running 3 4m
安裝 Edge Microgateway
您必須安裝 Edge Microgateway 2.5.26 以上版本。您可以輸入下列字詞進行確認:
edgemicro --version
如果您尚未安裝 Edge Microgateway 2.5.26 以上版本,請執行安裝指令碼:
npm install edgemicro -g
如果您是首次安裝或升級 Edge Microgateway,請執行下列指令:
edgemicro init
如需其他協助,請參閱「安裝 Edge Microgateway」一文。
後續步驟
您現在可以將 Edge Microgateway 部署至 Kubernetes。