步驟 1:建立 AKS 叢集

這個步驟說明如何設定殼層環境,以及建立適合測試 Apigee Hybrid 的 Microsoft® Azure Kubernetes Service (AKS) 叢集。

設定終端機殼層

請確認您已在本機殼層中安裝 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 磁碟規格,並根據 IOP 和成本需求選擇儲存空間大小。

    Tab 鍵 屬性
    基本 訂閱 訂閱方案名稱
    資源群組 您先前建立的資源群組
    區域 您先前指定的區域。例如:(美國) 美國東部
    Kubernetes 叢集名稱 叢集名稱。例如:my-hybrid-aks-cluster
    Kubernetes 版本 選擇 1.14.x 以上版本
    DNS 名稱前置字串 DNS 名稱前置字串。例如:my-hybrid-aks-cluster-dns
    節點數 3
    節點大小 DS3 Standard
    擴充規模 虛擬節點 已停用
    VM 虛擬機器集 已啟用
    驗證 啟用 RBAC
    服務主體 預設
    網路 HTTP 應用程式路由
    負載平衡器 標準
    網路設定 進階
    虛擬網路 虛擬網路名稱。您可以選取先前建立的虛擬網路,或按一下「建立新網路」連結建立新的虛擬網路。例如:my-hybrid-rg-vnet
    叢集子網路 範例:default (10.240.0.0/16)
    Kubernetes 服務位址範圍 服務位址範圍。請務必使用非競爭位址範圍。 例如:10.0.0.0/16
    Kubernetes DNS 服務 IP 位址 例如:10.0.0.10
    Docker Bridge 位址 例如:172.17.0.1/16
    Monitoring 啟用容器監控功能
    記錄檔分析工作區 例如: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 叢集。您的殼層環境已設定完成,可以開始在本機安裝 Apigee Hybrid 執行階段軟體。

1 (NEXT) Step 2: Install apigeectl 3 4