Mengonfigurasi hybrid untuk menggunakan pipeline data baru

Ringkasan

Mulai dari versi 1.13.1, organisasi hybrid Apigee yang baru dibuat menggunakan pipeline data baru yang memungkinkan komponen runtime menulis data langsung ke bidang kontrol. Sebelumnya, hal ini dilakukan melalui komponen UDCA yang membuat URL yang ditandatangani untuk menulis 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.

Konfigurasi

Anda dapat mengonfigurasi hybrid untuk menggunakan pipeline data baru untuk setiap komponen menggunakan petunjuk berikut.

Menyetel Alur Otorisasi

Tetapkan izin untuk akun layanan runtime agar dapat berinteraksi dengan pipeline baru untuk mengirimkan data ke bidang 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://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."]}'

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 update:

Tidak ada residensi data

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"

Residensi data

curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)"  \
  -H "Content-Type:application/json"  \
  "https://CONTROL_PLANE_LOCATION-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:

Tidak ada residensi data

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/controlPlaneAccess" \
-H "Authorization: Bearer $(gcloud auth print-access-token)"

Residensi data

curl "https://CONTROL_PLANE_LOCATION-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."
  ],
  "analyticsPublisherIdentities": [
    "serviceAccount:apigee-runtime@newpipeline-hybrid-org."
  ]
}

Beralih antara pipeline baru dan lama untuk debug dan residensi data Analytics

Setelah otorisasi yang tepat diberikan ke akun layanan, pengguna dapat mengalihkan instance Apigee mereka untuk menggunakan pipeline baru.

Untuk beralih ke pipeline baru, tetapkan newDataPipeline.debugSession: true dan newDataPipeline.analytics: true dalam file overrides.yaml Anda.

Untuk berhenti menggunakan pipeline baru, tetapkan newDataPipeline.debugSession: false dan newDataPipeline.analytics: false dalam file overrides.yaml Anda.

Contoh:

... 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. Upgrade satu lingkungan dalam satu waktu. Tentukan lingkungan dengan --set env=ENV_NAME.

helm upgrade ENV_RELEASE_NAME apigee-env/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --set env=ENV_NAME \
  -f OVERRIDES_FILE
  • ENV_RELEASE_NAME adalah nama yang Anda gunakan sebelumnya untuk menginstal diagram apigee-env.
  • ENV_NAME adalah nama lingkungan yang Anda upgrade.