Mengonfigurasi Synchronizer

Bagian ini menjelaskan Sinkronisasi.

Ringkasan sinkronisasi

Di Apigee hybrid, tugas utama Synchronizer adalah melakukan polling dan mendownload kontrak runtime yang disediakan oleh bidang pengelolaan. Informasi yang dikomunikasikan oleh kontrak mencakup proxy API, produk API, cache, dan host virtual. Secara default, Synchronizer menyimpan data konfigurasi lingkungan di database Cassandra.

Instance sinkronisasi yang berjalan di runtime-plane diharapkan melakukan polling pada management plane secara rutin, mendownload kontrak, dan menyediakannya untuk instance runtime lokal.

Satu Sinkronisasi dapat mendukung banyak Pemroses Pesan yang di-deploy di pod yang sama.

Mengaktifkan akses Synchronizer

Anda harus memberikan izin Synchronizer untuk menarik artefak Apigee, seperti paket proxy dan resource dari bidang pengelolaan. Anda harus memanggil Apigee API untuk memberi otorisasi pada Synchronizer agar menarik artefak dari bidang pengelolaan ke bidang runtime.

  1. Pastikan Anda telah mengaktifkan Apigee API seperti yang dijelaskan dalam langkah-langkah penyiapan GCP. Untuk mengetahui detailnya, lihat Langkah 3: Aktifkan API.
  2. Temukan kunci akun layanan GCP yang memiliki akses tulis (file JSON) yang Anda download sebagai bagian dari Membuat akun layanan. Akun layanan memiliki peran Apigee Org Admin dan merupakan akun yang bernama "apigee-org-admin". Jika Anda belum pernah membuat akun layanan ini, Anda harus melakukannya sebelum melanjutkan.

  3. Tetapkan variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS ke jalur tempat kunci akun layanan berada:

    export GOOGLE_APPLICATION_CREDENTIALS=your_sa_credentials_file.json
  4. Panggil API setSyncAuthorization untuk mengaktifkan izin yang diperlukan untuk 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"]}'

    Dengan:

    • your_org_name: Nama organisasi hybrid.
    • synchronizer-manager-service-account-name: Nama akun layanan dengan peran Apigee Synchronizer Manager. Nama tersebut dibentuk seperti alamat email. Contoh: my-synchronizer-manager-service_account@my_project_id.iam.gserviceaccount.com

    Contoh:

    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"]}'

    Untuk mengetahui informasi selengkapnya tentang API ini, lihat SyncAuthorization API.

  5. Untuk memverifikasi bahwa akun layanan telah disetel, panggil API berikut untuk mendapatkan daftar akun layanan: 
    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 ''

    Outputnya akan terlihat mirip seperti berikut:

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