第 1 步:创建 GKE 集群

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

设置终端 shell

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

  1. 确保在本地 shell 中安装 gcloudkubectlgcloud 工具提供了 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.14.10-gke.27   35.222.54.89  n1-standard-4  1.14.10-gke.27          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