ステップ 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

ここで

my-hybrid-rg は仮想ネットワークの名前です。
vnet-address-range は、CIDR 表記でこの仮想ネットワーク用に予約されたアドレスブロックのリストです。
vnet-subnet-name は、仮想ネットワーク内のサブネットの名前です。
subnet-address-range は、CIDR 表記でこのサブネット用に予約されたアドレスブロックのリストです。

AKS クラスタを作成する

このステップでは、AKS クラスタを作成します。

Microsoft® Azure ポータルを開きます。
[Kubernetes サービス] をクリックします。

次の最小構成設定でクラスタを作成します。

推奨される最小ストレージ: AKS ディスク仕様を確認し、IOP と費用要件に基づいてストレージボリュームサイズを選択します。

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

タブ	属性	値
基本	サブスクリプション	サブスクリプション名
	リソースグループ	以前に作成したリソースグループ
	リージョン	以前に指定したリージョン。例: （米国）米国東部
	Kubernetes クラスタ名	クラスタの名前。例: `my-hybrid-aks-cluster`
	Kubernetes のバージョン	バージョン 1.16.x 以降を選択する
	DNS 名の接頭辞	DNS 名の接頭辞。例: `my-hybrid-aks-cluster-dns`
	ノード数	3
	ノードサイズ	DS3 標準注: 仮想 CPU が 4 個未満の場合、CPU 不足が原因で Cassandra Pod の作成に失敗する可能性があります。ストレージは、Kubernetes ステートフル動的プロビジョナーを使用してプロビジョニングされます
スケール	仮想ノード	無効
	VM スケールセット	有効
Authentication	RBAC の有効化	○
	サービスプリンシパル	デフォルト
ネットワーキング	HTTP アプリケーションルーティング	×
	ロードバランサ	Standard
	ネットワークの構成	Azure CNI 注: ネットワークの設定計画の詳細については、Azure ドキュメントのクラスタの IP アドレス計画をご覧ください。
	仮想ネットワーク	仮想ネットワーク名です。以前に作成した仮想ネットワークを選択するか、[新規作成] リンクをクリックして新しいネットワークを作成します。例: `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`
タグ		なし

[確認して作成] をクリックします。
クラスタの作成が完了したら、次のステップに進みます。

クラスタ認証情報を設定する

新しく作成したクラスタの 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

想定どおりにコンテキストがクラスタに設定されていない場合は、次の手順で変更します。

現在のコンテキストを判別するすべてのコンテキストを一覧表示します。次の例では、コンテキストが 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

必要に応じて、先ほど作成したクラスタ（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