本頁面由 Cloud Translation API 翻譯而成。

步驟 1：建立 GKE 叢集

本步驟說明如何設定 Shell 環境，並在 Google Cloud Platform (GCP) 專案中建立 GKE 叢集。

設定終端機殼層

gcloud 工具是 GCP 的主要指令列介面，而 kubectl 是用於執行 Kubernetes 叢集相關指令的主要指令列介面。

請務必在本機殼層中安裝 gcloud 和 kubectl。gcloud 工具是 GCP 的主要指令列介面，而 kubectl 是用於執行 Kubernetes 叢集相關指令的主要指令列介面。
```
gcloud -h
kubectl -h
```
如果尚未安裝這些公用程式，請立即安裝：
1. 安裝 Cloud SDK，其中包含 gcloud 指令列工具。
2. 安裝 Cloud SDK 後，執行下列指令以安裝 kubectl 指令列工具：
使用 gcloud 工具設定兩個預設設定：預設專案和運算區域。設定這些設定之後，您就能更輕鬆地執行 gcloud 指令，因為 gcloud 會要求您指定要在其中工作的專案和運算區域。
如要列出目前的設定：
```
gcloud config list
```
如果未列出專案和/或運算區域，請使用下列指令新增。如果從清單輸出內容判斷需要切換目前的設定，以反映專案和運算區域 (或可用區)，您也可以使用下列指令：
```
gcloud config set project project-id
gcloud config set compute/region compute-region
gcloud config set compute/zone compute-zone
```
其中 project-id 是您的 GCP 專案名稱，compute-region 是 GCP Compute Region 的名稱，compute-zone 則是 GCP Compute Zone 的名稱。例如：compute/region us-central1。如需運算地區和區域的清單，請參閱「可用地區和區域」。

建立 GKE 叢集

在本步驟中，您會在 GCP 專案中建立 Kubernetes 叢集 (您使用 gcloud config 指令設定的專案)。

注意：下列指令假設您已設定運算區域和/或地帶的 gcloud 設定，如先前步驟所述。如果未設定，則需要在指令中加入 --region "compute-region" 和/或 --zone "compute-zone" 參數。

執行下列指令來建立叢集。指令中指定的機器類型、節點數量和其他設定，會建立適合試用 Apigee Hybrid 安裝作業的最低設定叢集：

gcloud container clusters create cluster-name \
--machine-type "n1-standard-4" --num-nodes "3" --enable-autoscaling --min-nodes "3" --max-nodes "6"

其中 cluster-name 是您為叢集選擇的名稱。

建立叢集可能需要幾分鐘的時間。成功後，您會看到類似以下的輸出內容，狀態為 RUNNING：

NAME           LOCATION       MASTER_VERSION  MASTER_IP     MACHINE_TYPE   NODE_VERSION   NUM_NODES  STATUS
apigee-hybrid  us-central1-a  1.13.11-gke.9   35.222.54.89  n1-standard-4  1.13.11-gke.9  3          RUNNING

設定目前的情境

「背景資訊」是一組存取參數。每個背景資訊都包含一個 Kubernetes 叢集、一位使用者和一個命名空間。目前背景資訊是 kubectl 目前的預設叢集；也就是說，系統會針對該叢集執行所有的 kubectl 指令。

確認目前的 gcloud 內容已設為您剛才建立的叢集。

首先，列出所有內容，判斷哪個是目前內容。在以下範例中，目前情境為 gke_hybrid-project_us-central1-a_apigee-hybrid。名稱包含 GCP 專案名稱 (hybrid-project)、區域或地帶 (us-central1-a) 和叢集名稱 (apigee-hybrid)：

kubectl config get-contexts
CURRENT   NAME                                             CLUSTER                                          AUTHINFO                                           NAMESPACE
*         gke_hybrid-project_us-central1-a_apigee-hybrid   gke_hybrid-project_us-central1-a_apigee-hybrid   gke_hybrid-project_us-central1-a_apigee-hybrid
          gke_apigee-project_us-west1-a_apigee-cluster     gke_apigee-project_us-west1-a_apigee-cluster     gke_apigee-project_us-west1-a_apigee-cluster

如有必要，請將目前的環境設為您剛才建立的叢集 (您打算在該叢集中安裝 Apigee Hybrid)。假設先前的 get-contexts 輸出內容為：如果您在 us-west1 區域建立的叢集名稱為 apigee-cluster，請按照下列方式切換至 gke_apigee-project_us-west1-a_apigee-cluster 環境：
```
kubectl config use-context gke_apigee-project_us-west1-a_apigee-cluster
```
其中 gke_apigee-project_us-west1-a_apigee-cluster 是要切換的環境名稱。

檢查目前的環境，確認已設為預期叢集。例如：

kubectl config current-context
 gke_apigee-project_us-west1-a_apigee-cluster

授予叢集憑證

叢集憑證可讓您存取叢集中執行的容器。擷取憑證，並將 cluster-admin 角色授予自己：

擷取憑證：
```
gcloud container clusters get-credentials cluster-name
```
其中 cluster-name 是您建立的叢集名稱 (您打算在該叢集中安裝 Apigee Hybrid)。

設定叢集角色繫結。請完全按照顯示方式執行下列指令：

kubectl create clusterrolebinding cluster-admin-binding \
--clusterrole cluster-admin --user $(gcloud config get-value account)

摘要

現在，您已在 GCP 專案中執行 Kubernetes 叢集。您的殼層環境已設定完成，可以開始在本機安裝 Apigee Hybrid 執行階段平面軟體。

1 (NEXT) Step 2: Install apigeectl 3 4