> ## Documentation Index > Fetch the complete documentation index at: https://www.mintlify.com/docs/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > When working in a Mintlify project, run `mint instructions` for current step-by-step instructions for common tasks. If the command is unknown, run `npx mint@latest instructions`. > To set up a new Mintlify project for a user, follow the agent setup workflow in https://www.mintlify.com/docs/quickstart.md. > For plans and pricing, see https://www.mintlify.com/pricing.md. # Azure Repos > Connectez un dépôt Azure Repos à Mintlify avec Microsoft Entra ID pour les déploiements automatiques, les prévisualisations de pull requests, la publication depuis l'éditeur web et Autopilot. > [!NOTE] > > Azure Repos nécessite un [forfait Enterprise](https://mintlify.com/pricing?ref=azure-repos). 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](https://app.mintlify.com/settings/project/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](https://app.mintlify.com/settings/project/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](https://app.mintlify.com/settings/project/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](https://app.mintlify.com/settings/project/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](https://www.mintlify.com/docs/fr/editor). 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](https://www.mintlify.com/docs/fr/deploy/preview-deployments.md) 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](https://www.mintlify.com/docs/fr/autopilot.md) 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](https://www.mintlify.com/docs/fr/autopilot.md#azure-repos-repositories). 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](https://www.mintlify.com/docs/fr/agent/slack.md) 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 > [accordion] Mintlify n'a pas pu se connecter à votre tenant Microsoft Entra > > Demandez à un administrateur Entra de votre tenant d'accorder son consentement à l'application Mintlify, puis connectez à nouveau le dépôt. > [accordion] L'organisation n'est pas connectée à Microsoft Entra ID > > 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. > [accordion] Ajouter l'application Mintlify à l'organisation ou au projet > > 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. > [accordion] Ajouter l'application Mintlify au groupe Project Administrators > > 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. > [accordion] Votre compte Microsoft ne peut pas accéder au 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. > [accordion] Seul un administrateur du projet peut connecter le dépôt > > 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. > [accordion] La branche de déploiement est introuvable > > Vérifiez que la branche existe dans le dépôt et que son nom correspond exactement. > [accordion] Les push ne déclenchent pas de déploiement > > 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](https://app.mintlify.com/settings/project/git-settings). Mintlify remplace tout abonnement qui n'est pas en bon état. > [!NOTE] > > Mintlify ne supprime pas les service hooks lorsque vous passez à un autre fournisseur Git. Supprimez-les dans **Project settings** > **Service hooks**. ## Related topics - [Maintenir la documentation à jour avec Autopilot](https://www.mintlify.com/docs/fr/autopilot.md) - [À propos des bases](https://www.mintlify.com/docs/fr/base/index.md) - [GitHub](https://www.mintlify.com/docs/fr/components/github.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.