Synchronizer を構成する

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

Synchronizer の概要

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

ランタイムプレーンで実行中の Synchronizer インスタンスは、定期的に管理プレーンをポーリングし、契約をダウンロードしてローカルランタイムインスタンスでも使用できるようにします。

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

Synchronizer アクセスを有効にする

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

Google Cloud の設定手順で説明したように、Apigee API が有効になっていることを確認します。詳しくは、API を有効にするをご覧ください。
サービスアカウントと認証情報の作成の一環でダウンロードした書き込み可能な Google Cloud サービスアカウントキー（JSON ファイル）を探します。このサービスアカウントには Apigee 組織管理者のロールがあり、名前は apigee-org-admin です。このサービスアカウントをまだ作成していない場合は、続行する前にアカウントを作成する必要があります。
この Apigee 組織管理者サービスアカウントキーを使用し、OAuth 2.0 アクセストークンを生成します。このトークンは、Apigee API の認証で必要になります。
gcloud

gcloud を使用して、ダウンロードしたサービスアカウント認証情報の JSON ファイルを GOOGLE_APPLICATION_CREDENTIALS 環境変数によって渡し、OAuth 2.0 アクセストークンを取得します。
```
export GOOGLE_APPLICATION_CREDENTIALS=your_sa_credentials_file.json
gcloud auth application-default print-access-token
```
OAuth2.0 トークンが返されます。

詳細については、gcloud beta auth application-default print-access-token をご覧ください。
返された OAuth 2.0 トークンをコピーし、TOKEN のような変数に格納します。次に例を示します。
```
export TOKEN=ya29....Ts13inj3LrqMJlztwygtM
```
setSyncAuthorization API を呼び出し、Synchronizer に必要な権限を有効にします。
ヒント: Terraform を使用している場合は、setSyncAuthorization API を呼び出す代わりに Terraform 属性 google_apigee_sync_authorization を使用できます。

重要: この API に追加するサービスアカウント名に Apigee Synchronizer 管理者のロールがあることを確認してください。サービスアカウントと認証情報を作成するもご覧ください。
```
curl -X POST -H "Authorization: Bearer $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 $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 の詳細については、setSyncAuthorization API をご覧ください。

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

curl -X POST -H "Authorization: Bearer $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="
}

Synchronizer を構成する

Synchronizer の概要

Synchronizer アクセスを有効にする

gcloud