Problème constaté
Après la mise à niveau d'Apigee hybrid, vos pods Universal Data Collection Agent (UDCA) et Connect Agent génèrent une erreur d'autorisation.
Messages d'erreur
Votre pod UDCA génère cette erreur dans les journaux :
Permission 'apigee.runtimeconfigs.get' denied on resource 'organizations/org-example/runtimeConfig' (or it may not exist)\\\",\\n \\\"status\\\": \\\"PERMISSION_DENIED\\
De plus, votre pod API Management for Runtime (MART) génère l'erreur suivante concernant l'agent Connect :
Permission 'apigeeconnect.endpoints.connect' denied on resource '//apigeeconnect.googleapis.com/projects/org-example/endpoints/APIGEE_MART' (or it may not exist).
Étapes de diagnostic courantes
Récupérez le script Apigee hybrid must-gather de votre cluster et le fichier overrides.yaml du cluster.
Causes possibles
| Cause | Description |
|---|---|
| Identifiants incorrects | Vous avez peut-être saisi des identifiants incorrects dans le fichier overrides.yaml. |
| Fichiers de compte de service situés dans le mauvais répertoire | Vos fichiers de compte de service (SA) se trouvent peut-être en dehors du répertoire $APIGEE_HELM_CHARTS_HOME. |
Cause 1 : Identifiants incorrects
Les valeurs serviceAccountPath ou serviceAccountRef utilisées dans votre fichier overrides.yaml pour les pods UDCA, MART et Connect Agent sont incorrectes. Cela peut être dû au fait que le fichier overrides.yaml a été généré par automatisation ou par des scripts personnalisés, par exemple à l'aide de Terraform.
Diagnostic
-
Vérifiez les rôles et les autorisations IAM attribués aux comptes de service que vous utilisez.
gcloud iam service-accounts get-iam-policy SERVICE_ACCOUNT_EMAIL
gcloud projects get-iam-policy PROJECT_IDOù :
- SERVICE_ACCOUNT_EMAIL est l'adresse e-mail du compte de service.
- PROJECT_ID est le projet Google Cloud associé au compte de service.
-
Examinez votre fichier
overrides.yamlpour vous assurer que le compte de service référencé correspond à celui utilisé dans la stratégie et les rôles IAM du projet.
Exemple
Voici un exemple de stratégie IAM fonctionnelle pour le compte de service d'une configuration hors production :
gcloud iam service-accounts get-iam-policy apigee-non-prod@org-example.iam.gserviceaccount.com
Exemple de résultat :
bindings: - members: - serviceAccount:org-example.svc.id.goog[apigee/apigee-cassandra-backup-sa] - serviceAccount:org-example.svc.id.goog[apigee/apigee-cassandra-default] - serviceAccount:org-example.svc.id.goog[apigee/apigee-cassandra-guardrails-sa] - serviceAccount:org-example.svc.id.goog[apigee/apigee-connect-agent-org-example-sa] - serviceAccount:org-example.svc.id.goog[apigee/apigee-mart-org-example-sa] - serviceAccount:org-example.svc.id.goog[apigee/apigee-metrics-sa] - serviceAccount:org-example.svc.id.goog[apigee/apigee-runtime-org-example-sa] - serviceAccount:org-example.svc.id.goog[apigee/apigee-synchronizer-org-example-sa] - serviceAccount:org-example.svc.id.goog[apigee/apigee-udca-org-example-sa] - serviceAccount:org-example.svc.id.goog[apigee/apigee-watcher-org-example-sa] role: roles/iam.workloadIdentityUser etag: BwYw33-1N8s= version: 1
Exemple de validation des rôles :
gcloud projects get-iam-policy org-example
Exemple de résultat :
bindings: - members: - serviceAccount:apigee-non-prod@org-example.iam.gserviceaccount.com role: roles/apigee.analyticsAgent - members: - serviceAccount:apigee-non-prod@org-example.iam.gserviceaccount.com role: roles/apigee.runtimeAgent - members: - serviceAccount:apigee-non-prod@org-example.iam.gserviceaccount.com role: roles/apigee.synchronizerManager - members: - serviceAccount:apigee-non-prod@org-example.iam.gserviceaccount.com role: roles/apigeeconnect.Agent - members: - serviceAccount:apigee-non-prod@org-example.iam.gserviceaccount.com role: roles/storage.objectAdmin
Pour la production, exécutez les mêmes commandes sur le compte de service de production pour apigee-udca et vérifiez les rôles IAM qui correspondent à la section Installation.
Solution
Si le fichier de compte de service utilisé dans votre overrides.yaml ne correspond pas au compte de service approprié dans la liaison et les rôles IAM du projet, vous devez supprimer et recréer le compte de service, puis corriger le fichier de compte de service utilisé dans le overrides.yaml.
Cause 2 : Les fichiers SA se trouvent dans le mauvais répertoire
Ce problème se produit lors de la configuration des charts Helm et de la création du compte de service.
Diagnostic
Vérifiez l'emplacement du fichier d'identifiants de votre compte de service pour vous assurer qu'il se trouve dans le répertoire de chart Helm approprié. Le fichier JSON du compte de service doit se trouver dans les répertoires suivants :
$APIGEE_HELM_CHARTS_HOME/apigee-datastore$APIGEE_HELM_CHARTS_HOME/apigee-telemetry$APIGEE_HELM_CHARTS_HOME/apigee-org$APIGEE_HELM_CHARTS_HOME/apigee-env
Exemple
Par exemple, vérifiez les répertoires de charts Helm en listant le répertoire apigee-datastore, et faites de même pour les répertoires apigee-org, apigee-env et apigee-telemetry.
Exemple de commande :
Assurez-vous d'être dans le bon répertoire :
pwd
Exemple de résultat :
/usr/local/home/example/Hybrid/helm-charts
├── apigee-datastore │ ├── org-example-apigee-non-prod.json │ └── templates ├── apigee-env │ ├── org-example-apigee-non-prod.json │ └── templates ├── apigee-ingress-manager │ └── templates ├── apigee-operator │ ├── etc │ │ ├── crds │ │ │ ├── crd │ │ │ │ ├── bases │ │ │ │ └── patches │ │ │ └── default │ │ ├── examples │ │ │ └── helmfiles │ │ └── tools │ │ └── service-accounts │ │ ├── org-example-apigee-cassandra.json │ │ ├── org-example-apigee-logger.json │ │ ├── org-example-apigee-mart.json │ │ ├── org-example-apigee-metrics.json │ │ ├── org-example-apigee-runtime.json │ │ ├── org-example-apigee-synchronizer.json │ │ ├── org-example-apigee-udca.json │ │ └── org-example-apigee-watcher.json │ └── templates ├── apigee-org │ ├── org-example-apigee-non-prod.json │ └── templates ├── apigee-redis │ └── templates ├── apigee-telemetry │ ├── org-example-apigee-non-prod.json │ └── templates ├── apigee-virtualhost │ ├── certs │ └── templates └── cluster-check 29 directories, 12 files
Solution
Copiez le fichier du compte de service dans les quatre répertoires (apigee-datastore, apigee-telemetry, apigee-org et apigee-env) conformément à l'exemple d'emplacement de l'arborescence ci-dessus, puis réexécutez les charts Helm.