步驟 1：建立 GKE 叢集

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

設定終端機殼

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

  1. 請確認您已在本機殼層中安裝 gcloud 和 kubectl。gcloud 工具是 GCP 的主要指令列介面，而 kubectl 是用於執行 Kubernetes 叢集相關指令的主要指令列介面。

    gcloud -h
kubectl -h
  2. 如果您尚未安裝這些公用程式，請立即安裝：
    1. 安裝 Cloud SDK，其中包含 gcloud 指令列工具。
    2. 安裝 Cloud SDK 後，執行下列指令以安裝 kubectl 指令列工具：
      3. gcloud components install kubectl
  3. 請使用 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-zone 則是 GCP 運算區名稱。例如：compute/region us-central1。如需運算區域和區域的清單，請參閱「 可用地區和區域」。

建立 GKE 叢集

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

執行下列指令建立叢集。指令中指定的機器類型、節點數和其他設定，會建立適合 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 背景資訊已設為您剛才建立的叢集。

  1. 首先，請列出背景資訊，以便判斷哪個是目前的背景資訊。在以下範例中，目前的內容為 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
  2. 如有需要，請將目前的背景設定為您剛建立的叢集 (您要安裝 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 是切換至的內容名稱。

  3. 檢查目前的背景資訊，確認已設為所需叢集。例如：
    kubectl config current-context
 gke_apigee-project_us-west1-a_apigee-cluster

授予叢集憑證

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

  1. 擷取憑證：
    gcloud container clusters get-credentials cluster-name

    其中 cluster-name 是您建立的叢集名稱 (您要安裝 Apigee hybrid 的叢集)。

  2. 設定叢集角色繫結。請按照指示執行這項指令：
    kubectl create clusterrolebinding cluster-admin-binding \
--clusterrole cluster-admin --user $(gcloud config get-value account)

摘要

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

1 (NEXT) 步驟 2：安裝 apigeectl 3 4