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

ここでは、Apigee ハイブリッドを実行するクラスタの設定方法について説明します。この手順は、ハイブリッドを実行するプラットフォームによって異なります。ご使用のプラットフォームを選択して説明をご覧ください。

GKE

このステップでは、シェル環境を設定し、Google Cloud プロジェクトで GKE クラスタを作成する方法について説明します。

クラスタの作成

  1. 次の環境変数を作成します。

    Linux / MacOS

    export CLUSTER_NAME="YOUR_CLUSTER_NAME"
    export CLUSTER_LOCATION="YOUR_CLUSTER_LOCATION"

    Windows

    set CLUSTER_NAME="YOUR_CLUSTER_NAME"
    set CLUSTER_LOCATION=YOUR_CLUSTER_LOCATION

    各要素の意味は次のとおりです。

    • CLUSTER_NAME (必須): 新しいクラスタの名前です。
    • CLUSTER_LOCATION: クラスタを作成するリージョン。
  2. Apigee ハイブリッド クラスタのクラスタ要件を収集します。クラスタの最小構成は次のとおりです。
    構成 ステートフル ノードプール ステートレス ノードプール
    ノード数 1 リージョンあたり 3 1 リージョンあたり 3
    CPU 4 4
    RAM 15 15
    デフォルトのラベル名 apigee-data apigee-runtime
    ストレージ 動的 ApigeeDeployment CRD で管理

    最小クラスタ構成の詳細については、最小クラスタ構成をご覧ください。

  3. ハイブリッド バージョン 1.8.8 でサポートされている GKE のバージョンを確認します。
  4. 次の手順で、少なくとも 6 つのノードを持つリージョン クラスタを作成します。
    • リージョン クラスタの作成
  5. 少なくとも 2 つのノードプールをクラスタに作成します。ノードプールの最小要件は次のとおりです。
    デフォルトのノードプール名 説明 最小ノード数 ノードプールあたりの最小 CPU 数 ノードあたりの最小 CPU 数
    apigee-data ステートフル ノードプール。 3 4 4 / プール内のノード数
    apigee-runtime ステートレス ノードプール。 3 4 4 / プール内のノード数

    ノードプールの追加と管理の手順に沿って操作します。

    ノードプールの構成の詳細については、専用ノードプールの構成をご覧ください。

  6. クラスタを作成したら、クラスタで Workload Identity を有効にします。この操作には最長で 30 分ほどかかることがあります。
    gcloud container clusters update ${CLUSTER_NAME} \
      --workload-pool=${PROJECT_ID}.svc.id.goog \
      --project ${PROJECT_ID} \
      --region ${CLUSTER_LOCATION}

    詳細については、Workload Identity を有効にするをご覧ください。

  7. 次のコマンドを使用して、作成したクラスタの gcloud 認証情報を取得します。
    gcloud container clusters get-credentials ${CLUSTER_NAME} \
      --region ${CLUSTER_LOCATION} \
      --project ${PROJECT_ID}

クラスタをインストールして起動したら、次のステップに進みます。

GKE On-Prem

クラスタの作成

  1. Apigee ハイブリッド クラスタのクラスタ要件を収集します。
    • クラスタの最小構成は次のとおりです。
      構成 ステートフル ノードプール ステートレス ノードプール
      ノード数 1 リージョンあたり 3 1 リージョンあたり 3
      CPU 4 4
      RAM 15 15
      デフォルトのラベル名 apigee-data apigee-runtime
      ストレージ 動的 ApigeeDeployment CRD で管理

      最小クラスタ構成の詳細については、最小クラスタ構成をご覧ください。

    • 少なくとも 2 つのノードプールを作成します。
      デフォルトのノードプール名 説明
      apigee-data ステートフル ノードプール。
      apigee-runtime ステートレス ノードプール。

      ノードプールの構成の詳細については、専用ノードプールの構成をご覧ください。

  2. ハイブリッド バージョン 1.8.8 でサポートされている GKE のバージョンを確認します。
  3. 次の手順でユーザー クラスタを作成する。

クラスタをインストールして起動したら、次のステップに進みます。

ベアメタル版 Anthos

要件と前提条件

ベアメタル版 Anthos クラスタを使用すると、自分のマシンリソース上で Kubernetes クラスタを直接実行できます。

インストールの前提条件の概要を確認します。

クラスタの作成

  1. Apigee ハイブリッド クラスタのクラスタ要件を収集します。
    • クラスタの最小構成は次のとおりです。
      構成 ステートフル ノードプール ステートレス ノードプール
      ノード数 1 リージョンあたり 3 1 リージョンあたり 3
      CPU 4 4
      RAM 15 15
      デフォルトのラベル名 apigee-data apigee-runtime
      ストレージ 動的 ApigeeDeployment CRD で管理

      最小クラスタ構成の詳細については、最小クラスタ構成をご覧ください。

    • 少なくとも 2 つのノードプールを作成します。
      デフォルトのノードプール名 説明
      apigee-data ステートフル ノードプール。
      apigee-runtime ステートレス ノードプール。

      ノードプールの構成の詳細については、専用ノードプールの構成をご覧ください。

  2. ハイブリッド バージョン 1.8.8 でサポートされている GKE のバージョンを確認します。
  3. ベアメタル版 Anthos クラスタに関するドキュメントの次の手順で、ユーザー クラスタを作成します。

クラスタをインストールして起動したら、次のステップに進みます。

AKS

AKS クラスタを作成する

  1. Apigee ハイブリッド クラスタのクラスタ要件を収集します。
    • クラスタの最小構成は次のとおりです。
      構成 ステートフル ノードプール ステートレス ノードプール
      ノード数 1 リージョンあたり 3 1 リージョンあたり 3
      CPU 4 4
      RAM 15 15
      デフォルトのラベル名 apigee-data apigee-runtime
      ストレージ 動的 ApigeeDeployment CRD で管理

      最小クラスタ構成の詳細については、最小クラスタ構成をご覧ください。

    • 少なくとも 2 つのノードプールを作成します。
      デフォルトのノードプール名 説明
      apigee-data ステートフル ノードプール。
      apigee-runtime ステートレス ノードプール。

      ノードプールの構成の詳細については、専用ノードプールの構成をご覧ください。

  2. ハイブリッド バージョン 1.8.8 でサポートされている AKS のバージョンを確認します。
  3. 次のいずれかの手順を使用してクラスタを作成します。

EKS

クラスタの作成

  1. Apigee ハイブリッド クラスタのクラスタ要件を収集します。
    • クラスタの最小構成は次のとおりです。
      構成 ステートフル ノードプール ステートレス ノードプール
      ノード数 1 リージョンあたり 3 1 リージョンあたり 3
      CPU 4 4
      RAM 15 15
      デフォルトのラベル名 apigee-data apigee-runtime
      ストレージ 動的 ApigeeDeployment CRD で管理

      最小クラスタ構成の詳細については、最小クラスタ構成をご覧ください。

    • 少なくとも 2 つのノードプールを作成します。
      デフォルトのノードプール名 説明
      apigee-data ステートフル ノードプール。
      apigee-runtime ステートレス ノードプール。

      ノードプールの構成の詳細については、専用ノードプールの構成をご覧ください。

  2. ハイブリッド バージョン 1.8.8 でサポートされている EKS のバージョンを確認します。
  3. 次の手順でユーザー クラスタを作成します。

クラスタをインストールして実行したら、次のステップに進みます。

GKE on AWS

クラスタの作成

  1. Apigee ハイブリッド クラスタのクラスタ要件を収集します。
    • クラスタの最小構成は次のとおりです。
      構成 ステートフル ノードプール ステートレス ノードプール
      ノード数 1 リージョンあたり 3 1 リージョンあたり 3
      CPU 4 4
      RAM 15 15
      デフォルトのラベル名 apigee-data apigee-runtime
      ストレージ 動的 ApigeeDeployment CRD で管理

      最小クラスタ構成の詳細については、最小クラスタ構成をご覧ください。

    • 少なくとも 2 つのノードプールを作成します。
      デフォルトのノードプール名 説明
      apigee-data ステートフル ノードプール。
      apigee-runtime ステートレス ノードプール。

      ノードプールの構成の詳細については、専用ノードプールの構成をご覧ください。

  2. ハイブリッド バージョン 1.8.8 でサポートされている GKE のバージョンを確認します。
  3. 次の手順でユーザー クラスタを作成します。

クラスタをインストールして起動したら、次のステップに進みます。

OpenShift

クラスタの作成

  1. Apigee ハイブリッド クラスタのクラスタ要件を収集します。
    • クラスタの最小構成は次のとおりです。
      構成 ステートフル ノードプール ステートレス ノードプール
      ノード数 1 リージョンあたり 3 1 リージョンあたり 3
      CPU 4 4
      RAM 15 15
      デフォルトのラベル名 apigee-data apigee-runtime
      ストレージ 動的 ApigeeDeployment CRD で管理

      最小クラスタ構成の詳細については、最小クラスタ構成をご覧ください。

    • 少なくとも 2 つのノードプールを作成します。
      デフォルトのノードプール名 説明
      apigee-data ステートフル ノードプール。
      apigee-runtime ステートレス ノードプール。

      ノードプールの構成の詳細については、専用ノードプールの構成をご覧ください。

  2. ハイブリッド バージョン 1.8.8 でサポートされている OpenShift のバージョンを確認します。
  3. ランタイム プレーンにデプロイする OpenShift クラスタを構築し、OpenShift ユーザー クラスタに Apigee をインストールします。

    OpenShift のインストールの一環として、oc CLI ツールをインストールして構成します。OpenShift ドキュメントの OpenShift CLI のスタートガイドをご覧ください。

クラスタをインストールしたら、次のステップに進みます。