Passer au contenu principal
Azure Repos nécessite un forfait Enterprise.
Mintlify se connecte à Azure Repos via Microsoft Entra ID. Vous vous connectez avec votre compte Microsoft afin que Mintlify puisse vérifier les organisations, projets et dépôts auxquels vous avez accès. Mintlify utilise ensuite l’application Mintlify dans votre tenant Entra pour lire votre dépôt, créer des service hooks, déployer chaque modification poussée sur votre branche de déploiement et créer des déploiements de prévisualisation pour les pull requests. Mintlify prend en charge les organisations Azure DevOps Services sur dev.azure.com connectées à Microsoft Entra ID, y compris les organisations qui utilisent encore des URL *.visualstudio.com. Mintlify ne prend pas en charge Azure DevOps Server.

​
Prérequis

  • Une organisation Azure DevOps connectée à Microsoft Entra ID.
  • Un administrateur Entra qui accorde son consentement à l’application Mintlify dans votre tenant.
  • L’application Mintlify ajoutée à votre organisation Azure DevOps avec un accès Basic, ainsi qu’au projet qui contient votre dépôt.
  • L’application Mintlify dans le groupe Project Administrators du projet. Azure DevOps n’autorise que les administrateurs de projet à créer des service hooks.
  • Un compte Microsoft administrateur du projet ou disposant de Manage permissions sur le dépôt que vous souhaitez connecter.
  • Un accès administrateur à votre organisation Mintlify.
  • Un fichier docs.json dans votre dépôt.

​
Configurer une nouvelle connexion Azure Repos

Lorsque vous ouvrez Git Settings pour la première fois, un assistant de configuration vous guide pour connecter votre dépôt.
1

Sélectionner Azure Repos comme fournisseur

  1. Sur la page Git Settings, cliquez sur Connect to Azure Repos.
  2. Cliquez sur Continue.
2

Déplacer le contenu hébergé par Mintlify

Si vous hébergez actuellement votre contenu dans un dépôt géré par Mintlify, téléchargez-le sous forme de fichier zip. Extrayez le contenu du zip et poussez les fichiers vers votre dépôt Azure Repos.Si votre contenu se trouve déjà dans Azure Repos, cliquez sur Continue setup.
3

Connecter Microsoft

  1. Cliquez sur Connect Microsoft.
  2. Connectez-vous avec un compte Microsoft administrateur du projet ou disposant de Manage permissions sur le dépôt que vous souhaitez connecter.
Une fois connecté, Microsoft vous redirige vers vos paramètres Git Mintlify.
4

Sélectionner le dépôt

Sélectionnez les valeurs suivantes. Chaque liste affiche les ressources auxquelles votre compte Microsoft a accès.
  • Organization : l’organisation Azure DevOps. Par exemple, dans https://dev.azure.com/acme/docs-project/_git/docs, acme est l’organisation.
  • Project : le projet qui contient le dépôt, par exemple docs-project.
  • Repository : le nom du dépôt, par exemple docs.
  • Deploy branch : la branche qui publie sur votre site de documentation de production, par exemple main.
5

Configurer un répertoire de contenu (facultatif)

  1. Si votre fichier docs.json se trouve dans un sous-répertoire, activez docs.json is in a subdirectory.
  2. Saisissez le chemin du répertoire qui contient votre fichier docs.json. Par exemple, si votre docs.json se trouve dans le répertoire apps/docs/, saisissez apps/docs.
6

Connecter le dépôt

  1. Cliquez sur Connect.
  2. Confirmez la modification.
Mintlify vérifie que votre compte Microsoft peut gérer le dépôt et que la branche de déploiement existe. Mintlify enregistre ensuite les service hooks qui maintiennent votre site et l’éditeur web synchronisés, puis lance votre premier déploiement.
Pour vérifier les service hooks, ouvrez votre projet Azure DevOps et accédez à Project settings > Service hooks. Mintlify crée trois abonnements Web Hooks pour le dépôt : Code pushed, Pull request created et Pull request updated.

​
Basculer un déploiement existant vers Azure Repos

  1. Sur la page Git Settings, sélectionnez Azure Repos comme fournisseur Git.
  2. Si vous n’avez pas connecté de compte Microsoft, cliquez sur Connect Microsoft et connectez-vous.
  3. Sélectionnez l’organisation, le projet, le dépôt et la branche de déploiement, puis saisissez un répertoire de contenu si nécessaire.
  4. Cliquez sur Switch to Azure Repos.

​
Changer le compte Microsoft connecté

Toute votre organisation Mintlify partage le compte Microsoft défini dans Git Settings, et seuls les administrateurs peuvent le modifier. Mintlify actualise automatiquement les identifiants Microsoft, vous n’avez donc pas besoin de renouveler les jetons. Pour utiliser un autre compte, ouvrez la section Microsoft connection sur la page Git Settings et cliquez sur Change account. Le nouveau compte doit être administrateur du projet ou disposer de Manage permissions sur le dépôt.

​
Modifier dans l’éditeur web

Vous pouvez modifier le contenu Azure Repos dans l’éditeur web. Lorsque vous publiez, Mintlify pousse une branche vers Azure Repos et ouvre une pull request vers votre branche de déploiement.
  • Les branches que vous poussez vers Azure Repos sont synchronisées dans l’éditeur.
  • Les modifications apportées aux pull requests dans Azure Repos sont synchronisées dans la branche correspondante de l’éditeur.
  • Lorsque vous supprimez une branche dans Azure Repos, Mintlify la retire de l’éditeur.
  • Si votre branche de déploiement est soumise à des stratégies de branche bloquantes, comme des relecteurs obligatoires, publiez via une pull request.

​
Déploiements de prévisualisation

Lorsque vous ouvrez une pull request vers votre branche de déploiement, Mintlify génère un déploiement de prévisualisation et y renvoie depuis un statut Mintlify preview ready sur la pull request. Mintlify régénère la prévisualisation lorsque vous poussez sur la branche de la pull request, et la supprime lorsque vous terminez ou abandonnez la pull request ou supprimez la branche.

​
Utiliser Autopilot

Autopilot fonctionne avec Azure Repos. Il s’exécute lorsque du code est fusionné dans les dépôts connectés et ouvre des pull requests dans votre dépôt Azure Repos. Acceptez ou fermez ses pull requests sur la page Autopilot, ou fusionnez-les dans Azure Repos. Pour donner plus de contexte à Autopilot, connectez vos dépôts de code source dans Git Settings, puis sélectionnez-les dans la ligne Azure Repos de la page Autopilot. Consultez Dépôts Azure Repos. Sur Azure Repos, Autopilot n’assigne pas les pull requests, ne demande pas de relectures et ne répond pas aux commentaires des pull requests. Pour demander des modifications, envoyez un message dans la suggestion sur la page Autopilot.

​
Utiliser l’agent dans Slack

L’agent dans Slack fonctionne avec Azure Repos. Lorsque vous lui demandez de mettre à jour votre contenu, il ouvre une pull request dans votre dépôt Azure Repos.

​
Dépannage

Demandez à un administrateur Entra de votre tenant d’accorder son consentement à l’application Mintlify, puis connectez à nouveau le dépôt.
Mintlify ne prend en charge que les organisations Azure DevOps adossées à Microsoft Entra ID. Connectez votre organisation à votre tenant Entra dans Azure DevOps sous Organization settings > Microsoft Entra, puis réessayez.
L’application Mintlify ne peut pas lire le dépôt. Ajoutez l’application Mintlify à votre organisation Azure DevOps avec un accès Basic, puis ajoutez-la au projet qui contient le dépôt.
Mintlify doit créer des service hooks pour déployer automatiquement vos modifications. Ajoutez l’application Mintlify au groupe Project Administrators du projet, puis connectez à nouveau le dépôt.
Le compte Microsoft connecté dans Git Settings ne peut pas lire le dépôt. Cliquez sur Change account et connectez-vous avec un compte qui y a accès. Les utilisateurs disposant d’un accès Stakeholder ne peuvent pas lire les dépôts des projets privés.
Le compte Microsoft connecté dans Git Settings peut lire le dépôt, mais pas le gérer. Cliquez sur Change account et connectez-vous avec un compte membre du groupe Project Administrators du projet ou disposant de Manage permissions sur le dépôt.
Vérifiez que la branche existe dans le dépôt et que son nom correspond exactement.
Dans Azure DevOps, accédez à Project settings > Service hooks et ouvrez les abonnements Mintlify pour consulter leur historique de livraison. Vérifiez que vous avez poussé sur la branche de déploiement configurée dans Mintlify.Si un abonnement est désactivé ou manquant, cliquez sur Save dans Git Settings. Mintlify remplace tout abonnement qui n’est pas en bon état.
Mintlify ne supprime pas les service hooks lorsque vous passez à un autre fournisseur Git. Supprimez-les dans Project settings > Service hooks.