Configurar a conta de serviço do MART

Este tópico explica como configurar a conta de serviço do MART.

Como adicionar a conta de serviço MART

O MART e o Apigee Connect exigem uma conta de serviço do Google Cloud para autenticação.

Observação: as instalações no AKS, no EKS ou no GKE que usam a identidade da carga de trabalho não exigem um arquivo de chave da conta de serviço do Google Cloud (.json). Consulte Como ativar a Identidade da carga de trabalho no GKE e Como ativar a federação de identidade da carga de trabalho no AKS e no EKS.

Localize o arquivo de chave da conta de serviço apigee-mart. O arquivo precisa ter uma extensão .json. Ele precisa residir no diretório apigee-org ou em um subdiretório.
- Instalações PROD: apigee-mart.json
- Instalações NON-PROD: apigee-non-prod.json

Se você não encontrar o arquivo da conta de serviço do MART, crie e faça o download dele com o utilitário create-service-account:

Verifique se a PROJECT_ID variável de ambiente (em inglês) está configurada.
```
echo $PROJECT_ID
```
Defina, se necessário:
```
export PROJECT_ID=my-project-id
```

Crie a conta de serviço do MART. A ferramenta create-service-account está disponível em:

APIGEE_HELM_CHARTS_HOME/
└── apigee-operator/
    └── etc/
        └── tools/
            └── create-service-account

PROD

create-service-account \
  --env prod \
  --profile apigee-mart \
  --dir PATH_TO_apigee-org_CHART_DIR

NON-PROD

$HYBRID_FILES/tools/create-service-account \
  --env non-prod \
  --profile apigee-mart \
  --dir PATH_TO_apigee-org_CHART_DIR/

Edite o arquivo overrides.yaml e adicione o caminho do arquivo de chave às propriedades connectAgent e mart.serviceAccountPath:

PROD

connectAgent:
  serviceAccountPath: path_to_apigee-mart.json

mart:
  serviceAccountPath: path_to_apigee-mart.json

NON-PROD

connectAgent:
  serviceAccountPath: path_to_apigee-non-prod.json

mart:
  serviceAccountPath: path_to_apigee-non-prod.json

Exemplo:

...
      connectAgent:
        serviceAccountPath: /apigee/hybrid/helm-charts/apigee-org/apigee-mart.json

      mart:
        serviceAccountPath: /apigee/hybrid/helm-charts/apigee-org/apigee-mart.json
      ...

Aplique as alterações:
```
helm upgrade ORG_NAME apigee-org/ \
  --namespace apigee \
  --atomic \
  -f OVERRIDES_FILE.yaml
```
Observação: se você encontrar um erro que diz Error: UPGRADE FAILED: "ORG_NAME" has no deployed releases, substitua upgrade por install e repita o comando.