第 1 步：创建 GKE 集群

本部分介绍如何在 Google Cloud Platform (GCP) 项目中设置 Shell 环境并创建 GKE 集群。

设置终端 shell

gcloud 工具提供了 GCP 的主要命令行界面，kubectl 为运行针对 Kubernetes 集群的命令提供了主要命令行界面。

  1. 确保在本地 shell 中安装 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 集群。Shell 环境已设置完毕，您现在可以在本地机器上安装 Apigee Hybrid 运行时平面软件。

下一步

1 （下一步）第 2 步：安装 apigeectl 3 4