第 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 和费用要求选择存储卷大小。

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

    Tab 属性
    基础配置 订阅 您的订阅名称
    资源组 您之前创建的资源组
    区域 您之前指定的地区。例如:(US) East US
    Kubernetes 集群名称 集群的名称。例如:my-hybrid-aks-cluster
    Kubernetes 版本 选择 1.16.x 或更高版本
    DNS 名称前缀 DNS 名称前缀。例如:my-hybrid-aks-cluster-dns
    节点数 3
    节点大小 DS3 标准
    扩缩 虚拟节点 已停用
    虚拟机规模集 已启用
    身份验证 启用 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