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

現在、Apigee ハイブリッド バージョン 1.8 のドキュメントを表示しています。このバージョンのサポートは終了しています。新しいバージョンにアップグレードする必要があります。詳細については、サポートされているバージョンをご覧ください。

Version 1.8 (unsupported)

サポート対象のバージョン:

• v1.13（最新）
• v1.12
• v1.11
• サポート対象バージョンのリスト

サポートされていないバージョン:

• v1.10
• v1.9
• v1.8
• v1.7
• v1.6
• v1.5
• v1.4
• v1.3
• v1.2
• v1.1

アップグレード: Apigee ハイブリッド バージョン 1.8.8 にアップグレードする場合は、Apigee ハイブリッドのアップグレードで手順をご確認ください。新規にインストールを行う場合は、以下で説明する構成を行います。

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

GKE

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

注意: Apigee は、GKE Sandbox や gVisor（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: クラスタを作成するリージョン。
     注: Apigee ではゾーン名ではなくリージョン名の使用が推奨されています。リージョンとは、リソースをホストできる特定の地理的位置のことです。リージョンには複数のゾーンを含めることができます。たとえば、us-west1 リージョンは、us-west1-a、us-west1-b、and us-west1-c の 3 つのゾーンがある米国西海岸のリージョンを指します。使用可能なリージョンについては、使用可能なリージョンとゾーンをご覧ください。たとえば、us-west1 は有効なリージョン名で、us-west1-a はリージョン内のゾーンです。ほとんどのハイブリッド インストールでは、CLUSTER_LOCATION 変数にリージョン名を使用します。
2. Apigee ハイブリッド クラスタのクラスタ要件を収集します。クラスタの最小構成は次のとおりです。

   構成	ステートフル ノードプール	ステートレス ノードプール
   ノード数	3（リージョンごと）	3（リージョンごと）
   CPU	4	4
   RAM	15	15
   デフォルトのラベル名	apigee-data	apigee-runtime
   ストレージ	動的	ApigeeDeployment CRD で管理

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

3. ハイブリッド バージョン 1.8.8 でサポートされている GKE のバージョンを確認します。
   • Apigee ハイブリッド: 対応プラットフォーム
4. 次の手順で、少なくとも 6 つのノードを持つリージョン クラスタを作成します。
   • リージョン クラスタの作成
     ヒント: Google Cloud コンソールを使用してクラスタを作成する場合は、[作成] をクリックしてクラスタを作成する前にノードプールを追加します。
     注: Apigee では、リージョン クラスタの作成をおすすめします。ゾーンクラスタを作成する場合、この後のステップでロケーションを求められる手順で必ずゾーンを使用してください。
     ヒント: デフォルト ネットワークにクラスタを作成していない場合は、既存のサブネットにクラスタを作成するの手順を実施します。
5. 少なくとも 2 つのノードプールをクラスタに作成します。ノードプールの最小要件は次のとおりです。

   デフォルトのノードプール名	説明	最小ノード数	ノードプールあたりの最小 CPU 数	ノードあたりの最小 CPU 数
   apigee-data	ステートフル ノードプール。	3	4	4/プール内のノード数
   apigee-runtime	ステートレス ノードプール。	3	4	4/プール内のノード数

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

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

   ヒント: ノードプールを作成したら、次のコマンドでそれを確認できます。

   gcloud container node-pools list \
     --cluster=${CLUSTER_NAME} \
     --region=${CLUSTER_LOCATION} \
     --project=${PROJECT_ID}

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 を有効にするをご覧ください。

   注: リージョン クラスタではなくゾーンクラスタを作成した場合は、次のコマンドのように --region ではなく --zone 引数を使用します。

   gcloud container clusters update ${CLUSTER_NAME} \
     --workload-pool=${PROJECT_ID}.svc.id.goog \
     --zone ${CLUSTER_LOCATION} \
     --project ${PROJECT_ID}

7. 次のコマンドを使用して、作成したクラスタの gcloud 認証情報を取得します。

   gcloud container clusters get-credentials ${CLUSTER_NAME} \
     --region ${CLUSTER_LOCATION} \
     --project ${PROJECT_ID}

   注: リージョン クラスタではなくゾーンクラスタを作成した場合は、次のコマンドで認証情報を取得します。

   gcloud container clusters get-credentials ${CLUSTER_NAME} \
     --zone ${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 のバージョンを確認します。
   • Apigee ハイブリッド: 対応プラットフォーム
3. 次の手順でユーザー クラスタを作成します。
   • GKE On-Prem のドキュメントのユーザー クラスタを作成します（クイックスタート）。

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

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 のバージョンを確認します。
   • Apigee ハイブリッド: 対応プラットフォーム
3. Anthos clusters on bare metal に関するドキュメントの次の手順で、ユーザー クラスタを作成します。
   • クラスタの作成: 概要
   • Anthos clusters on bare metal に関するドキュメントの 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 のバージョンを確認します。
   • Apigee ハイブリッド: 対応プラットフォーム
3. 次のいずれかの手順でクラスタを作成します。
   • Azure CLI を使用する: クイックスタート: Azure CLI を使用して Azure Kubernetes Service クラスタをデプロイする
   • Azure ポータルを使用する: クイックスタート: Azure ポータルを使用して Azure Kubernetes Service（AKS）クラスタをデプロイする

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 のバージョンを確認します。
   • Apigee ハイブリッド: 対応プラットフォーム
3. 次の手順でユーザー クラスタを作成します。
   • EKS の概要ドキュメント
   • Amazon EKS クラスタの作成

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

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 のバージョンを確認します。
   • Apigee ハイブリッド: 対応プラットフォーム
3. 次の手順でユーザー クラスタを作成します。
   • GKE on AWS の概要ドキュメント
   • Anthos clusters on AWS のインストールに関する概要

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

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 のバージョンを確認します。
   • Apigee ハイブリッド: 対応プラットフォーム
3. ランタイム プレーンにデプロイする OpenShift クラスタを構築し、OpenShift ユーザー クラスタに Apigee をインストールします。
   OpenShift ドキュメント（Google Cloud へのクラスタの迅速なインストールなど）で、Google Cloud での OpenShift クラスタの作成と管理に関する詳細を確認できます。
   Google Cloud VM で OpenShift クラスタを設定する方法については、GCP VM で OpenShift に Apigee ハイブリッドを設定する方法をご覧ください。

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

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

 

次のステップ

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