Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Importante
Les fonctionnalités de gouvernance des données de catalogue unifié Microsoft Purview et Microsoft Purview classique (anciennement Azure Purview) sont mises hors service. Microsoft consolide ses fonctionnalités de gouvernance des données dans Microsoft Fabric. Vous ne pouvez plus créer de comptes et les fonctionnalités existantes resteront en mode maintenance jusqu’au 12 novembre 2027. Pour connaître les délais de mise hors service, les conseils de transition et les prochaines étapes recommandées, consultez l’annonce de mise hors service de la gouvernance des données Microsoft Purview.
Cet article décrit en détail la résolution des problèmes du nouveau runtime d’intégration auto-hébergé basé sur Kubernetes pour Linux.
Vous pouvez rechercher les erreurs que vous voyez dans le guide des erreurs ci-dessous. Pour obtenir de l’aide et des conseils de dépannage pour les problèmes HIR, vous devrez peut-être générer un ID de chargement du journal et contacter le support Microsoft.
Collecter les journaux du runtime d’intégration auto-hébergé Kubernetes
Pour générer l’ID de chargement du journal pour le compte de Support Microsoft :
- Une fois qu’une analyse affiche le status Échec, accédez à la machine virtuelle ou à la machine sur laquelle votre outil IRCTL est installé.
- Utilisez la
./irctl log uploadcommande. - Lorsque les journaux sont téléchargés, conservez une trace de l’ID de chargement du journal imprimé.
- Si le runtime d’intégration auto-hébergé ne parvient pas à s’enregistrer, utilisez le guide ci-dessous pour télécharger les journaux en local et les envoyer au Support Microsoft
Pour collecter le journal du runtime d’intégration auto-hébergé et analyser le journal d’exécution pour résoudre les problèmes liés à votre SHIR, utilisez la ./irctl log downloadcommande.
Par exemple :
./irctl log download --destination "C:\Users\user\logs\"
Les journaux sont téléchargés vers le chemin de destination.
Remarque
Le journal est réservé pendant 14 jours. Conservez-le en le téléchargeant sur Microsoft ou en le téléchargeant sur votre ordinateur local.
Erreur de connectivité IRCTL à Kubernetes
Vous pouvez obtenir une configuration de contexte Kubernetes auprès de votre administrateur Kubernetes et l’enregistrement peut échouer avec l’un des messages d’erreur suivants :
Error: invalid flag context [] .kube/config: no such file or directory[Warning] Failed to create kube client with context [] with error
Cause
Lors de l’installation d’un runtime d’intégration auto-hébergé, une configuration correcte de Kubernetes et une connectivité stable sont requises.
Résolution
- Assurez-vous que le fichier de contexte Kubernetes est situé dans le bon chemin.
- Assurez-vous que la machine IRCTL peut atteindre le serveur d’API du cluster Kubernetes.
Erreur d’autorisation IRCTL
Lors de la connexion, les messages d’erreur suivants peuvent s’afficher :
[Error] Failed to list namespaces to get Running SHIR[Error] Failed to get configmap/ create job/ etc.
Cause
Lors de l’installation d’un runtime d’intégration auto-hébergé, des autorisations suffisantes sur plusieurs ressources Kubernetes sont requises.
Résolution
Régénérez le jeton de compte de service Kubernetes avec un rôle d’Administration.
Erreur de connectivité IRCTL au point de terminaison du service Microsoft Purview
Lorsque vous essayez d’enregistrer le runtime d’intégration auto-hébergé pris en charge par Kubernetes, la commande de création IRCTL peut renvoyer les erreurs suivantes :
[Error] Failed to register SHIR with error: Post “https://[REGION].compute.governance.azure.com/purviewAccounts/[]/integrationruntimes/[]/registerselfhostedintegrationruntime: []”
Cause
IRCTL ne peut pas se connecter au serveur principal de service. Ce problème est généralement dû aux paramètres réseau ou au pare-feu.
Résolution
Examinez la topologie du réseau de l’hôte IRCTL. Reportez-vous aux sections suivantes de la page de résolution des problèmes généraux du runtime d’intégration : Pare-feu, DNSServer, approbations de certificats SSL et proxy http.
La clé d’inscription n’est pas autorisée
Lorsque vous essayez d’enregistrer le runtime d’intégration auto-hébergé pris en charge par Kubernetes, la commande de création IRCTL peut renvoyer les erreurs suivantes :
[Error] failed to register SHIR with error: Request is not authorized.
Cause
Ils avaient expiré ou avaient été révoqués manuellement.
Résolution
Régénérez la clé à partir de la page du runtime d’intégration dans le portail Microsoft Purview, puis réinscrivez-la.
Erreur de délai d’attente de création IR auto-hébergée de Kubernetes
Lorsque vous tentez d’enregistrer le runtime d’intégration auto-hébergé pris en charge par Kubernetes, la commande de création IRCTL peut s’exécuter longtemps jusqu’à ce qu’elle expire.
Vous pouvez commencer par vérifier le status des pods sous les espaces de noms mentionnés par la irctl describe commande.
Par exemple :
./irctl describe
K8s SHIR Name:shir-demo
Purview AccountName: shirdemopurview
Installation ID: 00000000-0000-0000-0000-000000000000
Kubernetes Namespace: shirdemopurview-shir-demo, compute-fleet-system(control-plane)
K8s SHIR Version: Unknown (Installation not completed)
Status: Initializing
Healthiness: Unhealthy
kubectl get pods --namespace shirdemopurview-shir-demo
NAME READY STATUS RESTARTS AGE
batch-defaultspec-4pbwx 0/1 Pending 0 10m
batch-defaultspec-7t9bl 0/1 Pending 0 10m
dynamic-config-provider-778c686fdc-9mkjb 0/1 Pending 0 10m
interactive-schemaprocess-bcrmf 0/1 Pending 0 10m
interactive-schemaprocess-fn66x 0/1 Pending 0 10m
logagent-ds-84jqn 0/1 Pending 0 10m
logagent-ds-k7vw8 0/1 Pending 0 10m
user-credential-proxy-579c899b64-d4q5v 0/1 Pending 0 10m
Il existe plusieurs causes possibles :
- Connectivité au point de terminaison du service Microsoft Purview
- Erreur de configuration de nœud Kubernetes
Cause - Connectivité au point de terminaison du service Microsoft Purview
Kubernetes ne peut pas se connecter à MCR (mcr.microsoft.com). Cette erreur est généralement due à des paramètres réseau ou à un pare-feu.
Si le status s’affiche sous la forme « ImagePullBackOff », cela signifie que votre Kubernetes ne peut pas se connecter à MCR (mcr.microsoft.com) pour télécharger les images de pod. Cette erreur est généralement due à des paramètres réseau ou à un pare-feu.
Résolution - Connectivité avec le point de terminaison du service Microsoft Purview
Examinez la topologie du réseau de votre cluster Kubernetes. Par exemple, pour Azure Kubernetes, vous devez vérifier la case activée :
Remarque
Les étapes de dépannage requises sont différentes pour chaque fournisseur Kubernetes. L’emplacement de déploiement et les détails réseau individuels varient d’un réseau à l’autre. Vous devez revoir la connectivité via le réseau de votre organisation.
Examinez la topologie du réseau de l’hôte IRCTL. Reportez-vous aux sections suivantes de la page de résolution des problèmes généraux du runtime d’intégration : Pare-feu, DNSServer, approbations de certificats SSL et proxy http.
Cause - Erreur de configuration du nœud Kubernetes
Si le status de certains pods reste bloqué sur « En attente », utilisez la commande describe pod pour afficher les détails du pod.
Par exemple :
kubectl describe pod batch-defaultspec-4pbwx --namespace shirdemopurview-shir-demo
Events:
Type Reason Age From Message
---- ------ ---- ---- -------
Warning FailedScheduling 13m default-scheduler 0/5 nodes are available: 1 Too many pods. preemption: 0/5 nodes are available: 5 No preemption victims found for incoming pod..
Les événements de la commande describe peuvent indiquer la raison pour laquelle le pod est en attente. L’erreur FailedScheduling avec le message détaillé indique que le nombre total de pods dépasse le nombre maximal de pods sur un nœud. Un nouveau pod ne peut pas être programmé sur le nœud sélectionné.
Remarque
Si aucun événement n’est visible sous la description, essayez de supprimer le pod manuellement par kubectl delete pod commande et suivez celui qui vient d’être créé.
Résolution - Erreur de configuration du nœud Kubernetes
Réservez le numéro de pod 20 pour le runtime d’intégration Kubernetes pour prendre en charge les scénarios d’utilisation normale et de mise à niveau.
Erreur de connectivité Kubernetes avec le point de terminaison du service Microsoft Purview
Lorsque vous essayez d’enregistrer le runtime d’intégration auto-hébergé pris en charge par Kubernetes, la commande de création IRCTRL peut s’exécuter longtemps jusqu’à ce qu’elle expire. Ou, après une installation réussie, le status du runtime d’intégration auto-hébergé s’affiche comme étant défectueux ou hors connexion dans le portail Microsoft Purview.
Consultez les journaux à l’aide de cette commande : kubectl logs [podName] -n compute-fleet-system
L’une de ces erreurs peut apparaître :
“TraceMessage”:”HttpRequestFailed”, “Host”: “fleet.[REGION].compute.governance.azure.com”Exception":"System.Net.Http.HttpRequestException: Connection refused fleet.[REGION].compute.governance.azure.com:443System.AggregateException: Failed to acquire identity token from https://fleet. [REGION].compute.governance.azure.com:443
Cause
Kubernetes ne peut pas se connecter au serveur principal du service. Cette erreur est généralement due à des paramètres réseau ou à un pare-feu.
Résolution
Examinez la topologie du réseau de votre cluster Kubernetes. Par exemple, pour Azure Kubernetes, vous devez vérifier la case activée :
Remarque
Les étapes de dépannage requises sont différentes pour chaque fournisseur Kubernetes. L’emplacement de déploiement et les détails réseau individuels varient d’un réseau à l’autre. Vous devez revoir la connectivité via le réseau de votre organisation.
Examinez la topologie du réseau de l’hôte IRCTL. Reportez-vous aux sections suivantes de la page de résolution des problèmes généraux du runtime d’intégration : Pare-feu, DNSServer, approbations de certificats SSL et proxy http.
Désinscrire un runtime dont la ressource locale n’est pas disponible
Si votre runtime d’intégration local auto-hébergé est accidentellement supprimé du cluster Kubernetes, vous ne pouvez pas le supprimer à l’aide de la irctl delete commande et vous ne pouvez pas l’installer sur un autre cluster Kubernetes.
Cause
Un runtime d’intégration auto-hébergé ne peut être installé que sur un seul cluster Kubernetes. Une fois inscrit, il ne peut pas être installé sur un autre cluster tant qu’il n’est pas inscrit.
Résolution
Vérifiez le status local de l’intégration auto-hébergée. Vous devez voir qu’aucun runtime d’intégration auto-hébergé en cours d’exécution n’est trouvé.
$./irctl describeVérifiez le runtime d’intégration auto-hébergé dans le portail Microsoft Purview. Vous devriez voir un status hors ligne. (Bien qu’il existe une latence de 1 heure pour l’expiration du jeton.)
Sélectionnez Annuler l’inscription de l’installation à côté de la status et confirmez l’opération.
Une fois l’annulation de l’inscription terminée, le status affiché est Non enregistré.
Sélectionnez le runtime d’intégration et récupérez la clé d’inscription.