ステップ 4: クラスタを構成する

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

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

現在のディレクトリが hybrid-base-directory/hybrid-files/overrides/ ディレクトリであることを確認します。
```
cd hybrid-base-directory/hybrid-files/overrides
```
任意のテキストエディタで、overrides.yaml という名前の新しいファイルを作成します。次に例を示します。
```
vi overrides.yaml
```
overrides.yaml は、独自の Apigee ハイブリッドインストール用の構成を提供します。このステップのオーバーライドファイルは、小規模なフットプリントのハイブリッドランタイムインストールの基本的な構成を提供します。これは、最初のインストールに適しています。

次のように、必須プロパティの値を overrides.yaml に追加します。以下には、各プロパティの詳細な説明も記載されています。

構文

overrides.yaml ファイルが以下の構造と構文になっていることを確認します。red, bold italics の値は、指定する必要があるプロパティ値です。詳しくは次の表をご覧ください。


gcp:
  region: analytics-region
  projectID: gcp-project-id

k8sCluster:
  name: cluster-name
  region: cluster-region # Must be the same region where the cluster is running.

org: org-name

instanceID: "unique-instance-identifier"

cassandra:
  hostNetwork: false #Set this to `true` for GKE-On-prem installations.

virtualhosts:
  - name: environment-group-name
    sslCertPath: ./certs/cert-name.pem
    sslKeyPath: ./certs/key-name.key

envs:
  - name: environment-name
    serviceAccountPaths:
      synchronizer: ./service-accounts/synchronizer-service-account-name.json
      udca: ./service-accounts/udca-service-account-name.json

mart:
  serviceAccountPath: ./service-accounts/mart-service-account-name.json

connectAgent:
  serviceAccountPath: ./service-accounts/mart-service-account-name.json
  # Same account used for mart and connectAgent

metrics:
  serviceAccountPath: ./service-accounts/metrics-service-account-name.json

watcher:
  serviceAccountPath: ./service-accounts/watcher-service-account-name.json

logger:
  enabled: true
  serviceAccountPath: ./service-accounts/logger-service-account-name.json

例

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

gcp:
  region: us-central1
  projectID: hybrid-example

k8sCluster:
  name: apigee-hybrid
  region: us-central1

org: hybrid-example

instanceID: "my_hybrid_example"

cassandra:
  hostNetwork: false #Set this to `true` for GKE-On Prem installations.

virtualhosts:
  - name: example-env-group
    sslCertPath: ./certs/keystore.pem
    sslKeyPath: ./certs/keystore.key

envs:
  - name: test
    serviceAccountPaths:
      synchronizer: ./service-accounts/hybrid-project-apigee-synchronizer.json
      udca: ./service-accounts/hybrid-project-apigee-udca.json

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

connectAgent:
  serviceAccountPath: ./service-accounts/example-hybrid-apigee-mart.json

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

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

logger:
  enabled: true
  serviceAccountPath: ./service-accounts/logger-service-account-name.json

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

次の表に、オーバーライドファイルで指定する必要があるプロパティ値を示します。詳細については、構成プロパティのリファレンスをご覧ください。

変数	説明
`analytics-region`	この値は、クラスタが稼働しているリージョンと同じリージョンに設定する必要があります。これは以前、クラスタの作成中に環境変数 `ANALYTICS_REGION` に割り当てた値です。`apigee-logger` と `apigee-metrics` は、このリージョンにデータを push します。
`gcp-project-id`	`apigee-logger` と `apigee-metrics` がデータを push する Google Cloud プロジェクトを指定します。この値は、環境変数 `PROJECT_ID` に割り当てられます。
`cluster-name`	Kubernetes クラスタ名。この値は、環境変数 `CLUSTER_NAME` に割り当てられます。
`org-name`	Apigee ハイブリッド組織の ID。この値は、環境変数 `ORG_NAME` に割り当てられます。
`unique-instance-identifier`	このインスタンスを識別する一意の文字列。任意の文字と数字の組み合わせで、長さは 63 文字以下にする必要があります。注: 同じクラスタ内に複数の組織を作成できますが、`instanceId` は同じ Kubernetes クラスタ内のすべての組織で同じにする必要があります。マルチリージョンインストールの場合、各リージョンに独自のクラスタが必要です（個々のクラスタはリージョンにまたがりません）。同じクラスタ内に複数の組織を作成できますが、`instanceId` は同じ Kubernetes クラスタ内のすべての組織で同じにする必要があります。
`environment-group-name`	環境が割り当てられている環境グループの名前。これは、プロジェクトと組織の設定 - ステップ 6: 環境グループを作成するで作成したグループです。この値は、環境変数 `ENV_GROUP` に割り当てられます。注: クラスタインスタンスを複数のリージョンに配置する場合は、環境と仮想ホストの定義方法に注意してください。環境グループに 1 つ以上の環境を接続している場合は、同じ環境グループ構成を各クラスタインスタンスのオーバーライドファイルに含める必要があります。
`cert-name` `key-name`	ステップ 3: apigeectl をインストールするで以前に生成した、自己署名 TLS 鍵および証明書ファイルの名前を入力します。これらのファイルは、`base_directory/hybrid-files/certs` ディレクトリに配置する必要があります。例: sslCertPath: ./certs/keystore.pem sslKeyPath: ./certs/keystore.key
`environment-name`	プロジェクトと組織の設定 - ステップ 6: 環境グループを作成するで説明したように、UI で環境を作成したときに使用した名前を使用します。
`synchronizer-service-account-name`	`create-service-account` ツールで生成した `synchronizer` サービスアカウントキーファイルの名前。例: serviceAccountPath: synchronizer: ./service-accounts/hybrid-project-apigee-synchronizer.json
`udca-service-account-name`	`create-service-account` ツールで生成した `udca` サービスアカウントキーファイルの名前。例: serviceAccountPath: udca: ./service-accounts/hybrid-project-apigee-udca.json
`mart-service-account-name`	`create-service-account` ツールで生成した `mart` サービスアカウントキー JSON ファイルの名前。
`metrics-service-account-name`	`create-service-account` ツールで生成した metrics サービスアカウントの JSON ファイルの名前。例: metrics: serviceAccountPath: ./service-accounts/hybrid-project-apigee-metrics.json
`mart-service-account-name`	ステップ 3: apigeectl をインストールするで作成した `mart` サービスアカウント（そのサービスアカウントに割り当てられた Apigee Connect Agent ロールを持つ）の名前。Mart と Apigee Connect Agent は同じサービスアカウントを使用します。
`watcher-service-account-name`	`create-service-account` ツールで生成した `watcher` サービスアカウントの JSON ファイルの名前。例: watcher: serviceAccountPath: ./service-accounts/hybrid-project-apigee-watcher.json

まとめ

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

1 2 3 4 （次）ステップ 5: ハイブリッドランタイムをインストールする