Résoudre les problèmes d’un runtime d’intégration auto-hébergé pris en charge par Kubernetes

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 :

  1. Une fois qu’une analyse affiche le status Échec, accédez à la machine virtuelle ou à la machine sur laquelle votre outil IRCTL est installé.
  2. Utilisez la ./irctl log uploadcommande.
  3. Lorsque les journaux sont téléchargés, conservez une trace de l’ID de chargement du journal imprimé.
  4. 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

  1. Assurez-vous que le fichier de contexte Kubernetes est situé dans le bon chemin.
  2. 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.

Capture d’écran de la ligne de commande après l’expiration du délai de création.

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 :

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.

Capture d’écran de la ligne de commande affichant le status ImagePullBackOff.

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:443
  • System.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

  1. 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 describe
    
  2. Vé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.)

  3. Sélectionnez Annuler l’inscription de l’installation à côté de la status et confirmez l’opération.

  4. Une fois l’annulation de l’inscription terminée, le status affiché est Non enregistré.

  5. Sélectionnez le runtime d’intégration et récupérez la clé d’inscription.

  6. Réinstallez le runtime d’intégration.

Étapes suivantes