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

このステップでは、シェル環境を設定し、Apigee ハイブリッドのテストに適した Microsoft® Azure Kubernetes Service(AKS)クラスタを作成する方法について説明します。

ターミナル シェルを設定する

ローカルシェルに Azure CLI(az)kubectl がインストールされていることを確認します。Azure CLI ツールは Azure のプライマリ コマンドライン インターフェースを提供します。kubectl は Kubernetes クラスタに対してコマンドを実行するためのプライマリ コマンドライン インターフェースを提供します。

リソース グループを作成する

Azure Console または Azure CLI を使用してリソース グループを作成します。次に例を示します。

az group create --name my-hybrid-rg --location eastus

仮想ネットワークを作成する

CIDR 範囲が競合しない仮想ネットワークを作成します。次に例を示します。

az network vnet create \
 --name my-hybrid-rg-vnet \
 --resource-group my-hybrid-rg \
 --address-prefixes 120.38.1.0/24 \
 --subnet-name my-hybrid-rg-vnet-subnet \
 --subnet-prefix 120.38.1.0/26

AKS クラスタを作成する

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

  1. Microsoft® Azure ポータルを開きます。
  2. [Kubernetes サービス] をクリックします。
  3. 次の最小構成設定でクラスタを作成します。
    タブ 属性
    基本 サブスクリプション サブスクリプション名
    リソース グループ 以前に作成したリソース グループ
    リージョン 以前に指定したリージョン。例: (米国)米国東部
    Kubernetes クラスタ名 クラスタの名前。例: my-hybrid-aks-cluster
    Kubernetes のバージョン バージョン 1.13 以降を選択
    DNS 名の接頭辞 DNS 名の接頭辞。例: my-hybrid-aks-cluster-dns
    ノード数 3
    ノード サイズ DS3 標準
    スケール 仮想ノード 無効
    VM スケールセット 有効
    Authentication RBAC の有効化
    サービス プリンシパル デフォルト
    ネットワーキング HTTP アプリケーション ルーティング ×
    ロードバランサ Standard
    ネットワークの構成 Advanced
    仮想ネットワーク 仮想ネットワーク名です。以前に作成した仮想ネットワークを選択するか、[新規作成] リンクをクリックして新しいネットワークを作成します。例: 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 つの Namespace が含まれます。現在のコンテキストとは、現在 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: apigeectl をインストールする 3 4