Partager via

Tutoriel : Connecter un wiki Azure DevOps à Azure SRE Agent

Dans ce tutoriel, vous connectez un wiki Azure DevOps en tant que source de connaissances pour votre agent Azure SRE. Après avoir terminé ces étapes, votre agent peut rechercher dans le wiki de votre équipe des runbooks et procédures pour répondre aux questions lors des enquêtes.

Dans ce tutoriel, vous allez apprendre à :

  • Connecter un wiki Azure DevOps à l’aide du connecteur de documentation
  • Choisir entre l’authentification par identité managée et le jeton d’accès personnel (PAT)
  • Vérifiez la connexion en posant à votre agent une question qui utilise du contenu wiki

Durée estimée : 10 minutes

Prerequisites

Avant de commencer, vérifiez que vous disposez des ressources et de l’accès suivants :

  • Agent Azure SRE (déjà créé).
  • Un projet Azure DevOps avec un wiki qui contient du contenu.
  • L’une des options d’authentification suivantes :
    • Identité managée : ajoutez l’identité managée de votre agent en tant qu’utilisateur dans votre organisation Azure DevOps (Paramètres de l'organisation>Utilisateurs>Ajouter des utilisateurs> entrez l’ID client de l’identité).
    • Jeton d’accès personnel (PAT) : générez dans Azure DevOps avec l’étendue Code (Lecture).

Obtenir votre URL wiki

Pour connecter votre wiki, vous avez d’abord besoin de l’URL d’Azure DevOps.

  1. Accédez à votre projet Azure DevOps.
  2. Sélectionnez Wiki dans la barre latérale gauche.
  3. Copiez l’URL à partir de la barre d’adresses de votre navigateur.

Votre URL ressemble à cet exemple :

https://dev.azure.com/{your-org}/{your-project}/_wiki/wikis/{wiki-name}

Les URL héritées sont également prises en charge :

https://{your-org}.visualstudio.com/{your-project}/_wiki/wikis/{wiki-name}

Conseil / Astuce

Pour indexer uniquement une section spécifique de votre wiki, accédez d’abord à cette section dans Azure DevOps, puis copiez l’URL. L’ID de page dans l’URL indique à votre agent d’analyser uniquement cette page et ses sous-pages. Cette approche est utile pour les wikis volumineux où seule une section comme /Operations ou /Runbooks est pertinente.

Ouvrir la page Connecteurs

Accédez à la configuration des connecteurs dans le portail Azure SRE Agent.

  1. Allez à sre.azure.com.
  2. Sélectionner votre agent.
  3. Dans la barre latérale gauche, développez Générateur.
  4. Sélectionnez Connecteurs.

Une liste de vos connecteurs existants s’affiche, affichant leurs noms, types de service et état de connexion.

Démarrer l'assistant d'ajout de connecteur

Sélectionnez Ajouter un connecteur dans la barre d’outils pour ouvrir un Assistant en trois étapes :

  1. Choisissez un connecteur : sélectionnez le type de connecteur.
  2. Configurer le connecteur : configurer le nom, l’URL et l’authentification.
  3. Vérifier + ajouter : Confirmer et créer.

Sélectionner le connecteur de documentation

Dans le sélecteur de connecteurs, recherchez et sélectionnez Le connecteur documentation avec le sous-titre Azure DevOps. La description du connecteur lit : « L’agent fait référence à la documentation et aux fichiers pour comprendre vos projets et processus ».

Sélectionnez Suivant pour passer au formulaire d’installation.

Configurer le connecteur

Le titre du formulaire montre configurer le connecteur Azure DevOps. Remplissez les champs suivants :

Champ Que faut-il entrer ?
Nom Nom descriptif (par exemple, ops-wiki ou team-runbooks)
Azure DevOps URL URL de votre wiki à partir de l’étape précédente

Choisissez votre méthode d’authentification

Sélectionnez l’une des options d’authentification suivantes.

  1. Sélectionnez Identité managée (sélectionnée par défaut).
  2. Choisissez votre identité managée dans la liste déroulante Identité managée (par défaut, affectée par le système).
  3. Si vous le souhaitez, sélectionnez Utiliser l’identité managée en tant qu'identifiants d'identité fédérée.

Option B : Jeton d’accès personnel (PAT)

  1. Sélectionnez Jeton d’accès personnel (PAT) .
  2. Collez votre PAT Azure DevOps dans le champ Jeton d’accès personnel .

Sélectionnez Suivant pour passer à l’étape de révision.

Examiner et créer le connecteur

Passez en revue les détails de votre connecteur sur l’écran résumé, puis sélectionnez le bouton Envoyer pour créer le connecteur.

Votre nouveau connecteur apparaît dans la liste des connecteurs avec l’état Connecté (coche verte).

Note

L’indexation initiale peut prendre quelques minutes en fonction de la taille de votre wiki. Votre agent peut utiliser le contenu wiki une fois l’indexation terminée.

Vérifier la connexion

Testez la nouvelle connexion wiki en posant à l’agent une question que votre contenu wiki peut répondre.

  1. Sélectionnez Nouveau fil de conversation dans la barre latérale.
  2. Posez une question à laquelle votre contenu wiki peut répondre.

Par exemple:

What are our standard procedures for handling a database failover?

Votre agent effectue une recherche dans votre wiki en même temps que d’autres sources de connaissances et inclut des citations qui relient la page wiki d’origine dans sa réponse. La réponse inclut un lien de citation vers la page wiki source dans Azure DevOps.

Résolution des problèmes

Utilisez le tableau suivant pour résoudre les problèmes courants liés au connecteur wiki Azure DevOps.

Problème Solution
Le connecteur affiche déconnecté Vérifiez le format de votre URL wiki et les informations d’identification d’authentification.
Le contenu wiki n’apparaît pas dans les réponses Patientez quelques minutes pour que l’indexation initiale se termine, puis réessayez.
Erreur de validation d’URL Vérifiez que l’URL correspond https://dev.azure.com/{org}/{project}/_wiki/wikis/{wiki-name} ou https://dev.azure.com/{org}/{project}/_git/{repo}. Les URL héritées visualstudio.com sont également acceptées.
Échec de l’authentification PAT Assurez-vous que votre PAT ait la portée Code (lecture) et qu’il n’ait pas expiré.
Échec de l’identité managée Vérifiez que l'identité managée de l'agent est ajoutée en tant qu'utilisateur dans votre organisation Azure DevOps (Paramètres de l'organisation>Utilisateurs).

Étape suivante

En savoir plus sur les connaissances du Wiki ADO

Contenu connexe

  • Last updated on