Synchronizer を構成する

このセクションでは Synchronizer について説明します。

Synchronizer の概要

Apigee ハイブリッドでの Synchronizer の主な役割は、管理プレーンから提供されるランタイム契約をポーリングし、ダウンロードすることです。契約によって通知される情報には、API プロキシ、API プロダクト、キャッシュ、仮想ホストなどがあります。

ランタイムプレーンで実行中の Synchronizer インスタンスにより、定期的に管理プレーンがポーリングされて契約がダウンロードされ、ローカルのランタイムインスタンスで同じ情報が使用できるようになります。

1 つの Synchronizer により、同じ Pod にデプロイされた複数の Message Processor がサポートされます。

Synchronizer アクセスを有効にする

プロキシバンドルやリソースなどの Apigee アーティファクトを管理プレーンから pull するには、Synchronizer の権限を付与する必要があります。管理プレーンからランタイムプレーンにアーティファクトを pull するには、Apigee API を呼び出して Synchronizer を承認する必要があります。

GCP の設定手順で説明したように Apigee API が有効になっていることを確認します。詳細については、ステップ 3: API を有効にするをご覧ください。
サービスアカウントの作成の一環でダウンロードした書き込み可能な GCP サービスアカウントキー（JSON ファイル）を検索します。このサービスアカウントには Apigee 組織管理者のロールがあり、名前は apigee-org-admin です。このサービスアカウントをまだ作成していない場合は、アカウントを作成してから続行する必要があります。
GOOGLE_APPLICATION_CREDENTIALS 環境変数をサービスアカウントキーが置かれているパスに設定します。
```
export GOOGLE_APPLICATION_CREDENTIALS=your_sa_credentials_file.json
```
setSyncAuthorization API を呼び出して Synchronizer に必要な権限を有効にします。
重要: この API に追加するサービスアカウント名には、Apigee Synchronizer 管理者ロールが必要です。サービスアカウントを作成するもご覧ください。
```
curl -X POST -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
  -H "Content-Type:application/json" \
  "https://apigee.googleapis.com/v1/organizations/your_org_name:setSyncAuthorization" \
   -d '{"identities":["serviceAccount:synchronizer-manager-service-account-name"]}'
```
ここで
- your_org_name: ハイブリッド組織の名前。
- synchronizer-manager-service-account-name: Apigee Synchronizer 管理者ロールを持つサービスアカウントの名前。この名前はメールアドレスのような形式になっています。たとえば、my-synchronizer-manager-service_account@my_project_id.iam.gserviceaccount.com のようになります。
例:
```
curl -X POST -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
  -H "Content-Type:application/json" \
  "https://apigee.googleapis.com/v1/organizations/my_org:setSyncAuthorization" \
   -d '{"identities":["serviceAccount:my-synchronizer-manager-service_account@my_project_id.iam.gserviceaccount.com"]}'
```
この API の詳細については、SyncAuthorization API をご覧ください。

サービスアカウントが設定されていることを確認するには、次の API を呼び出してサービスアカウントのリストを取得します。

curl -X POST -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
  -H "Content-Type:application/json" \
  "https://apigee.googleapis.com/v1/organizations/your_org_name:getSyncAuthorization" \
   -d ''

出力は次のようになります。

{
   "identities":[
      "serviceAccount:my-synchronizer-manager-service_account@my_project_id.iam.gserviceaccount.com"
   ],
   "etag":"BwWJgyS8I4w="
}