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

ここに表示されているのは、Apigee ハイブリッドに関するドキュメントのバージョン 1.10 です。 詳細については、サポート対象バージョンをご覧ください。

Version 1.10 

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

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

このステップでは、Apigee ハイブリッドを実行するクラスタの作成方法について説明します。ハイブリッドを実行するプラットフォームによって、その手順は異なります。始める前に、次の情報を確認してください。

• クラスタの最小構成
• 専用ノードプールの構成
• 本番環境用の Cassandra の構成
• Cassandra の認証の構成
• StorageClass の構成
• セキュアポートの使用

注: Apigee ハイブリッド用に新しい専用クラスタを作成することも、他のワークロードを実行しているクラスタに Apigee ハイブリッドをインストールすることもできます。Apigee ハイブリッド用の専用クラスタを作成すると、分離が強化されるほか、そのクラスタと Apigee ハイブリッド ワークロードのメンテナンスに必要な作業全体が簡略化されます。

他のワークロードを実行しているクラスタに Apigee ハイブリッドをインストールする場合は、クラスタのアップグレードを行う必要があり、また、Apigee ハイブリッドと他のワークロードで共通して必要となるバージョンと機能を維持する必要があります。サポートされているバージョンと要件の間に矛盾が生じた場合に備えて、1 つ以上のワークロードの移行計画を立てることをおすすめします。

インストール手順の残りの部分では、専用クラスタへのインストールを想定しています。

クラスタを作成する

お使いのプラットフォームの手順を実施してください。

GKE

GKE でクラスタを作成する

この手順では、Google Cloud プロジェクトで GKE クラスタを構成して作成する方法について説明します。

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

ゾーンクラスタではなく、リージョン クラスタを作成することをおすすめします。リージョンとゾーンの違いについてよく理解していない場合は、リージョンとゾーンをご覧ください。使用可能なリージョンについては、使用可能なリージョンとゾーンをご覧ください。たとえば、us-west1 は有効なリージョン名で、us-west1-a はリージョン内のゾーンです。

1. ハイブリッド バージョン 1.10.5 でサポートされている GKE のバージョンを使用していることを確認します。Apigee ハイブリッドでサポートされているプラットフォームとバージョンをご覧ください。
2. 前提条件で説明されているように、すべてのノードとアプリケーション サーバーのクロックがネットワーク タイム プロトコル（NTP）と同期していることを確認します。Cassandra データベースは、ネットワーク タイム プロトコル（NTP）との同期によってデータの整合性を維持します。ハイブリッドを複数のリージョンにインストールする場合は、すべてのリージョンで NTP と同期するようにします。
3. （GKE 限定公開クラスタのみ）限定公開クラスタを作成する場合は、ファイアウォール ルールを追加して、GKE マスターノードと GKE ワーカーノード間の通信にポート 9443 を許可し、GKE マスターが Apigee の変更用 Webhook にアクセスできるようにします。Google Kubernetes Engine のドキュメントの特定のユースケースに対するファイアウォール ルールの追加の手順に沿って操作してください。詳細については、GKE の限定公開クラスタをご覧ください。

   標準クラスタまたは一般公開クラスタを作成する場合は、このルールを追加する必要はありません。

4. マルチゾーンのノードプールを持つリージョン クラスタを作成するの手順に沿って、標準クラスタを作成します。デフォルトのノードプールだけを使用してクラスタを作成しても問題ありません。次のステップで、必要な Apigee ハイブリッド ノードプールを構成して作成します。
   重要: Autopilot クラスタではなく、標準クラスタを作成してください。Autopilot クラスタはカスタム ノードプールをサポートしていないため、Apigee ハイブリッドは Autopilot クラスタをサポートしていません。Google Cloud コンソール UI を使用している場合は、[Standard クラスタに切り替え] を選択してください。
   ヒント: デフォルト ネットワークでクラスタを作成していない場合は、既存のサブネットにクラスタを作成する手順を実施してください。

   クラスタの作成が正常に完了した場合にのみ、次のステップに進みます。

5. ノードプールの追加と管理の手順に沿って、2 つのノードプールを作成します。次の表に示す最小要件でノードプールを構成してください。

   ノードプールについて知っておくべきこと

   注: ノードプールには apigee-data と apigee-runtime という名前を使用することをおすすめします。Apigee ハイブリッドはデフォルトでこれらの名前を認識します。デフォルト名を使用しない場合は、後で Apigee ハイブリッド用のクラスタを構成するときに追加の構成作業が必要になります。クラスタ構成ファイルを編集してデフォルトのノードプール名を変更する手順などについては、デフォルトの nodeSelector の使用をご覧ください。

   続行する前に、ノードプールとノードプールの構成に関する次の情報を確認することをおすすめします。

   • ノードプールについて
   • Cassandra ネットワークの要件

   ノードプールの最小要件

   ノードプールを作成する場合は、これらの最小要件を満たしていることを確認してください。Cloud コンソールを使用する場合は、ノードプールの詳細とノードの両方のセクションを構成してください。

   注: 次の表に示すノードプールの構成値は最小値を表しており、テストに適しています。ただし、必要に応じて、現時点で、または将来にノードのサイズを増やすことができます。クラスタノードの管理については、ノードプールの追加と管理をご覧ください。

   ノードプール名	説明	最小ノード数	最小 マシンタイプ
   apigee-data	Cassandra データベース用のステートフル ノードプール。	ゾーンあたり 1 （リージョンあたり 3）	e2-standard-4 （4 vCPU、16 GB メモリ）
   apigee-runtime	ランタイムの Message Processor 用のステートレス ノードプール。	ゾーンあたり 1 （リージョンあたり 3）	e2-standard-4 （4 vCPU、16 GB メモリ）

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

6. （省略可）必要に応じて、default ノードプールを削除できます。ノードプールを削除するをご覧ください。
7. 次の環境変数を作成します。これらの変数は、後続の gcloud コマンドで使用されます。

   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
   set PROJECT_ID=YOUR_PROJECT_ID

   ここで

   • CLUSTER_NAME: クラスタの名前。
   • CLUSTER_LOCATION: クラスタを作成したリージョン。
8. ノードプールの構成を確認します。

   リージョン クラスタ

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

   ゾーンクラスタ

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

9. クラスタの情報を取得して、kubectl のデフォルト クラスタとして設定していることを確認します。
   作成したクラスタの 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}

   kubectl コマンドのデフォルト クラスタを設定するをご覧ください。

10. Cassandra 用の永続ソリッド ステート ディスク（SSD）ストレージを構成します。ローカル SSD の使用はサポートされていません。詳細については、Kubernetes ドキュメントのデフォルトのストレージ クラスを変更するをご覧ください。

    1. 現在のデフォルトの StorageClass の名前を取得します。

       kubectl get sc

       次に例を示します。

       kubectl get sc
         NAME                    PROVISIONER             RECLAIMPOLICY   VOLUMEBINDINGMODE      ALLOWVOLUMEEXPANSION   AGE
         premium-rwo             pd.csi.storage.gke.io   Delete          WaitForFirstConsumer   true                   15h
         standard                kubernetes.io/gce-pd    Delete          Immediate              true                   15h
         standard-rwo (default)  pd.csi.storage.gke.io   Delete          WaitForFirstConsumer   true                   15h

    2. standard-rwo という StorageClass の詳細を確認します。タイプが pd-balanced であることにご注意ください。

       kubectl describe sc standard-rwo

       次に例を示します。

       kubectl describe sc standard-rwo

       Name:                  standard-rwo
         IsDefaultClass:        Yes
         Annotations:           components.gke.io/layer=addon,storageclass.kubernetes.io/is-default-class=false
         Provisioner:           pd.csi.storage.gke.io
         Parameters:            type=pd-balanced
         AllowVolumeExpansion:  True
         MountOptions:          <none>
         ReclaimPolicy:         Delete
         VolumeBindingMode:     WaitForFirstConsumer
         Events:                <none>

    3. storageclass.yaml という名前の新しいファイルを作成します。
    4. 次のコードをファイルに追加します。ここでは新しいクラスの名前を apigee-sc にしていますが、クラスには任意の名前を付けることができます。また、ストレージ タイプを pd-ssd にしています。

       ---
       kind: StorageClass
       apiVersion: storage.k8s.io/v1
       metadata:
         name: "apigee-sc"
       provisioner: kubernetes.io/gce-pd
       parameters:
         type: pd-ssd
         replication-type: none
       volumeBindingMode: WaitForFirstConsumer
       allowVolumeExpansion: true

    5. 新しい StorageClass を Kubernetes クラスタに適用します。

       kubectl apply -f storageclass.yaml

    6. 次の 2 つのコマンドを実行して、デフォルトの StorageClass を変更します。

       kubectl patch storageclass standard-rwo \
       -p '{"metadata": {"annotations":{"storageclass.kubernetes.io/is-default-class":"false"}}}'

       kubectl patch storageclass apigee-sc \
       -p '{"metadata": {"annotations":{"storageclass.kubernetes.io/is-default-class":"true"}}}'

    7. 次のコマンドを実行して、新しいデフォルトの StorageClass が apigee-sc であることを確認します。

       kubectl get sc

       次に例を示します。

       kubectl get sc
         NAME                  PROVISIONER             RECLAIMPOLICY   VOLUMEBINDINGMODE      ALLOWVOLUMEEXPANSION   AGE
         apigee-sc (default)   kubernetes.io/gce-pd    Delete          WaitForFirstConsumer   true                   14h
         premium-rwo           pd.csi.storage.gke.io   Delete          WaitForFirstConsumer   true                   15h
         standard              kubernetes.io/gce-pd    Delete          Immediate              true                   15h
         standard-rwo          pd.csi.storage.gke.io   Delete          WaitForFirstConsumer   true                   15h

11. クラスタで Workload Identity を有効にします。Workload Identity を使用すると、GKE クラスタ内のワークロードが Identity and Access Management（IAM）サービス アカウントの権限を借用して Google Cloud サービスにアクセスできます。この処理には最長で 30 分ほどかかります。

    リージョン クラスタ

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

    ゾーンクラスタ

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

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

12. 次のコマンドを使用して、Workload Identity が正常に有効になっていることを確認します。

    リージョン クラスタ

    gcloud container clusters describe ${CLUSTER_NAME} \
      --project ${PROJECT_ID} \
      --region ${CLUSTER_LOCATION} | grep -i "workload"

    ゾーンクラスタ

    gcloud container clusters describe ${CLUSTER_NAME} \
      --zone ${CLUSTER_LOCATION} \
      --project ${PROJECT_ID} | grep -i "workload"

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

GKE On-Prem

GKE On-Prem でクラスタを作成する

この手順では、Apigee ハイブリッド用に GKE On-Prem クラスタを構成して作成する方法について説明します。

1. ハイブリッド バージョン 1.10.5 でサポートされている Anthos オンプレミス VMWare のバージョンを使用していることを確認します。Apigee ハイブリッドでサポートされているプラットフォームとバージョンをご覧ください。
2. 前提条件で説明されているように、すべてのノードとアプリケーション サーバーのクロックがネットワーク タイム プロトコル（NTP）と同期していることを確認します。Cassandra データベースは、ネットワーク タイム プロトコル（NTP）との同期によってデータの整合性を維持します。ハイブリッドを複数のリージョンにインストールする計画の場合は、すべてのリージョンにわたり NTP と同期するようにします。
3. 基本クラスタを作成するの手順に沿ってクラスタを作成します。デフォルトのノードプールだけを使用してクラスタを作成しても問題ありません。次のステップで、必要な Apigee ハイブリッド ノードプールを構成して作成します。

   クラスタの作成が正常に完了した場合にのみ、次のステップに進みます。

4. ノードプールの作成と管理の手順に沿って、2 つのノードプールを作成します。次の表に示す最小要件でノードプールを構成します。

   ノードプールについて知っておくべきこと

   注: ノードプールには apigee-data と apigee-runtime という名前を使用することをおすすめします。Apigee ハイブリッドはデフォルトでこれらの名前を認識します。デフォルト名を使用しないと、後で Apigee ハイブリッド用のクラスタを構成するときに追加の構成作業が必要になります。クラスタ構成ファイルを編集してデフォルトのノードプール名を変更する手順などについては、デフォルトの nodeSelector の使用をご覧ください。

   続行する前に、ノードプールとノードプールの構成に関する次の情報を確認することをおすすめします。

   • ノードプールについて
   • Cassandra ネットワークの要件

   ノードプールの最小要件

   ノードプールを作成する場合は、これらの最小要件を満たしていることを確認してください。

   注: 次の表に示すノードプールの構成値は最小値を表しており、テストに適しています。ただし、必要に応じて、現在または将来にノードのサイズを増やすことができます。クラスタノードの管理については、ノードプールの追加と管理をご覧ください。

   ノードプール名	説明	最小ノード数	最小 マシンタイプ
   apigee-data	Cassandra データベース用のステートフル ノードプール。	ゾーンあたり 1 （リージョンあたり 3）	e2-standard-4 （4 vCPU、16 GB メモリ）
   apigee-runtime	ランタイムの Message Processor 用のステートレス ノードプール。	ゾーンあたり 1 （リージョンあたり 3）	e2-standard-4 （4 vCPU、16 GB メモリ）

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

5. （省略可）必要に応じて、default ノードプールを削除できます。ノードプールを削除するをご覧ください。

6. Cassandra 用の永続ソリッド ステート ディスク（SSD）ストレージを構成します。ローカル SSD の使用はサポートされていません。詳細については、Kubernetes ドキュメントのデフォルトのストレージ クラスを変更するをご覧ください。

   1. 現在のデフォルトの StorageClass の名前を取得します。

      kubectl get sc

      次に例を示します。

      kubectl get sc
        NAME                    PROVISIONER             RECLAIMPOLICY   VOLUMEBINDINGMODE      ALLOWVOLUMEEXPANSION   AGE
        premium-rwo             pd.csi.storage.gke.io   Delete          WaitForFirstConsumer   true                   15h
        standard                kubernetes.io/gce-pd    Delete          Immediate              true                   15h
        standard-rwo (default)  pd.csi.storage.gke.io   Delete          WaitForFirstConsumer   true                   15h

   2. standard-rwo という StorageClass の詳細を確認します。タイプが pd-balanced であることにご注意ください。

      kubectl describe sc standard-rwo

      次に例を示します。

      kubectl describe sc standard-rwo

      Name:                  standard-rwo
      IsDefaultClass:        Yes
      Annotations:           components.gke.io/layer=addon,storageclass.kubernetes.io/is-default-class=false
      Provisioner:           pd.csi.storage.gke.io
      Parameters:            type=pd-balanced
      AllowVolumeExpansion:  True
      MountOptions:          <none>
      ReclaimPolicy:         Delete
      VolumeBindingMode:     WaitForFirstConsumer
      Events:                <none>

   3. storageclass.yaml という名前の新しいファイルを作成します。
   4. 次のコードをファイルに追加します。ここでは新しいクラスの名前を apigee-sc にしていますが、クラスには任意の名前を付けることができます。また、ストレージ タイプを pd-ssd にしています。

      ---
      kind: StorageClass
      apiVersion: storage.k8s.io/v1
      metadata:
        name: "apigee-sc"
      provisioner: kubernetes.io/gce-pd
      parameters:
        type: pd-ssd
        replication-type: none
      volumeBindingMode: WaitForFirstConsumer
      allowVolumeExpansion: true

   5. 新しい StorageClass を Kubernetes クラスタに適用します。

      kubectl apply -f storageclass.yaml

   6. 次の 2 つのコマンドを実行して、デフォルトの StorageClass を変更します。

      kubectl patch storageclass standard-rwo \
        -p '{"metadata": {"annotations":{"storageclass.kubernetes.io/is-default-class":"false"}}}'

      kubectl patch storageclass apigee-sc \
        -p '{"metadata": {"annotations":{"storageclass.kubernetes.io/is-default-class":"true"}}}'

   7. 次のコマンドを実行して、新しいデフォルトの StorageClass が apigee-sc であることを確認します。

      kubectl get sc

      次に例を示します。

      kubectl get sc
        NAME                  PROVISIONER             RECLAIMPOLICY   VOLUMEBINDINGMODE      ALLOWVOLUMEEXPANSION   AGE
        apigee-sc (default)   kubernetes.io/gce-pd    Delete          WaitForFirstConsumer   true                   14h
        premium-rwo           pd.csi.storage.gke.io   Delete          WaitForFirstConsumer   true                   15h
        standard              kubernetes.io/gce-pd    Delete          Immediate              true                   15h
        standard-rwo          pd.csi.storage.gke.io   Delete          WaitForFirstConsumer   true                   15h

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

Anthos on bare metal

Anthos on bare metal でクラスタを作成する

Anthos on bare metal で Apigee ハイブリッド用にクラスタを構成して作成する方法について説明します。Anthos on bare metal を使用すると、自分のマシンリソース上で Kubernetes クラスタを直接実行できます。

1. ハイブリッド バージョン 1.10.5 でサポートされている Anthos on bare metal のバージョンを使用していることを確認します。Apigee ハイブリッドでサポートされているプラットフォームとバージョンをご覧ください。
2. 前提条件で説明されているように、すべてのノードとアプリケーション サーバーのクロックがネットワーク タイム プロトコル（NTP）と同期していることを確認します。Cassandra データベースは、ネットワーク タイム プロトコル（NTP）との同期によってデータの整合性を維持します。ハイブリッドを複数のリージョンにインストールする計画の場合は、すべてのリージョンにわたり NTP と同期するようにします。
3. インストールの前提条件の概要とクラスタの作成: 概要を確認します。
4. 次の 2 つのノードプールが構成されているクラスタを作成します。
   • Anthos clusters on bare metal クラスタ クイックスタートの手順に沿ってクラスタを作成します。
   • 少なくとも 2 つのノードプールを作成します。次の表に示す最小要件でノードプールを構成します。

     ノードプールについて知っておくべきこと

     注: ノードプールには apigee-data と apigee-runtime という名前を使用することをおすすめします。Apigee ハイブリッドはデフォルトでこれらの名前を認識します。デフォルト名を使用しないと、後で Apigee ハイブリッド用のクラスタを構成するときに追加の構成作業が必要になります。クラスタ構成ファイルを編集してデフォルトのノードプール名を変更する手順などについては、デフォルトの nodeSelector の使用をご覧ください。

     続行する前に、ノードプールとノードプールの構成に関する次の情報を確認することをおすすめします。

     • 専用ノードプールを構成する
     • ノードプールについて
     • Cassandra ネットワークの要件

     クラスタの最小構成は次のとおりです。

     注: 次の表に示すノードプールの構成値は最小値を表しており、テストに適しています。ただし、必要に応じて、現在または将来にノードのサイズを増やすことができます。

     構成	ステートフル ノードプール	ステートレス ノードプール
     目的	Cassandra データベース用のステートフル ノードプール。	ランタイムの Message Processor 用のステートレス ノードプール。
     ラベル名	apigee-data	apigee-runtime
     ノード数	ゾーンあたり 1（リージョンあたり 3）	ゾーンあたり 1（リージョンあたり 3）
     CPU	4	4
     RAM	15	15
     ストレージ	動的	ApigeeDeployment CRD で管理
     最小ディスク IOPS	SAN または直接アタッチされたストレージで 2,000 IOPS。必要な IOPS をサポートできる場合であっても、NFS は推奨されません。	SAN または直接アタッチされたストレージで 2,000 IOPS。必要な IOPS をサポートできる場合であっても、NFS は推奨されません。
     マシン インスタンス タイプごとのネットワーク帯域幅	1 Gbps	1 Gbps

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

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

AKS

AKS でクラスタを作成する

以下の手順では、AKS で Apigee ハイブリッド用にクラスタを構成して作成する方法について説明します。

1. ハイブリッド バージョン 1.10.5 でサポートされている AKS のバージョンを使用していることを確認します。Apigee ハイブリッドでサポートされているプラットフォームとバージョンをご覧ください。
2. 前提条件で説明されているように、すべてのノードとアプリケーション サーバーのクロックがネットワーク タイム プロトコル（NTP）と同期していることを確認します。Cassandra データベースは、ネットワーク タイム プロトコル（NTP）との同期によってデータの整合性を維持します。ハイブリッドを複数のリージョンにインストールする計画の場合は、すべてのリージョンにわたり NTP と同期するようにします。
3. Azure CLI または Azure Portal を使用してクラスタを作成し、以下で説明するように 2 つのノードプールを作成します。

   ノードプールについて知っておくべきこと

   注: ノードプールには apigee-data と apigee-runtime という名前を使用することをおすすめします。Apigee ハイブリッドはデフォルトでこれらの名前を認識します。デフォルト名を使用しないと、後で Apigee ハイブリッド用のクラスタを構成するときに追加の構成作業が必要になります。クラスタ構成ファイルを編集してデフォルトのノードプール名を変更する手順などについては、デフォルトの nodeSelector の使用をご覧ください。

   続行する前に、ノードプールとノードプールの構成に関する次の情報を確認することをおすすめします。

   • 専用ノードプールを構成する
   • ノードプールについて
   • Cassandra ネットワークの要件

   クラスタの最小構成は次のとおりです。

   注: 次の表に示すノードプールの構成値は最小値を表しており、テストに適しています。ただし、必要に応じて、現在または将来ノードのサイズを増やすことができます。クラスタノードの管理については、AKS ノードプールの追加と管理をご覧ください。

   構成	ステートフル ノードプール	ステートレス ノードプール
   目的	Cassandra データベース用のステートフル ノードプール。	ランタイムの Message Processor 用のステートレス ノードプール。
   ラベル名	apigee-data	apigee-runtime
   ノード数	ゾーンあたり 1（リージョンあたり 3）	ゾーンあたり 1（リージョンあたり 3）
   CPU	4	4
   RAM	15	15
   ストレージ	動的	ApigeeDeployment CRD で管理
   最小ディスク IOPS	SAN または直接アタッチされたストレージで 2,000 IOPS。必要な IOPS をサポートできる場合であっても、NFS は推奨されません。	SAN または直接アタッチされたストレージで 2,000 IOPS。必要な IOPS をサポートできる場合であっても、NFS は推奨されません。
   マシン インスタンス タイプごとのネットワーク帯域幅	1 Gbps	1 Gbps

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

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

EKS

EKS でクラスタを作成する

以下の手順では、EKS で Apigee ハイブリッド用にクラスタを構成して作成する方法について説明します。

1. ハイブリッド バージョン 1.10.5 でサポートされている EKS のバージョンを使用していることを確認します。Apigee ハイブリッドでサポートされているプラットフォームとバージョンをご覧ください。
2. 前提条件で説明されているように、すべてのノードとアプリケーション サーバーのクロックがネットワーク タイム プロトコル（NTP）と同期していることを確認します。Cassandra データベースは、ネットワーク タイム プロトコル（NTP）の同期を使用してデータの整合性を維持します。ハイブリッドを複数のリージョンにインストールする場合は、すべてのリージョンで NTP と同期するようにします。
3. Kubernetes バージョン 1.24 以降を使用している場合は、Amazon EBS 用の Kubernetes CSI ドライバがインストールされていることを確認してください。
4. 次の手順でユーザー クラスタを作成し、以下で説明する 2 つのノードプールを作成します。
   • EKS の概要ドキュメント
   • Amazon EKS クラスタの作成

   ノードプールについて知っておくべきこと

   注: ノードプールには apigee-data と apigee-runtime という名前を使用することをおすすめします。Apigee ハイブリッドはデフォルトでこれらの名前を認識します。デフォルト名を使用しないと、後で Apigee ハイブリッド用のクラスタを構成するときに追加の構成作業が必要になります。クラスタ構成ファイルを編集してデフォルトのノードプール名を変更する手順などについては、デフォルトの nodeSelector の使用をご覧ください。

   続行する前に、ノードプールとノードプールの構成に関する次の情報を確認することをおすすめします。

   • 専用ノードプールを構成する
   • ノードプールについて
   • Cassandra ネットワークの要件

   クラスタの最小構成は次のとおりです。

   注: 次の表に示すノードプールの構成値は最小値を表しており、テストに適しています。ただし、必要に応じて、現在または将来にノードのサイズを増やすことができます。クラスタノードの管理については、ノードプールの追加と管理をご覧ください。

   構成	ステートフル ノードプール	ステートレス ノードプール
   目的	Cassandra データベース用のステートフル ノードプール。	ランタイムの Message Processor 用のステートレス ノードプール。
   ラベル名	apigee-data	apigee-runtime
   ノード数	ゾーンあたり 1（リージョンあたり 3）	ゾーンあたり 1（リージョンあたり 3）
   CPU	4	4
   RAM	15	15
   ストレージ	動的	ApigeeDeployment CRD で管理
   最小ディスク IOPS	SAN または直接アタッチされたストレージで 2,000 IOPS。必要な IOPS をサポートできる場合であっても、NFS は推奨されません。	SAN または直接アタッチされたストレージで 2,000 IOPS。必要な IOPS をサポートできる場合であっても、NFS は推奨されません。
   マシン インスタンス タイプごとのネットワーク帯域幅	1 Gbps	1 Gbps

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

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

GKE on AWS

GKE on AWS でクラスタを作成する

以下の手順では、GKE on AWS で Apigee ハイブリッド用にクラスタを構成して作成する方法について説明します。

1. ハイブリッド バージョン 1.10.5 でサポートされている GKE のバージョンを使用していることを確認します。Apigee ハイブリッドでサポートされているプラットフォームとバージョンをご覧ください。
2. 前提条件で説明されているように、すべてのノードとアプリケーション サーバーのクロックがネットワーク タイム プロトコル（NTP）と同期していることを確認します。Cassandra データベースは、ネットワーク タイム プロトコル（NTP）の同期を使用してデータの整合性を維持します。ハイブリッドを複数のリージョンにインストールする場合は、すべてのリージョンで NTP と同期するようにします。
3. 次の手順でユーザー クラスタを作成し、以下で説明する 2 つのノードプールを作成します。
   • GKE on AWS の概要ドキュメント
   • GKE on AWS にアプリケーションをデプロイする

   ノードプールについて知っておくべきこと

   注: ノードプールには apigee-data と apigee-runtime という名前を使用することをおすすめします。Apigee ハイブリッドはデフォルトでこれらの名前を認識します。デフォルト名を使用しないと、後で Apigee ハイブリッド用のクラスタを構成するときに追加の構成作業が必要になります。クラスタ構成ファイルを編集してデフォルトのノードプール名を変更する手順などについては、デフォルトの nodeSelector の使用をご覧ください。

   続行する前に、ノードプールとノードプールの構成に関する次の情報を確認することをおすすめします。

   • 専用ノードプールを構成する
   • ノードプールについて
   • Cassandra ネットワークの要件

   クラスタの最小構成は次のとおりです。

   注: 次の表に示すノードプールの構成値は最小値を表しており、テストに適しています。ただし、必要に応じて、現在または将来にノードのサイズを増やすことができます。クラスタノードの管理については、ノードプールの追加と管理をご覧ください。

   構成	ステートフル ノードプール	ステートレス ノードプール
   目的	Cassandra データベース用のステートフル ノードプール。	ランタイムの Message Processor 用のステートレス ノードプール。
   ラベル名	apigee-data	apigee-runtime
   ノード数	ゾーンあたり 1（リージョンあたり 3）	ゾーンあたり 1（リージョンあたり 3）
   CPU	4	4
   RAM	15	15
   ストレージ	動的	ApigeeDeployment CRD で管理
   最小ディスク IOPS	SAN または直接アタッチされたストレージで 2,000 IOPS。必要な IOPS をサポートできる場合であっても、NFS は推奨されません。	SAN または直接アタッチされたストレージで 2,000 IOPS。必要な IOPS をサポートできる場合であっても、NFS は推奨されません。
   マシン インスタンス タイプごとのネットワーク帯域幅	1 Gbps	1 Gbps

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

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

OpenShift

OpenShift でクラスタを作成する

以下の手順では、OpenShift で Apigee ハイブリッド用にクラスタを構成して作成する方法について説明します。

1. ハイブリッド バージョン 1.10.5 でサポートされている OpenShift のバージョンを使用していることを確認します。Apigee ハイブリッドでサポートされているプラットフォームとバージョンをご覧ください。
2. 前提条件で説明されているように、すべてのノードとアプリケーション サーバーのクロックがネットワーク タイム プロトコル（NTP）と同期していることを確認します。Cassandra データベースは、ネットワーク タイム プロトコル（NTP）の同期を使用してデータの整合性を維持します。ハイブリッドを複数のリージョンにインストールする場合は、すべてのリージョンで NTP と同期するようにします。
3. ランタイム プレーンにデプロイする OpenShift クラスタを構築して、OpenShift ユーザー クラスタに Apigee をインストールし、2 つのノードプールを作成します。
   OpenShift ドキュメント（Google Cloud へのクラスタの迅速なインストールなど）で、Google Cloud での OpenShift クラスタの作成と管理に関する詳細を確認できます。
   Google Cloud VM で OpenShift クラスタを設定する方法については、Google Cloud VM で OpenShift に Apigee ハイブリッドを設定する方法をご覧ください。

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

   ノードプールについて知っておくべきこと

   注: ノードプールには apigee-data と apigee-runtime という名前を使用することをおすすめします。Apigee ハイブリッドはデフォルトでこれらの名前を認識します。デフォルト名を使用しないと、後で Apigee ハイブリッド用のクラスタを構成するときに追加の構成作業が必要になります。クラスタ構成ファイルを編集してデフォルトのノードプール名を変更する手順などについては、デフォルトの nodeSelector の使用をご覧ください。

   続行する前に、ノードプールとノードプールの構成に関する次の情報を確認することをおすすめします。

   • 専用ノードプールを構成する
   • ノードプールについて
   • Cassandra ネットワークの要件

   クラスタの最小構成は次のとおりです。

   注: 次の表に示すノードプールの構成値は最小値を表しており、テストに適しています。ただし、必要に応じて、現在または将来にノードのサイズを増やすことができます。クラスタノードの管理については、ノードプールの追加と管理をご覧ください。

   構成	ステートフル ノードプール	ステートレス ノードプール
   目的	Cassandra データベース用のステートフル ノードプール。	ランタイムの Message Processor 用のステートレス ノードプール。
   ラベル名	apigee-data	apigee-runtime
   ノード数	ゾーンあたり 1（リージョンあたり 3）	ゾーンあたり 1（リージョンあたり 3）
   CPU	4	4
   RAM	15	15
   ストレージ	動的	ApigeeDeployment CRD で管理
   最小ディスク IOPS	SAN または直接アタッチされたストレージで 2,000 IOPS。必要な IOPS をサポートできる場合であっても、NFS は推奨されません。	SAN または直接アタッチされたストレージで 2,000 IOPS。必要な IOPS をサポートできる場合であっても、NFS は推奨されません。
   マシン インスタンス タイプごとのネットワーク帯域幅	1 Gbps	1 Gbps

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

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

 

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