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

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

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

現在のディレクトリが hybrid-base-directory/hybrid-files であることを確認します。
overrides-small.yaml ファイルを $APIGEECTL_HOME/examples ディレクトリから overrides ディレクトリにコピーします。
```
cp $APIGEECTL_HOME/examples/overrides-small.yaml ./overrides/overrides.yaml
```
このサンプルファイルでは、フットプリントが小さいハイブリッドランタイムインストール用の基本構成を提供します。この構成は初めてのインストールに適しています。
cd コマンドで overrides ディレクトリに移動します。

cd overrides

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

注: logger:enabled:false を設定して、オーバーライドファイルでロギングを無効にしてください。ロギングはデフォルトで GKE の一部として提供されます。

構文

overrides.yaml ファイルの構造と構文は次のとおりです。red, bold italics の値は、指定する必要があるプロパティ値です。詳しくは次の表をご覧ください。

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

k8sCluster:
  name: cluster-name
  region: cluster-region

org: org-name

virtualhosts:
  - name: virtual-host-name
    hostAliases:
      - "host-alias-1"
      - "host-alias-2"
      - "host-alias-n"
    sslCertPath: ./certs/cert-name.pem
    sslKeyPath: ./certs/key-name.key
    routingRules:
      - paths:
        - /path-1
        - /path-2
        - /path-n
        env: environment-name

envs:
  - name: environment-name          # The same name of the env you created in the UI
    serviceAccountPaths:
      synchronizer: ./service-accounts/synchronizer-service-account-name.json
      udca: ./service-accounts/udca-service-account-name.json

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

例

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

gcp:
  region: us-central1
  projectID: my-gcp-project

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

org: hybrid-org

virtualhosts:
  - name: default
    hostAliases:
      - "*.acme.com"
    sslCertPath: ./certs/keystore.pem
    sslKeyPath: ./certs/keystore.key
    routingRules:
      # - paths:
      - env: my-environment

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

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

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

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

変数	説明
`gcp-region`	`apigee-logger` と `apigee-metrics` がデータをプッシュする GCP リージョンを指定します。
`gcp-project-id`	`apigee-logger` と `apigee-metrics` がデータをプッシュする Google Cloud プロジェクトを指定します。
`cluster-name`	Kubernetes クラスタの名前。
`cluster-region`	クラスタが作成されたリージョン。
`org-name`	Apigee ハイブリッド組織の名前。
`virtual-host-name`	仮想ホストを識別する名前。
`host-alias (1 - n)`	（必須）環境の修飾 DNS 名。`.foo.com` のような部分的なワイルドカードを使用できます。包括的なワイルドカード `""` は使用できません。
`cert-name` `key-name`	前にランタイムゲートウェイ用の TLS 認証情報を作成するの手順で生成した自己署名 TLS 鍵と証明書ファイルの名前を入力します。これらのファイルは、`base_directory/hybrid-files/certs` ディレクトリに配置する必要があります。次に例を示します。 sslCertPath: ./certs/keystore.pem sslKeyPath: ./certs/keystore.key
`path (1 - n)`	ルーティングルールによって、指定されたパスへの API 呼び出しを示された環境の方向に向けます。`path-1` から `path-n` は、`environment-name` という環境にデプロイされた API プロキシへのベースパスです。 `paths:` は省略可能です。デフォルトのパスは / です。仮想ホストを構成するもご覧ください。注: 現時点では `paths:` は必要ありません。`paths:` とすべてのパスエントリを削除またはコメントアウトしてください。
`environment-name` （`routingRules` の下）	これは API 呼び出しのルーティング先となる環境です。ステップ 5: ハイブリッド UI で新しい環境を追加するの説明に従って、UI で環境を作成したときと同じ名前を使用します。 `path` エントリをコメントアウトまたは削除した場合は、`env` が `routingRules` の下に配置されていてダッシュで始まることを確認してください。例: routingRules: - env: my-environment 。
`environment-name`	ステップ 5: ハイブリッド UI で新しい環境を追加するの説明に従って、UI で環境を作成したときと同じ名前を使用します。
`synchronizer-service-account-name`	`create-service-account` ツールで生成した Synchronizer サービスアカウントキーファイルの名前。次に例を示します。 synchronizer: ./service-accounts/hybrid-project-apigee-synchronizer.json
`udca-service-account-name`	`create-service-account` ツールで生成した UDCA サービスアカウントキーファイルの名前。次に例を示します。 udca: ./service-accounts/hybrid-project-apigee-udca.json
`mart-host-alias`	MART サーバーエンドポイントの修飾 DNS 名。この名前は、この構成に必要な承認済み TLS 証明書で使用される共通名（CN）と一致する必要があります。次に例を示します。`mart.mydomain.com` 注: 証明書に含まれる共通名（CN）は、`mart.hostAlias` プロパティで指定された値と一致する必要があります。CN が `*.hybrid-domain.net` で、ホスト `mart.hybrid-domain.net` を登録している場合は、`mart.hostAlias` を値 `mart.hybrid-domain.net` に設定します。
`mart-service-account-name`	`create-service-account` ツールで生成した MART サービスアカウントキーファイルの名前。
`mart-cert-name` `mart-key-name`	前に MART ゲートウェイ用の TLS 認証情報を作成するの手順で生成した承認済み TLS 鍵と証明書ファイルの名前を入力します。これらのファイルは、`base_directory/hybrid-files/certs` ディレクトリに配置する必要があります。次に例を示します。 sslCertPath: ./certs/fullchain.pem sslKeyPath: ./certs/privkey.key
`metrics-service-account-name`	`create-service-account` ツールで生成した metrics サービスアカウントキーファイルの名前。次に例を示します。 serviceAccountPath: ./service-accounts/hybrid-project-apigee-metrics.json

まとめ

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

次のステップ

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