Langkah 7: Aktifkan akses Bidang Kontrol

Agar bidang runtime dan bidang kontrol dapat berkomunikasi, Anda harus mengaktifkan izin yang diperlukan untuk akses Synchronizer dan penerbit analisis dengan updateControlPlaneAccess API.

Mendapatkan token otorisasi

Untuk melakukan panggilan API Apigee yang dijelaskan nanti dalam topik ini, Anda harus mendapatkan token otorisasi yang memiliki peran Admin Organisasi Apigee.

1. Jika Anda bukan pemilik project Google Cloud yang terkait dengan organisasi Apigee Hybrid Anda, pastikan akun pengguna Google Cloud Anda memiliki peran roles/apigee.admin (Admin Organisasi Apigee). Anda dapat memeriksa peran yang ditetapkan kepada Anda dengan perintah ini:

   gcloud projects get-iam-policy $PROJECT_ID  \
     --flatten="bindings[].members" \
     --format='table(bindings.role)' \
     --filter="bindings.members:your_account_email"
   

   Contoh:

   gcloud projects get-iam-policy my-project  \
     --flatten="bindings[].members" \
     --format='table(bindings.role)' \
     --filter="bindings.members:myusername@example.com"

   Output harus menyertakan roles/apigee.admin.

2. Jika Anda tidak memiliki roles/apigee.admin, tambahkan peran Admin Organisasi Apigee ke akun pengguna Anda. Gunakan perintah berikut untuk menambahkan peran ke akun pengguna Anda:

   gcloud projects add-iam-policy-binding $PROJECT_ID \
     --member user:your_account_email \
     --role roles/apigee.admin

   Contoh:

   gcloud projects add-iam-policy-binding my-project \
     --member user:myusername@example.com \
     --role roles/apigee.admin

3. Di command line, dapatkan kredensial autentikasi gcloud menggunakan perintah berikut:

   Linux / MacOS

   export TOKEN=$(gcloud auth print-access-token)

   Untuk memeriksa apakah token Anda terisi, gunakan echo, seperti yang ditunjukkan contoh berikut:

   echo $TOKEN

   Token Anda akan ditampilkan sebagai string yang dienkode.

   Windows

   for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a

   Untuk memeriksa apakah token Anda terisi, gunakan echo, seperti yang ditunjukkan contoh berikut:

   echo %TOKEN%

   Token Anda akan ditampilkan sebagai string yang dienkode.

Mengaktifkan akses sinkronisasi

Untuk mengaktifkan akses penyinkron:

1. Dapatkan alamat email untuk akun layanan yang Anda beri akses sinkronisasi. Untuk lingkungan non-produksi (seperti yang disarankan dalam tutorial ini), nilainya harus apigee-non-prod. Untuk lingkungan produksi, nilainya harus apigee-synchronizer. Gunakan perintah berikut:

   gcloud iam service-accounts list --project $PROJECT_ID --filter "apigee-synchronizer"

2. Panggil updateControlPlaneAccess API untuk mengaktifkan izin yang diperlukan untuk Synchronizer menggunakan perintah berikut:

   Tidak ada residensi data

   curl -X PATCH -H "Authorization: Bearer $TOKEN" \
     -H "Content-Type:application/json" \
     "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/controlPlaneAccess?update_mask=synchronizer_identities" \
     -d "{\"synchronizer_identities\": [\"serviceAccount:apigee-synchronizer@$ORG_NAME.iam.gserviceaccount.com\"]}"
   

   Dengan:

   • $ORG_NAME: Nama organisasi hybrid Anda.
   • apigee-synchronizer@$ORG_NAME.iam.gserviceaccount.com: Alamat email akun layanan.

   Residensi data

   curl -X PATCH -H "Authorization: Bearer $TOKEN" \
     -H "Content-Type:application/json" \
     "https://$CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/$ORG_NAME/controlPlaneAccess?update_mask=synchronizer_identities" \
     -d "{\"synchronizer_identities\": [\"serviceAccount:apigee-synchronizer@$ORG_NAME.iam.gserviceaccount.com\"]}"
   

   Dengan:

   • CONTROL_PLANE_LOCATION: Lokasi untuk data bidang kontrol Anda jika penginstalan hybrid Anda menggunakan retensi data. Ini adalah lokasi tempat konten inti pelanggan seperti paket proxy disimpan. Untuk mengetahui daftarnya, lihat Region bidang kontrol API Apigee yang tersedia.
   • $ORG_NAME: Nama organisasi hybrid Anda.
   • apigee-synchronizer@$ORG_NAME.iam.gserviceaccount.com: Alamat email akun layanan.
3. Untuk memverifikasi bahwa akun layanan telah disetel, gunakan perintah berikut untuk memanggil API guna mendapatkan daftar akun layanan:

   Tidak ada residensi data

   curl -X GET -H "Authorization: Bearer $TOKEN" \
     -H "Content-Type:application/json" \
     "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/controlPlaneAccess"
       

   Residensi data

   curl -X GET -H "Authorization: Bearer $TOKEN" \
     -H "Content-Type:application/json" \
     "https://$CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/$ORG_NAME/controlPlaneAccess"
       

   Output-nya akan terlihat seperti berikut:

   {
     "synchronizerIdentities": [
       "serviceAccount:apigee-synchronizer@YOUR_ORG_NAME.iam.gserviceaccount.com"
     ]
   }

Mengaktifkan akses penayang analisis

Beberapa komponen runtime hybrid Apigee memublikasikan catatan debug dan analisis untuk memberikan informasi bagi pelaporan dan proses debug. Untuk mengaktifkan publikasi data ini, Anda perlu memberikan izin tambahan ke akun layanan yang menjalankan komponen Apigee ini untuk memublikasikan data langsung ke bidang kontrol.

Untuk mengaktifkan akses penayang analisis:

1. Dapatkan alamat email untuk akun layanan yang Anda beri akses penayang Analytics. Untuk lingkungan non-produksi (seperti yang disarankan dalam tutorial ini), nilainya harus apigee-non-prod. Untuk lingkungan produksi, nilainya harus apigee-runtime.
2. Tetapkan izin untuk akun layanan runtime guna memublikasikan data ke bidang kontrol dengan perintah berikut:

   Tidak ada residensi data

   curl -X  PATCH -H "Authorization: Bearer $TOKEN" \
     -H "Content-Type:application/json" \
     "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/controlPlaneAccess?update_mask=analytics_publisher_identities" \
     -d "{\"analytics_publisher_identities\": [\"serviceAccount:apigee-runtime@$ORG_NAME.iam.gserviceaccount.com\"]}"

   Residensi data

   curl -X  PATCH -H "Authorization: Bearer $TOKEN" \
     -H "Content-Type:application/json" \
     "https://$CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/$ORG_NAME/controlPlaneAccess?update_mask=analytics_publisher_identities" \
     -d "{\"analytics_publisher_identities\": [\"serviceAccount:apigee-runtime@$ORG_NAME.iam.gserviceaccount.com\"]}"

   Responsnya akan terlihat seperti berikut:

   {
     "name": "organizations/YOUR_ORG_NAME/operations/OPERATION_ID",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata",
       "operationType": "UPDATE",
       "targetResourceName": "organizations/YOUR_ORG_NAME/controlPlaneAccess",
       "state": "IN_PROGRESS"
     }
   }
   

   Dengan: OPERATION_ID adalah UUID operasi, misalnya 8316aa78-c137-4733-92ec-cc0d2d92fd29.

3. Simpan ID operasi ke variabel lingkungan untuk digunakan dalam memverifikasi status operasi.

   Sintaks

   export OPERATION_ID=OPERATION_ID

   Contoh

   export OPERATION_ID=8316aa78-c137-4733-92ec-cc0d2d92fd29

4. Verifikasi status operasi menggunakan ID di kolom name respons update:

   Tidak ada residensi data

   curl -X GET -H "Authorization: Bearer $TOKEN"  \
     -H "Content-Type:application/json"  \
     "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/operations/$OPERATION_ID"

   Residensi data

   curl -X GET -H "Authorization: Bearer $TOKEN"  \
     -H "Content-Type:application/json"  \
     "https://$CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/$ORG_NAME/operations/$OPERATION_ID"

   Responsnya akan terlihat seperti berikut:

   {
     "name": "organizations/YOUR_ORG_NAME/operations/OPERATION_ID",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata",
       "operationType": "UPDATE",
       "targetResourceName": "organizations/YOUR_ORG_NAME/controlPlaneAccess",
       "state": "FINISHED"
     },
     "done": true,
     "response": {
       "@type": "type.googleapis.com/google.cloud.apigee.v1.ControlPlaneAccess",
       "name": "organizations/YOUR_ORG_NAME/controlPlaneAccess"
     }
   }
   

5. Verifikasi konfigurasi ControlPlaneAccess organisasi:

   Tidak ada residensi data

   curl "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/controlPlaneAccess" \
   -H "Authorization: Bearer $TOKEN"

   Residensi data

   curl "https://$CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/$ORG_NAME/controlPlaneAccess" \
   -H "Authorization: Bearer $TOKEN"

   Responsnya akan terlihat seperti berikut:

   {
     "synchronizerIdentities": [
       "serviceAccount:apigee-synchronizer@YOUR_ORG_NAME.iam.gserviceaccount.com"
     ],
     "analyticsPublisherIdentities": [
       "serviceAccount:apigee-runtime@YOUR_ORG_NAME.iam.gserviceaccount.com"
     ]
   }
   

Sekarang Anda telah mengaktifkan bidang pengelolaan dan runtime hybrid Apigee untuk berkomunikasi. Selanjutnya, instal cert-manager agar Apigee hybrid dapat menafsirkan dan mengelola sertifikat.

Langkah berikutnya

1 2 3 4 5 6 7 (NEXT) Langkah 8: Instal cert-manager 9 10 11