第 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 运行时软件。

1 （下一步）第 2 步：安装 cert-manager 和 ASM 3 4 5