第 1 步：创建集群

此步骤介绍如何设置 shell 环境并创建适合用于测试 Apigee Hybrid 的 Microsoft® Azure Kubernetes 服务 (AKS) 集群。

设置终端 shell

确保在本地 shell 中安装了 Azure CLI (az) 和 kubectl 工具。Azure CLI 工具为 Azure 提供主要命令行界面，kubectl 则为针对 Kubernetes 集群运行命令提供主要命令行界面。

创建资源组

使用 Azure 控制台或通过 Azure CLI 使用以下命令创建资源组：

az group create --name my-hybrid-rg --location eastus

创建虚拟网络

使用未冲突的 CIDR 范围创建虚拟网络。

例如：

az network vnet create \
 --name vnet-name \
 --resource-group my-hybrid-rg \
 --address-prefixes vnet-address-range \
 --subnet-name vnet-subnet-name \
 --subnet-prefix subnet-address-range

az network vnet create \
 --name my-hybrid-rg-vnet \
 --resource-group my-hybrid-rg \
 --address-prefixes 120.38.1.0/14 \
 --subnet-name my-hybrid-rg-vnet-subnet \
 --subnet-prefix 120.38.1.0/16

其中：

1. my-hybrid-rg 是虚拟网络的名称。
2. vnet-address-range 是为此虚拟网络预留的地址块列表（采用 CIDR 表示法）。
3. vnet-subnet-name 是虚拟网络中子网的名称。
4. subnet-address-range 是为此子网预留的地址块列表（采用 CIDR 表示法）。

创建 AKS 集群

在此步骤中，您将创建一个 AKS 集群。

1. 打开 Microsoft® Azure 门户。
2. 点击 Kubernetes 服务。
3. 使用以下最低配置设置创建集群。

   建议的最小存储空间：查看 AKS 磁盘规范，根据您的 IOPs 和费用要求选择存储卷大小。

   您可以在针对生产环境配置 Cassandra 和 StorageClass 配置中查看 Apigee Hybrid 的集群配置指南。

   Tab	属性	值
   基本	订阅	您的订阅名称
   	资源组	您之前创建的资源组
   	区域	您之前指定的地区。例如：(US) East US
   	Kubernetes 集群名称	集群的名称。例如：my-hybrid-aks-cluster
   	Kubernetes 版本	选择 1.16.x 或更高版本
   	DNS 名称前缀	DNS 名称前缀。例如：my-hybrid-aks-cluster-dns
   	节点数	3
   	节点大小	DS3 标准
   扩缩	虚拟节点	已停用
   	虚拟机规模集	已启用
   Authentication	启用 RBAC	是
   	服务主账号	默认
   网络	HTTP 应用路由	否
   	负载均衡器	标准
   	网络配置	Azure CNI
   	虚拟网络	虚拟网络名称。您可以选择先前创建的虚拟网络，也可以点击新建链接来创建一个新的虚拟网络。例如 my-hybrid-rg-vnet
   	集群子网	示例：default (10.240.0.0/16)
   	Kubernetes 服务地址范围	服务地址范围。务必使用非争用地址范围。例如：10.0.0.0/16
   	Kubernetes DNS 服务 IP 地址	例如：10.0.0.10
   	Docker 桥接地址	例如：172.17.0.1/16
   Monitoring	启用容器监控	是
   	日志分析（Analytics）工作区	例如：DefaultWorkspace-66f9d75c-2cd9-47dd-ad0f-c43d888e9cef-EUS
   标记		无

4. 点击检查并创建。
5. 集群创建完成后，请转到下一步。

设置集群凭据

使用以下命令为新创建的集群添加 kubernetes 集群凭据（如果尚未添加）：

az aks get-credentials --resource-group my-hybrid-rg --name my-hybrid-aks-cluster

设置当前上下文

上下文是一组访问参数。每个上下文都包含一个 Kubernetes 集群、一个用户和一个命名空间。当前上下文是 kubectl 当前的默认集群：所有 kubectl 命令都针对该集群运行。

确保将当前上下文设置为您使用下列命令刚创建的集群：

kubectl config current-context
 my-hybrid-aks-cluster-context

如果未按照预期将上下文设置为集群，请执行以下步骤进行更改：

1. 列出所有上下文以确定当前上下文。在以下示例中，将上下文设置为 my-hybrid-aks-ext01：

   kubectl config get-contexts
   CURRENT   NAME                            CLUSTER                                 AUTHINFO
             my-hybrid-aks-cluster    my-hybrid-aks-cluster          clusterUser_my-hybrid-rg2_myhybrid-aks-cluster
   *         my-hybrid-aks-ext01      my-hybrid-aks-ext01            clusterUser_my-hybrid-rg_my-hybrid-aks-ext01
   
   

2. 如有必要，请将当前上下文设置为刚创建的集群（您打算在其中安装 Apigee Hybrid 的集群）。假设在之前的 get-contexts 输出中，如果您创建的集群名称是 my-hybrid-aks-cluster，则将切换到 my-hybrid-aks-cluster 上下文，如下所示：

   kubectl config use-context my-hybrid-aks-cluster

   其中 my-hybrid-aks-cluster 是要切换到的集群上下文的名称。

摘要

现在，您已拥有在 AKS 中运行的 Kubernetes 集群。Shell 环境已设置完毕，您现在可以在本地机器上安装 Apigee Hybrid 运行时软件。