Ringkasan
Mulai versi 1.13.1, organisasi campuran Apigee yang baru dibuat dapat menggunakan pipeline data baru yang memungkinkan komponen runtime menulis data langsung ke platform kontrol. Sebelumnya, hal ini dilakukan melalui komponen UDCA yang menghasilkan URL yang ditandatangani untuk ditulis ke Layanan Google Cloud. Pipeline baru ini menghilangkan kebutuhan akan UDCA dan komponen terkait lainnya yang bertanggung jawab untuk memproses data yang diupload ke Layanan Google Cloud. Lihat Menggunakan retensi data dengan Apigee Hybrid.
Konfigurasi
Anda dapat mengonfigurasi hybrid untuk menggunakan pipeline data baru untuk setiap komponen menggunakan petunjuk berikut.
Alur Otorisasi Setelan
Tetapkan izin untuk akun layanan runtime agar dapat berinteraksi dengan pipeline baru untuk mengirim data ke platform kontrol. Langkah ini diperlukan agar sesi Debug dan Analytics dapat beroperasi dengan pipeline baru:
curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-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"]}'
Responsnya akan terlihat seperti berikut:
{ "name": "organizations/newpipeline-hybrid-org/operations/8316aa78-c137-4733-92ec-cc0d2d92fd29", "metadata": { "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata", "operationType": "UPDATE", "targetResourceName": "organizations/newpipeline-hybrid-org/controlPlaneAccess", "state": "IN_PROGRESS" } }
Verifikasi status operasi menggunakan parameter nama dari respons pembaruan:
curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type:application/json" \ "https://apigee.googleapis.com/v1/organizations/ORG_NAME /operations/8316aa78-c137-4733-92ec-cc0d2d92fd29"
Responsnya akan terlihat seperti berikut:
{ "name": "organizations/newpipeline-hybrid-org/operations/8316aa78-c137-4733-92ec-cc0d2d92fd29", "metadata": { "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata", "operationType": "UPDATE", "targetResourceName": "organizations/newpipeline-hybrid-org/controlPlaneAccess", "state": "FINISHED" }, "done": true, "response": { "@type": "type.googleapis.com/google.cloud.apigee.v1.ControlPlaneAccess", "name": "organizations/newpipeline-hybrid-org/controlPlaneAccess" } }
Verifikasi konfigurasi ControlPlaneAccess organisasi:
curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME /controlPlaneAccess" \ -H "Authorization: Bearer $(gcloud auth print-access-token)"
Responsnya akan terlihat seperti berikut:
{ "synchronizerIdentities": [ "serviceAccount:apigee-synchronizer@newpipeline-hybrid-org.iam.gserviceaccount.com" ], "analyticsPublisherIdentities": [ "serviceAccount:apigee-runtime@newpipeline-hybrid-org.iam.gserviceaccount.com" ] }
Beralih antara pipeline baru dan lama untuk debug dan retensi data Analytics
Setelah otorisasi yang tepat diberikan ke akun layanan, pengguna dapat mengalihkan instance Apigee mereka untuk menggunakan pipeline baru. Hal ini dapat dilakukan dengan menetapkan flag berikut di overrides.yaml
.
... rest of the overrides.yaml ... gcp: projectID:PROJECT_ID region:ANALYTICS_REGION > # Specifies the analytics region for the hybrid org. This attribute is # the regional endpoint used to push analytics and debug data to the # control plane. For example: us-central1 newDataPipeline: debugSession: true # this flag enables debug session to use the new data pipeline analytics: true # this flag enables analytics to use the new data pipeline k8sCluster: name:CLUSTER_NAME region:CLUSTER_LOCATION # Must be the closest Google Cloud region to your cluster. For example, us-west1 org:ORG_NAME ... rest of the overrides.yaml ...
Terapkan perubahan ini dengan perintah helm upgrade
. Mengupgrade satu lingkungan satu per satu. Tentukan lingkungan dengan --set env=
ENV_NAME.
helm upgradeENV_RELEASE_NAME apigee-env/ \ --install \ --namespaceAPIGEE_NAMESPACE \ --set env=ENV_NAME \ -fOVERRIDES_FILE
- ENV_RELEASE_NAME adalah nama yang Anda gunakan untuk menginstal diagram
apigee-env
sebelumnya. - ENV_NAME adalah nama lingkungan yang Anda upgrade.