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

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

GKE

以下では、シェル環境を設定し、Google Cloud Platform プロジェクトで 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 ハイブリッド クラスタのクラスタ要件を収集します。クラスタの最小構成は次のとおりです。
    構成 ステートフル ノードプール ステートレス ノードプール
    ノード数 3（リージョンごと） 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 ハイブリッド クラスタのクラスタ要件を収集します。
    • クラスタの最小構成は次のとおりです。
      構成 ステートフル ノードプール ステートレス ノードプール
      ノード数 3（リージョンごと） 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 on bare metal

要件と前提条件

Anthos clusters on bare metal を使用すると、自分のマシンリソース上で Kubernetes クラスタを直接実行できます。

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

クラスタの作成

  1. Apigee ハイブリッド クラスタのクラスタ要件を収集します。
    • クラスタの最小構成は次のとおりです。
      構成 ステートフル ノードプール ステートレス ノードプール
      ノード数 3（リージョンごと） 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 clusters on bare metal に関するドキュメントの次の手順で、ユーザー クラスタを作成します。

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

AKS

AKS クラスタを作成する

  1. Apigee ハイブリッド クラスタのクラスタ要件を収集します。
    • クラスタの最小構成は次のとおりです。
      構成 ステートフル ノードプール ステートレス ノードプール
      ノード数 3（リージョンごと） 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 ハイブリッド クラスタのクラスタ要件を収集します。
    • クラスタの最小構成は次のとおりです。
      構成 ステートフル ノードプール ステートレス ノードプール
      ノード数 3（リージョンごと） 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 ハイブリッド クラスタのクラスタ要件を収集します。
    • クラスタの最小構成は次のとおりです。
      構成 ステートフル ノードプール ステートレス ノードプール
      ノード数 3（リージョンごと） 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 ハイブリッド クラスタのクラスタ要件を収集します。
    • クラスタの最小構成は次のとおりです。
      構成 ステートフル ノードプール ステートレス ノードプール
      ノード数 3（リージョンごと） 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 のスタートガイドをご覧ください。

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

 

次のステップ

1 （次）ステップ 2: cert-manager をインストールする 3 4 5 6 7 8 9 10