Synchronizer を構成する

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

Synchronizer の概要

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

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

1 つの Synchronizer は、同じポッドにデプロイされた複数の Message Processor をサポートします。

Synchronizer アクセスを有効にする

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

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

gcloud を使用して OAuth 2.0 アクセストークンを取得します。ダウンロードしたサービスアカウントの認証情報（JSON ファイル）を GOOGLE_APPLICATION_CREDENTIALS 環境変数に設定します。
```
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 をご覧ください。
oauth2l ユーティリティ

OAuth 2.0 アクセストークンを取得するには、oauth2l を使用します。ステップ 1 でダウンロードしたサービスアカウントの認証情報（JSON ファイル）を渡します。
```
oauth2l fetch --json your_sa_credentials_file.json cloud-platform
```
返された OAuth 2.0 トークンをコピーし、TOKEN のような変数に格納します。例:
```
export TOKEN=ya29....Ts13inj3LrqMJlztwygtM
```
setSyncAuthorization API を呼び出し、Synchronizer に必要な権限を呼び出します。
重要: この 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 の詳細については、SyncAuthorization 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

oauth2l ユーティリティ