Visão geral
A partir da versão 1.13.1, as organizações híbridas da Apigee recém-criadas podem usar um novo pipeline de dados que permite que os componentes do ambiente de execução gravem dados diretamente no plano de controle. Antes, isso era feito pelo componente UDCA, que gerava URLs assinados para gravar nos Serviços do Google Cloud. O novo pipeline elimina a necessidade de UDCA e outros componentes relacionados responsáveis pelo processamento de dados enviados para os Serviços do Google Cloud. Consulte Como usar a residência de dados com a Apigee híbrida.
Configuração
É possível configurar a híbrida para usar o novo pipeline de dados para componentes individuais usando as instruções a seguir.
Fluxo de autorização de configuração
Defina permissões para a conta de serviço do ambiente de execução para interagir com o novo pipeline e enviar dados para o plano de controle. Essa etapa é necessária para permitir que as sessões de depuração e o Google Analytics funcionem com o novo pipeline:
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"]}'Ela será parecida com o exemplo a seguir:
{
"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"
}
}
Verifique o estado da operação usando o parâmetro de nome da resposta de atualização:
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"
Ela será parecida com o exemplo a seguir:
{
"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"
}
}
Verifique a configuração de ControlPlaneAccess da organização:
curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/controlPlaneAccess" \ -H "Authorization: Bearer $(gcloud auth print-access-token)"
Ela será parecida com o exemplo a seguir:
{
"synchronizerIdentities": [
"serviceAccount:apigee-synchronizer@newpipeline-hybrid-org.iam.gserviceaccount.com"
],
"analyticsPublisherIdentities": [
"serviceAccount:apigee-runtime@newpipeline-hybrid-org.iam.gserviceaccount.com"
]
}
Como alternar entre pipelines novos e antigos para depuração e residência de dados do Google Analytics
Depois que a autorização correta for fornecida às contas de serviço, os usuários poderão mudar a instância do Apigee para usar o novo pipeline. Para isso, é possível definir a seguinte flag no 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 ...
Aplique essas mudanças com o comando helm upgrade. Faça upgrade de um ambiente por vez. Especifique o ambiente com --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 é o nome com que você instalou anteriormente o
gráfico
apigee-env. - ENV_NAME é o nome do ambiente que você está fazendo upgrade.