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

ここに表示されているのは、Apigee ハイブリッドに関するドキュメントのバージョン 1.7 です。 This version is end of life. You should upgrade to a newer version. 詳細については、サポート対象バージョンをご覧ください。

Version 1.7 (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.7.6 にアップグレードする場合は、Apigee ハイブリッドのアップグレードの手順をご覧ください。 新規にインストールを行う場合は、以下で説明する構成を行います。

始める前に:

以下の説明では、前の手順で環境変数を作成していることを前提としています。次のコマンドで確認します。

echo $PROJECT_ID
echo $CLUSTER_LOCATION
echo $ORG_NAME
echo $ENV_NAME

クリックすると、変数の定義とコマンドが表示されます。

これらの手順では、次の環境変数を使用します。

• PROJECT_ID: Google Cloud プロジェクトの ID。ハイブリッド クイックスタート - ステップ 2: Google Cloud プロジェクトを作成するをご覧ください。

  export PROJECT_ID=your_project_ID

• CLUSTER_LOCATION: クラスタを作成するリージョン。

  export CLUSTER_LOCATION=cluster-region

  注: Apigee ではゾーン名ではなくリージョン名の使用が推奨されています。リージョンとは、リソースをホストできる特定の地理的位置のことです。リージョンには複数のゾーンを含めることができます。たとえば、us-west1 リージョンは、us-west1-a、us-west1-b、and us-west1-c の 3 つのゾーンがある米国西海岸のリージョンを指します。使用可能なリージョンについては、使用可能なリージョンとゾーンをご覧ください。たとえば、us-west1 は有効なリージョン名で、us-west1-a はリージョン内のゾーンです。ほとんどのハイブリッド インストールでは、CLUSTER_LOCATION 変数にリージョン名を使用します。
• ORG_NAME: 組織の名前。Google Cloud プロジェクト ID と一致する必要があります。ハイブリッド クイックスタート - ステップ 4: 組織を作成するをご覧ください。

  export ORG_NAME=your_organization_name

• ENV_NAME: ハイブリッド環境の名前。ハイブリッド クイックスタート - ステップ 6: 環境グループを作成するをご覧ください。

  export ENV_NAME=your_environment_name

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

GKE

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

注意: Apigee は、GKE Sandbox や gVisor（GKE 上のハイブリッド環境用）をサポートしていません。

クラスタの作成

1. Apigee ハイブリッド クラスタのクラスタ要件を収集します。クラスタの最小構成は次のとおりです。

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

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

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

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

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

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

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

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

5. クラスタを作成したら、次のコマンドを使用してクラスタで Workload Identity を有効にします。

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

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

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

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

6. 次のコマンドを使用して、作成したクラスタの 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.7.6 でサポートされている GKE のバージョンを確認します。
   • Apigee ハイブリッド: 対応プラットフォーム
3. 次の手順でユーザー クラスタを作成します。
   • GKE On-Prem のドキュメントのユーザー クラスタを作成します（クイックスタート）。

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

Anthos on bare metal

要件と前提条件

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

次の要件と前提条件を確認してください。

• ハードウェア要件: Anthos clusters on bare metal のハードウェアの構成
• インストールの前提条件の概要

クラスタの作成

1. Apigee ハイブリッド クラスタのクラスタ要件を収集します。
   • クラスタの最小構成は次のとおりです。

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

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

   • 少なくとも 2 つのノードプールを作成します。

     デフォルトのノードプール名	説明
     apigee-data	ステートフル ノードプール。
     apigee-runtime	ステートレス ノードプール。

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

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

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

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

 

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