ステップ 3: GKE On-Prem ユーザー クラスタを構成する

構成のオーバーライドを指定する

Apigee ハイブリッド インストーラは、多くの設定でデフォルト値を使用しますが、デフォルト値がない設定もいくつかあります。それらの設定に対しては、次に説明するように値を指定する必要があります。

1. hybrid-base-directory/hybrid-files ディレクトリ内にいることを確認します。
2. overrides-small.yaml ファイルを $APIGEECTL_HOME/examples ディレクトリから overrides ディレクトリにコピーします。

   cp $APIGEECTL_HOME/examples/overrides-small.yaml ./overrides/overrides.yaml

   このサンプル ファイルは、省スペース型のハイブリッド ランタイム インストール用の基本構成を提供します。この構成は最初のインストールに適しています。

3. cd コマンドで overrides ディレクトリに移動します。

cd overrides

4. overrides.yaml を開いて、以下に示す必須のプロパティ値を追加します。各プロパティの詳細な説明は、次のとおりです。

   構文

   overrides.yaml ファイルの構造と構文は次のとおりです。red, bold italics の値は、指定する必要があるプロパティ値です。

   gcpProjectID: project-id
   k8sClusterName: cluster-name
   org: org-name
   
   envs:
     - name: environment-name  # The same name of the env you created in the UI
       hostAlias: test-host-alias
       sslCertPath: ./certs/test-cert-name.pem
       sslKeyPath: ./certs/test-key-name.key
       serviceAccountPaths:
         synchronizer: ./service-accounts/synchronizer-service-account-name.json
         udca: ./service-accounts/udca-service-account-name.json
   
   cassandra:
     hostNetwork: true
     dnsPolicy: ClusterFirstWithHostNet
   
   ingress:
     runtime:
       loadBalancerIP: virtual_IP_runtime
     mart:
       loadBalancerIP: virtual_IP_mart
   
   
   mart:
     hostAlias: mart-host-alias
     serviceAccountPath: ./service-accounts/mart-service-account-name.json
     sslCertPath: ./certs/mart-cert-name.pem
     sslKeyPath: ./certs/mart-key-name.key
   
   metrics:
     serviceAccountPath: ./service-accounts/metrics-service-account-name.json
   
   logger:
     enabled: false

   例

   以下の例は、サンプル プロパティ値の追加が完了したオーバーライド ファイルを示しています。

   gcpProjectID: hybrid-project
   k8sClusterName: apigee-hybrid
   org: hybrid-org
   
   envs:
     - name: test
       hostAlias: "*"
       sslCertPath: ./certs/keystore.pem
       sslKeyPath: ./certs/keystore.key
       serviceAccountPaths:
         synchronizer: ./service-accounts/hybrid-project-apigee-synchronizer.json
         udca: ./service-accounts/hybrid-project-apigee-udca.json
   
   cassandra:
     hostNetwork: true
     dnsPolicy: ClusterFirstWithHostNet
   
   ingress:
     runtime:
       loadBalancerIP: 21.0.124.13
     mart:
       loadBalancerIP: 21.0.124.14
   
   mart:
     hostAlias: "mart.apigee-hybrid-docs.net"
     serviceAccountPath: ./service-accounts/hybrid-project-apigee-mart.json
     sslCertPath: ./certs/fullchain.pem
     sslKeyPath: ./certs/privkey.key
   
   metrics:
         serviceAccountPath: ./service-accounts/hybrid-project-apigee-metrics.json
   
   logger:
     enabled: false

5. 完了したら、ファイルを保存します。

次の表に、オーバーライド ファイルで指定する必要があるプロパティ値を示します。

sslCertPath: ./certs/keystore.pem
sslKeyPath: ./certs/keystore.key

synchronizer: ./service-accounts/hybrid-project-apigee-synchronizer.json

udca: ./service-accounts/hybrid-project-apigee-udca.json

sslCertPath: ./certs/fullchain.pem
sslKeyPath: ./certs/privkey.key

serviceAccountPath: ./service-accounts/hybrid-project-apigee-metrics.json

まとめ

構成ファイルにより、ハイブリッド コンポーネントをクラスタにデプロイする方法が Kubernetes に指示されます。次は、この構成をクラスタに適用します。