ステップ 1: クラスタを作成する

このステップではシェル環境を設定し、Apigee ハイブリッドのテストに適した 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 と費用要件に基づいてストレージ ボリューム サイズを選択します。

    Apigee Hybrid のクラスタ構成ガイドラインについては、本番環境用 Cassandra の構成と StorageClass の構成をご覧ください。

    タブ 属性 値
    基本 サブスクリプション サブスクリプション名
    リソース グループ 以前に作成したリソース グループ
    リージョン 以前に指定したリージョン。例: （米国）米国東部
    Kubernetes クラスタ名 クラスタの名前。例: my-hybrid-aks-cluster
    Kubernetes のバージョン バージョン 1.16.x 以降を選択する
    DNS 名の接頭辞 DNS 名の接頭辞。例: my-hybrid-aks-cluster-dns
    ノード数 3
    ノード サイズ DS3 標準
    スケール 仮想ノード 無効
    VM スケールセット 有効
    Authentication RBAC の有効化 ○
    サービス プリンシパル デフォルト
    ネットワーキング HTTP アプリケーション ルーティング ×
    ロードバランサ Standard
    ネットワークの構成 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 Bridge のアドレス 例: 172.17.0.1/16
    モニタリング コンテナのモニタリングを有効にする ○
    Log 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

現在のコンテキストを設定する

コンテキストとは、アクセス パラメータのグループのことです。各コンテキストには 1 つの Kubernetes クラスタ、1 人のユーザー、1 つの名前空間が含まれます。現在のコンテキストとは、現在 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 ハイブリッドをインストールするクラスタ）に現在のコンテキストを設定します。前述の get-contexts の出力で、作成したクラスタの名前が my-hybrid-aks-cluster である場合、次のように my-hybrid-aks-cluster コンテキストに切り替えます。 
    kubectl config use-context my-hybrid-aks-cluster

    ここで my-hybrid-aks-cluster は、切り替え先のクラスタ コンテキストの名前です。

まとめ

これで、Kubernetes クラスタが AKS で実行されます。シェル環境が設定され、ローカルマシンに Apigee ハイブリッド ランタイム ソフトウェアをインストールする準備ができました。

1 （次）ステップ 2: cert-manager と ASM をインストールする 3 4 5