개요
버전 1.13.1부터 데이터 상주가 사용 설정된 Apigee Hybrid 조직은 런타임 구성요소에서 데이터를 컨트롤 플레인에 직접 쓸 수 있는 새 데이터 파이프라인을 사용할 수 있습니다. 이전에는 이 작업이 Google Cloud 서비스에 쓸 서명된 URL을 생성하는 UDCA 구성요소를 통해 수행되었습니다. 새 파이프라인을 사용하면 Google Cloud 서비스에 업로드된 데이터를 처리하는 UDCA 및 기타 관련 구성요소가 필요하지 않습니다.
구성
다음 안내에 따라 개별 구성요소에 새 데이터 파이프라인을 사용하도록 Hybrid를 구성할 수 있습니다.
설정 승인 흐름
새 파이프라인과 상호작용하여 데이터를 컨트롤 플레인에 내보낼 수 있는 런타임 서비스 계정의 권한을 설정합니다. 새 파이프라인에서 디버그 세션과 애널리틱스가 작동하게 하려면 이 단계가 수행해야 합니다.
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"]}'다음과 같은 응답이 표시됩니다.
{
"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"
}
}
업데이트 응답의 이름 매개변수를 사용하여 작업 상태를 확인합니다.
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"
다음과 같은 응답이 표시됩니다.
{
"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"
}
}
조직의 ControlPlaneAccess 구성을 확인합니다.
curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/controlPlaneAccess" \ -H "Authorization: Bearer $(gcloud auth print-access-token)"
다음과 같은 응답이 표시됩니다.
{
"synchronizerIdentities": [
"serviceAccount:apigee-synchronizer@newpipeline-hybrid-org.iam.gserviceaccount.com"
],
"analyticsPublisherIdentities": [
"serviceAccount:apigee-runtime@newpipeline-hybrid-org.iam.gserviceaccount.com"
]
}
디버그 및 애널리틱스 데이터 상주를 위해 새 파이프라인과 이전 파이프라인 간에 전환
서비스 계정에 적절한 승인이 제공되면 사용자는 Apigee 인스턴스를 전환하여 새 파이프라인을 사용할 수 있습니다.
새 파이프라인으로 전환하려면 overrides.yaml 파일에서 newDataPipeline.debugSession: true 및 newDataPipeline.analytics: true을 설정하세요.
새 파이프라인 사용을 중지하려면 overrides.yaml 파일에서 newDataPipeline.debugSession: false 및 newDataPipeline.analytics: false을 설정하세요.
예를 들면 다음과 같습니다.
... 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 ...
helm upgrade 명령어를 사용하여 이러한 변경사항을 적용합니다. 한 번에 환경 하나를 업그레이드합니다. --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은 이전에
apigee-env차트를 설치한 이름입니다. - ENV_NAME은 업그레이드하는 환경의 이름입니다.