From 0d4307fe340ffd748f8d22a33c23386be08aea0f Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Fri, 30 Oct 2026 22:36:45 +0000 Subject: [PATCH] docs: translate Azure Repos guide and Autopilot updates to es, fr, zh --- es.json | 1 + es/autopilot.mdx | 27 ++++++- es/deploy/azure-repos.mdx | 156 ++++++++++++++++++++++++++++++++++++++ fr.json | 1 + fr/autopilot.mdx | 27 ++++++- fr/deploy/azure-repos.mdx | 156 ++++++++++++++++++++++++++++++++++++++ zh.json | 1 + zh/autopilot.mdx | 27 ++++++- zh/deploy/azure-repos.mdx | 156 ++++++++++++++++++++++++++++++++++++++ 9 files changed, 540 insertions(+), 12 deletions(-) create mode 100644 es/deploy/azure-repos.mdx create mode 100644 fr/deploy/azure-repos.mdx create mode 100644 zh/deploy/azure-repos.mdx diff --git a/es.json b/es.json index e6f690368..49cb181d9 100644 --- a/es.json +++ b/es.json @@ -190,6 +190,7 @@ "es/deploy/ghes", "es/deploy/gitlab", "es/deploy/bitbucket", + "es/deploy/azure-repos", "es/deploy/rollbacks" ] }, diff --git a/es/autopilot.mdx b/es/autopilot.mdx index 593ac9c71..a24294b95 100644 --- a/es/autopilot.mdx +++ b/es/autopilot.mdx @@ -24,9 +24,10 @@ Para cambiar en qué trabaja Autopilot y cuándo se ejecuta, [chatea con Autopil ## Requisitos previos -- Un proyecto de Mintlify conectado a un repositorio de GitHub o GitLab. Autopilot admite gitlab.com e instancias de [GitLab autoalojado](/es/deploy/gitlab-self-hosted). +- Un proyecto de Mintlify conectado a un repositorio de GitHub, GitLab o Azure Repos. Autopilot admite gitlab.com e instancias de [GitLab autoalojado](/es/deploy/gitlab-self-hosted). - Para GitHub: la [GitHub App de Mintlify](/es/deploy/github) instalada en tu repositorio de documentación y en cualquier repositorio de código fuente que quieras que use Autopilot. - Para GitLab: tu repositorio de documentación y cualquier repositorio de código fuente que quieras que use Autopilot conectados en la sección **GitLab OAuth** de tu [configuración de Git](https://app.mintlify.com/settings/project/git-settings). En GitLab, Autopilot abre merge requests en lugar de pull requests. +- Para Azure Repos: tu repositorio de documentación y cualquier repositorio de código fuente que quieras que use Autopilot conectados en tu [configuración de Git](https://app.mintlify.com/settings/project/git-settings). Consulta [Azure Repos](/es/deploy/azure-repos).
## Habilitar Autopilot @@ -77,6 +78,22 @@ Tu proyecto de documentación siempre se incluye como contexto obligatorio para La lista **Additional projects** solo muestra los proyectos de GitLab conectados mediante GitLab OAuth. Para añadir un proyecto que no aparece en la lista, haz clic en **Add GitLab projects** al final de la lista para abrir tu configuración de Git y conectarlo. +
+ ### Repositorios de Azure Repos +
+ +Si tu repositorio de documentación está en [Azure Repos](/es/deploy/azure-repos), la sección **Integrations** muestra una fila **Azure Repos** en lugar de una fila **GitHub**. + +Para elegir los repositorios que Autopilot usa como contexto: + +1. Haz clic en **Configure** en la fila **Azure Repos**. +2. En **Additional repositories**, selecciona los repositorios de código fuente que quieres que use Autopilot. +3. Haz clic en **Save**. + +Tu repositorio de documentación siempre se incluye como contexto obligatorio para Autopilot, por lo que no puedes quitarlo. + +La lista **Additional repositories** solo muestra los repositorios de Azure Repos conectados a tu organización de Mintlify. Para añadir un repositorio que no aparece en la lista, haz clic en **Add Azure DevOps repositories** al final de la lista para abrir tu configuración de Git y conectarlo. +
### Slack y otras integraciones
@@ -95,7 +112,7 @@ Autopilot también puede ejecutarse cuando ocurre un evento en una integración Autopilot normalmente confirma sus cambios en una nueva rama y abre una pull request. Nunca hace push directamente a tu rama de despliegue ni a la rama predeterminada del repositorio. -Autopilot crea sus commits a través de la API de GitHub, por lo que GitHub los firma y los muestra como **Verified**. Los commits de Autopilot funcionan con las reglas de protección de ramas que requieren commits firmados. +En GitHub, Autopilot crea sus commits a través de la API de GitHub, por lo que GitHub los firma y los muestra como **Verified**. Los commits de Autopilot funcionan con las reglas de protección de ramas que requieren commits firmados. De forma predeterminada, las pull requests apuntan a tu rama de despliegue. Si tu equipo fusiona los cambios en una rama distinta de la que despliega tu sitio, díselo a Autopilot en un chat y apuntará a esa rama en su lugar. @@ -113,6 +130,8 @@ Si tu equipo ya escribe la documentación del lanzamiento en su propia rama, Aut De forma predeterminada, Autopilot asigna cada pull request al compañero de equipo que identifica como responsable del código que cambió, solicita su revisión y le notifica sobre la pull request. Para solicitar revisiones a más personas, cambiar quién revisa los cambios o cambiar cómo Autopilot notifica a alguien, díselo a Autopilot en un chat. +Autopilot no asigna las pull requests de Azure Repos ni solicita revisiones en ellas. + Si [conectas Slack](#slack-and-other-integrations) y Autopilot puede asociar al revisor con una cuenta de Slack, le envía un mensaje directo en Slack. De lo contrario, le envía un correo electrónico. Cuando Autopilot abre la primera pull request de un lanzamiento de funcionalidad, envía un correo electrónico a los responsables del lanzamiento en el que indica si la pull request es un borrador, qué ocurre a continuación y los canales, proyectos, especificaciones y pull requests de código relacionados que está siguiendo. @@ -141,9 +160,9 @@ Cuando Autopilot toma un comentario o un comentario de revisión en línea, reac Autopilot solo responde a comentarios de personas que son propietarias del repositorio, pertenecen a la organización de GitHub propietaria del repositorio, son colaboradoras en él o tienen acceso de escritura a él. Ignora los comentarios de bots y los comentarios dirigidos a otra persona, como una pregunta que @menciona a un compañero de equipo. -Autopilot no responde a comentarios en merge requests de GitLab. Para pedir cambios en una merge request, envía un mensaje en su sugerencia en la página de Autopilot. +Autopilot no responde a comentarios en merge requests de GitLab ni en pull requests de Azure Repos. Para pedir cambios, envía un mensaje en la sugerencia en la página de Autopilot. -Si una pull request tiene conflictos de fusión o tus reglas de protección de ramas bloquean la fusión, resuélvelo en GitHub. +Si una pull request tiene conflictos de fusión o tus reglas de protección de ramas bloquean la fusión, resuélvelo en tu proveedor de Git.
## Chatear con Autopilot diff --git a/es/deploy/azure-repos.mdx b/es/deploy/azure-repos.mdx new file mode 100644 index 000000000..de7dd0912 --- /dev/null +++ b/es/deploy/azure-repos.mdx @@ -0,0 +1,156 @@ +--- +title: "Azure Repos" +description: "Conecta un repositorio de Azure Repos a Mintlify con Microsoft Entra ID para despliegues automáticos, vistas previas de pull requests, publicación desde el editor web y Autopilot." +keywords: ["Azure DevOps", "Microsoft Entra ID", "service hooks", "despliegues automatizados"] +--- + + + Azure Repos requiere un [plan Enterprise](https://mintlify.com/pricing?ref=azure-repos). + + +Mintlify se conecta a Azure Repos mediante Microsoft Entra ID. Inicias sesión con tu cuenta de Microsoft para que Mintlify pueda verificar a qué organizaciones, proyectos y repositorios tienes acceso. Después, Mintlify usa la app de Mintlify en tu tenant de Entra para leer tu repositorio, crear service hooks, desplegar cada cambio enviado a tu rama de despliegue y crear despliegues de vista previa para las pull requests. + +Mintlify admite organizaciones de Azure DevOps Services en `dev.azure.com` conectadas a Microsoft Entra ID, incluidas las organizaciones que todavía usan URL `*.visualstudio.com`. Mintlify no admite Azure DevOps Server. + +
+ ## Requisitos +
+ +- Una organización de Azure DevOps conectada a Microsoft Entra ID. +- Un administrador de Entra que conceda consentimiento a la app de Mintlify en tu tenant. +- La app de Mintlify añadida a tu organización de Azure DevOps con acceso **Basic** y al proyecto que contiene tu repositorio. +- La app de Mintlify en el grupo **Project Administrators** del proyecto. Azure DevOps solo permite a los administradores de proyecto crear service hooks. +- Una cuenta de Microsoft que sea administradora del proyecto o que tenga **Manage permissions** en el repositorio que quieres conectar. +- Acceso de administrador a tu organización de Mintlify. +- Un archivo `docs.json` en tu repositorio. + +
+ ## Configurar una nueva conexión con Azure Repos +
+ +Cuando abres [Git Settings](https://app.mintlify.com/settings/project/git-settings) por primera vez, un asistente de configuración te guía para conectar tu repositorio. + + + + 1. En la página [Git Settings](https://app.mintlify.com/settings/project/git-settings), haz clic en **Connect to Azure Repos**. + 2. Haz clic en **Continue**. + + + Si actualmente alojas tu contenido en un repositorio gestionado por Mintlify, descárgalo como archivo zip. Extrae el contenido del zip y envía los archivos a tu repositorio de Azure Repos. + + Si tu contenido ya está en Azure Repos, haz clic en **Continue setup**. + + + 1. Haz clic en **Connect Microsoft**. + 2. Inicia sesión con una cuenta de Microsoft que sea administradora del proyecto o que tenga **Manage permissions** en el repositorio que quieres conectar. + + Después de iniciar sesión, Microsoft te redirige a tu configuración de Git de Mintlify. + + + Selecciona los siguientes valores. Cada lista muestra los recursos a los que tiene acceso tu cuenta de Microsoft. + + - **Organization**: la organización de Azure DevOps. Por ejemplo, en `https://dev.azure.com/acme/docs-project/_git/docs`, `acme` es la organización. + - **Project**: el proyecto que contiene el repositorio, como `docs-project`. + - **Repository**: el nombre del repositorio, como `docs`. + - **Deploy branch**: la rama que publica en tu sitio de documentación de producción, como `main`. + + + 1. Si tu archivo `docs.json` está en un subdirectorio, activa **docs.json is in a subdirectory**. + 2. Introduce la ruta al directorio que contiene tu archivo `docs.json`. Por ejemplo, si tu `docs.json` está en el directorio `apps/docs/`, introduce `apps/docs`. + + + 1. Haz clic en **Connect**. + 2. Confirma el cambio. + + Mintlify verifica que tu cuenta de Microsoft puede administrar el repositorio y que la rama de despliegue existe. Después, Mintlify registra los service hooks que mantienen sincronizados tu sitio y el editor web, e inicia tu primer despliegue. + + + +Para confirmar los service hooks, abre tu proyecto de Azure DevOps y ve a **Project settings** > **Service hooks**. Mintlify crea tres suscripciones **Web Hooks** para el repositorio: **Code pushed**, **Pull request created** y **Pull request updated**. + +
+ ## Cambiar un despliegue existente a Azure Repos +
+ +1. En la página [Git Settings](https://app.mintlify.com/settings/project/git-settings), selecciona **Azure Repos** como proveedor de Git. +2. Si no has conectado una cuenta de Microsoft, haz clic en **Connect Microsoft** e inicia sesión. +3. Selecciona la organización, el proyecto, el repositorio y la rama de despliegue, e introduce un directorio de contenido si es necesario. +4. Haz clic en **Switch to Azure Repos**. + +
+ ## Cambiar la cuenta de Microsoft conectada +
+ +Toda tu organización de Mintlify comparte la cuenta de Microsoft de Git Settings, y solo los administradores pueden cambiarla. Mintlify actualiza las credenciales de Microsoft automáticamente, por lo que no necesitas rotar tokens. + +Para usar otra cuenta, abre la sección **Microsoft connection** en la página [Git Settings](https://app.mintlify.com/settings/project/git-settings) y haz clic en **Change account**. La nueva cuenta debe ser administradora del proyecto o tener **Manage permissions** en el repositorio. + +
+ ## Editar en el editor web +
+ +Puedes editar el contenido de Azure Repos en el [editor web](/es/editor). Cuando publicas, Mintlify envía una rama a Azure Repos y abre una pull request contra tu rama de despliegue. + +- Las ramas que envías a Azure Repos se sincronizan con el editor. +- Los cambios en las pull requests de Azure Repos se sincronizan con la rama correspondiente del editor. +- Cuando eliminas una rama en Azure Repos, Mintlify la quita del editor. +- Si tu rama de despliegue tiene directivas de rama bloqueantes, como revisores obligatorios, publica mediante una pull request. + +
+ ## Despliegues de vista previa +
+ +Cuando abres una pull request contra tu rama de despliegue, Mintlify compila un [despliegue de vista previa](/es/deploy/preview-deployments) y lo enlaza desde un estado **Mintlify preview ready** en la pull request. Mintlify vuelve a compilar la vista previa cuando envías cambios a la rama de la pull request y la elimina cuando completas o abandonas la pull request o eliminas la rama. + +
+ ## Usar Autopilot +
+ +[Autopilot](/es/autopilot) funciona con Azure Repos. Se ejecuta cuando se fusiona código en los repositorios conectados y abre pull requests en tu repositorio de Azure Repos. Acepta o cierra sus pull requests en la página de Autopilot, o fusiónalas en Azure Repos. + +Para darle más contexto a Autopilot, conecta tus repositorios de código fuente en Git Settings y luego selecciónalos en la fila **Azure Repos** de la página de Autopilot. Consulta [Repositorios de Azure Repos](/es/autopilot#azure-repos-repositories). + +En Azure Repos, Autopilot no asigna pull requests, no solicita revisiones ni responde a comentarios en las pull requests. Para pedir cambios, envía un mensaje en la sugerencia en la página de Autopilot. + +
+ ## Usar el agente en Slack +
+ +El [agente en Slack](/es/agent/slack) funciona con Azure Repos. Cuando le pides que actualice tu contenido, abre una pull request en tu repositorio de Azure Repos. + +
+ ## Solución de problemas +
+ + + + Pide a un administrador de Entra de tu tenant que conceda consentimiento a la app de Mintlify y, después, vuelve a conectar el repositorio. + + + Mintlify solo admite organizaciones de Azure DevOps respaldadas por Microsoft Entra ID. Conecta tu organización a tu tenant de Entra en Azure DevOps, en **Organization settings** > **Microsoft Entra**, y vuelve a intentarlo. + + + La app de Mintlify no puede leer el repositorio. Añade la app de Mintlify a tu organización de Azure DevOps con acceso **Basic** y añádela al proyecto que contiene el repositorio. + + + Mintlify necesita crear service hooks para desplegar tus cambios automáticamente. Añade la app de Mintlify al grupo **Project Administrators** del proyecto y, después, vuelve a conectar el repositorio. + + + La cuenta de Microsoft conectada en Git Settings no puede leer el repositorio. Haz clic en **Change account** e inicia sesión con una cuenta que tenga acceso. Los usuarios con acceso **Stakeholder** no pueden leer repositorios en proyectos privados. + + + La cuenta de Microsoft conectada en Git Settings puede leer el repositorio, pero no administrarlo. Haz clic en **Change account** e inicia sesión con una cuenta que esté en el grupo **Project Administrators** del proyecto o que tenga **Manage permissions** en el repositorio. + + + Comprueba que la rama existe en el repositorio y que el nombre coincide exactamente. + + + En Azure DevOps, ve a **Project settings** > **Service hooks** y abre las suscripciones de Mintlify para revisar su historial de entregas. Confirma que enviaste los cambios a la rama de despliegue configurada en Mintlify. + + Si una suscripción está deshabilitada o falta, haz clic en **Save** en [Git Settings](https://app.mintlify.com/settings/project/git-settings). Mintlify reemplaza cualquier suscripción que no esté en buen estado. + + + + + Mintlify no elimina los service hooks cuando cambias a otro proveedor de Git. Elimínalos en **Project settings** > **Service hooks**. + diff --git a/fr.json b/fr.json index ff2332816..d897302f1 100644 --- a/fr.json +++ b/fr.json @@ -190,6 +190,7 @@ "fr/deploy/ghes", "fr/deploy/gitlab", "fr/deploy/bitbucket", + "fr/deploy/azure-repos", "fr/deploy/rollbacks" ] }, diff --git a/fr/autopilot.mdx b/fr/autopilot.mdx index f60fac177..894d3668d 100644 --- a/fr/autopilot.mdx +++ b/fr/autopilot.mdx @@ -24,9 +24,10 @@ Pour modifier ce sur quoi Autopilot travaille et quand il s'exécute, [discutez ## Prérequis
-- Un projet Mintlify connecté à un dépôt GitHub ou GitLab. Autopilot prend en charge gitlab.com et les instances [GitLab auto-hébergées](/fr/deploy/gitlab-self-hosted). +- Un projet Mintlify connecté à un dépôt GitHub, GitLab ou Azure Repos. Autopilot prend en charge gitlab.com et les instances [GitLab auto-hébergées](/fr/deploy/gitlab-self-hosted). - Pour GitHub : l'[application GitHub Mintlify](/fr/deploy/github) installée sur votre dépôt de documentation et sur tous les dépôts de code source que vous souhaitez qu'Autopilot utilise. - Pour GitLab : votre dépôt de documentation et tous les dépôts de code source que vous souhaitez qu'Autopilot utilise connectés dans la section **GitLab OAuth** de vos [paramètres Git](https://app.mintlify.com/settings/project/git-settings). Sur GitLab, Autopilot ouvre des merge requests au lieu de pull requests. +- Pour Azure Repos : votre dépôt de documentation et tous les dépôts de code source que vous souhaitez qu'Autopilot utilise connectés dans vos [paramètres Git](https://app.mintlify.com/settings/project/git-settings). Consultez [Azure Repos](/fr/deploy/azure-repos).
## Activer Autopilot @@ -77,6 +78,22 @@ Votre projet de documentation est toujours inclus comme contexte obligatoire pou La liste **Additional projects** n'affiche que les projets GitLab connectés via GitLab OAuth. Pour ajouter un projet qui n'apparaît pas dans la liste, cliquez sur **Add GitLab projects** en bas de la liste pour ouvrir vos paramètres Git et le connecter. +
+ ### Dépôts Azure Repos +
+ +Si votre dépôt de documentation est hébergé sur [Azure Repos](/fr/deploy/azure-repos), la section **Integrations** affiche une ligne **Azure Repos** au lieu d'une ligne **GitHub**. + +Pour choisir les dépôts qu'Autopilot utilise comme contexte : + +1. Cliquez sur **Configure** dans la ligne **Azure Repos**. +2. Sous **Additional repositories**, sélectionnez les dépôts de code source que vous souhaitez qu'Autopilot utilise. +3. Cliquez sur **Save**. + +Votre dépôt de documentation est toujours inclus comme contexte requis pour Autopilot, vous ne pouvez donc pas le retirer. + +La liste **Additional repositories** n'affiche que les dépôts Azure Repos connectés à votre organisation Mintlify. Pour ajouter un dépôt qui n'apparaît pas dans la liste, cliquez sur **Add Azure DevOps repositories** en bas de la liste pour ouvrir vos paramètres Git et le connecter. +
### Slack et autres intégrations
@@ -95,7 +112,7 @@ Autopilot peut également s'exécuter lorsqu'un événement se produit dans une Autopilot commite généralement ses modifications sur une nouvelle branche et ouvre une pull request. Il ne pousse jamais directement sur votre branche de déploiement ni sur la branche par défaut du dépôt. -Autopilot crée ses commits via l'API GitHub, de sorte que GitHub les signe et les affiche comme **Verified**. Les commits d'Autopilot fonctionnent avec les règles de protection de branche qui exigent des commits signés. +Sur GitHub, Autopilot crée ses commits via l'API GitHub, de sorte que GitHub les signe et les affiche comme **Verified**. Les commits d'Autopilot fonctionnent avec les règles de protection de branche qui exigent des commits signés. Par défaut, les pull requests ciblent votre branche de déploiement. Si votre équipe fusionne les modifications dans une branche différente de celle à partir de laquelle votre site est déployé, indiquez-le à Autopilot dans un chat, et il ciblera cette branche à la place. @@ -113,6 +130,8 @@ Si votre équipe rédige déjà la documentation du lancement sur sa propre bran Par défaut, Autopilot assigne chaque pull request au membre de l'équipe qu'il identifie comme responsable du code modifié, demande sa relecture et le notifie au sujet de la pull request. Pour demander des relectures à d'autres personnes, changer qui relit les modifications ou changer la façon dont Autopilot notifie quelqu'un, indiquez-le à Autopilot dans un chat. +Autopilot n'assigne pas les pull requests Azure Repos et n'y demande pas de relectures. + Si vous [connectez Slack](#slack-and-other-integrations) et qu'Autopilot parvient à associer le relecteur à un compte Slack, il lui envoie un message direct dans Slack. Sinon, il lui envoie un e-mail. Lorsqu'Autopilot ouvre la première pull request d'un lancement de fonctionnalité, il envoie un e-mail aux responsables du lancement en précisant si la pull request est un brouillon, ce qui va se passer ensuite, ainsi que les canaux, projets, spécifications et pull requests de code associés qu'il suit. @@ -141,9 +160,9 @@ Lorsqu'Autopilot prend en charge un commentaire ou un commentaire de revue en li Autopilot ne répond qu'aux commentaires des personnes qui possèdent le dépôt, appartiennent à l'organisation GitHub propriétaire du dépôt, en sont collaboratrices ou disposent d'un accès en écriture. Il ignore les commentaires des bots et les commentaires adressés à quelqu'un d'autre, comme une question qui @mentionne un coéquipier. -Autopilot ne répond pas aux commentaires sur les merge requests GitLab. Pour demander des modifications sur une merge request, envoyez un message dans sa suggestion sur la page Autopilot. +Autopilot ne répond pas aux commentaires sur les merge requests GitLab ni sur les pull requests Azure Repos. Pour demander des modifications, envoyez un message dans la suggestion sur la page Autopilot. -Si une pull request présente des conflits de fusion ou si vos règles de protection de branche bloquent la fusion, résolvez-la sur GitHub. +Si une pull request présente des conflits de fusion ou si vos règles de protection de branche bloquent la fusion, résolvez-la dans votre fournisseur Git.
## Discuter avec Autopilot diff --git a/fr/deploy/azure-repos.mdx b/fr/deploy/azure-repos.mdx new file mode 100644 index 000000000..512b2244e --- /dev/null +++ b/fr/deploy/azure-repos.mdx @@ -0,0 +1,156 @@ +--- +title: "Azure Repos" +description: "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." +keywords: ["Azure DevOps", "Microsoft Entra ID", "service hooks", "déploiements automatisés"] +--- + + + 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. Sur la page [Git Settings](https://app.mintlify.com/settings/project/git-settings), cliquez sur **Connect to Azure Repos**. + 2. Cliquez sur **Continue**. + + + 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**. + + + 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. + + + 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`. + + + 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`. + + + 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](/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](/fr/deploy/preview-deployments) 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](/fr/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](/fr/autopilot#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](/fr/agent/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](https://app.mintlify.com/settings/project/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**. + diff --git a/zh.json b/zh.json index 390553494..85b290d1b 100644 --- a/zh.json +++ b/zh.json @@ -190,6 +190,7 @@ "zh/deploy/ghes", "zh/deploy/gitlab", "zh/deploy/bitbucket", + "zh/deploy/azure-repos", "zh/deploy/rollbacks" ] }, diff --git a/zh/autopilot.mdx b/zh/autopilot.mdx index bebada375..f2779c0d3 100644 --- a/zh/autopilot.mdx +++ b/zh/autopilot.mdx @@ -24,9 +24,10 @@ Autopilot 与[自动化](/zh/automations)相互独立。自动化会在你配置 ## 前提条件
-- 一个已连接到 GitHub 或 GitLab 仓库的 Mintlify 项目。Autopilot 支持 gitlab.com 和[自托管 GitLab](/zh/deploy/gitlab-self-hosted) 实例。 +- 一个已连接到 GitHub、GitLab 或 Azure Repos 仓库的 Mintlify 项目。Autopilot 支持 gitlab.com 和[自托管 GitLab](/zh/deploy/gitlab-self-hosted) 实例。 - 对于 GitHub：在你的文档仓库以及希望 Autopilot 使用的所有源代码仓库上安装 [Mintlify GitHub App](/zh/deploy/github)。 - 对于 GitLab：在 [Git 设置](https://app.mintlify.com/settings/project/git-settings)的 **GitLab OAuth** 部分中连接你的文档仓库以及希望 Autopilot 使用的所有源代码仓库。在 GitLab 上，Autopilot 会创建 merge request，而不是 pull request。 +- 对于 Azure Repos：在 [Git 设置](https://app.mintlify.com/settings/project/git-settings)中连接你的文档仓库以及希望 Autopilot 使用的所有源代码仓库。请参阅 [Azure Repos](/zh/deploy/azure-repos)。
## 启用 Autopilot @@ -77,6 +78,22 @@ Autopilot 页面的 **Integrations** 部分列出了 Autopilot 读取的来源 **Additional projects** 列表仅显示通过 GitLab OAuth 连接的 GitLab 项目。要添加未列出的项目，请点击列表底部的 **Add GitLab projects**，打开 Git 设置并连接该项目。 +
+ ### Azure Repos 仓库 +
+ +如果你的文档仓库位于 [Azure Repos](/zh/deploy/azure-repos) 上，**Integrations** 部分会显示 **Azure Repos** 行，而不是 **GitHub** 行。 + +要选择 Autopilot 用作上下文的仓库： + +1. 点击 **Azure Repos** 行中的 **Configure**。 +2. 在 **Additional repositories** 下，选择希望 Autopilot 使用的源代码仓库。 +3. 点击 **Save**。 + +你的文档仓库始终作为 Autopilot 的必需上下文包含在内，因此无法将其移除。 + +**Additional repositories** 列表仅显示已连接到你的 Mintlify 组织的 Azure Repos 仓库。要添加未列出的仓库，请点击列表底部的 **Add Azure DevOps repositories**，打开 Git 设置并连接该仓库。 +
### Slack 和其他集成
@@ -95,7 +112,7 @@ Autopilot 页面的 **Integrations** 部分列出了 Autopilot 读取的来源 Autopilot 通常会将更改提交到一个新分支并打开 pull request。它从不直接推送到你的部署分支或仓库的默认分支。 -Autopilot 通过 GitHub API 创建其提交，因此 GitHub 会对这些提交进行签名并将其显示为 **Verified**。Autopilot 的提交可与要求签名提交的分支保护规则配合使用。 +在 GitHub 上，Autopilot 通过 GitHub API 创建其提交，因此 GitHub 会对这些提交进行签名并将其显示为 **Verified**。Autopilot 的提交可与要求签名提交的分支保护规则配合使用。 默认情况下，pull request 以你的部署分支为目标。如果你的团队将更改合并到与站点部署分支不同的分支，请在聊天中告诉 Autopilot，它就会改为以该分支为目标。 @@ -113,6 +130,8 @@ Autopilot 通过 GitHub API 创建其提交，因此 GitHub 会对这些提交 默认情况下，Autopilot 会将每个 pull request 分配给它识别为变更代码负责人的团队成员，请求其审阅，并就该 pull request 通知其本人。要请求更多人审阅、更改审阅者，或更改 Autopilot 通知某人的方式，请在聊天中告诉 Autopilot。 +Autopilot 不会为 Azure Repos pull request 分配负责人，也不会在其上请求审阅。 + 如果你[连接了 Slack](#slack-and-other-integrations)，且 Autopilot 能将审阅者匹配到某个 Slack 账号，它会在 Slack 中向其发送私信。否则，它会发送电子邮件。 当 Autopilot 为某个功能发布打开第一个 pull request 时，它会向该发布的负责人发送电子邮件，说明该 pull request 是否为草稿、接下来会发生什么，以及它正在跟踪的相关频道、项目、规格说明和代码 pull request。 @@ -141,9 +160,9 @@ Autopilot 的 pull request 会显示在控制台 [Autopilot](https://app.mintlif Autopilot 只回复以下人员的评论：仓库所有者、拥有该仓库的 GitHub 组织的成员、仓库协作者，或对仓库拥有写入权限的人员。它会忽略来自机器人的评论以及针对其他人的评论，例如 @提及某位队友的问题。 -Autopilot 不会回复 GitLab merge request 上的评论。要请求修改 merge request，请在 Autopilot 页面上该 merge request 对应的建议中发送消息。 +Autopilot 不会回复 GitLab merge request 或 Azure Repos pull request 上的评论。要请求修改，请在 Autopilot 页面上对应的建议中发送消息。 -如果 pull request 存在合并冲突，或你的分支保护规则阻止了合并，请在 GitHub 上解决。 +如果 pull request 存在合并冲突，或你的分支保护规则阻止了合并，请在你的 Git 提供商中解决。
## 与 Autopilot 聊天 diff --git a/zh/deploy/azure-repos.mdx b/zh/deploy/azure-repos.mdx new file mode 100644 index 000000000..602e3a109 --- /dev/null +++ b/zh/deploy/azure-repos.mdx @@ -0,0 +1,156 @@ +--- +title: "Azure Repos" +description: "通过 Microsoft Entra ID 将 Azure Repos 仓库连接到 Mintlify，实现自动部署、pull request 预览、Web 编辑器发布和 Autopilot。" +keywords: ["Azure DevOps", "Microsoft Entra ID", "service hooks", "自动化部署"] +--- + + + Azure Repos 需要 [Enterprise 套餐](https://mintlify.com/pricing?ref=azure-repos)。 + + +Mintlify 通过 Microsoft Entra ID 连接到 Azure Repos。你使用 Microsoft 账号登录，以便 Mintlify 验证你可以访问哪些组织、项目和仓库。随后，Mintlify 使用你 Entra 租户中的 Mintlify 应用读取你的仓库、创建 service hooks、部署推送到部署分支的每一项更改，并为 pull request 创建预览部署。 + +Mintlify 支持位于 `dev.azure.com` 且已连接到 Microsoft Entra ID 的 Azure DevOps Services 组织，包括仍在使用 `*.visualstudio.com` URL 的组织。Mintlify 不支持 Azure DevOps Server。 + +
+ ## 要求 +
+ +- 一个已连接到 Microsoft Entra ID 的 Azure DevOps 组织。 +- 一位在你的租户中向 Mintlify 应用授予同意的 Entra 管理员。 +- 已以 **Basic** 访问级别将 Mintlify 应用添加到你的 Azure DevOps 组织，并添加到包含你仓库的项目中。 +- Mintlify 应用位于该项目的 **Project Administrators** 组中。Azure DevOps 只允许项目管理员创建 service hooks。 +- 一个是项目管理员或对要连接的仓库拥有 **Manage permissions** 的 Microsoft 账号。 +- 你的 Mintlify 组织的管理员权限。 +- 仓库中的 `docs.json` 文件。 + +
+ ## 设置新的 Azure Repos 连接 +
+ +首次打开 [Git Settings](https://app.mintlify.com/settings/project/git-settings) 时，设置向导会引导你连接仓库。 + + + + 1. 在 [Git Settings](https://app.mintlify.com/settings/project/git-settings) 页面上，点击 **Connect to Azure Repos**。 + 2. 点击 **Continue**。 + + + 如果你当前将内容托管在 Mintlify 管理的仓库中，请将其下载为 zip 文件。解压 zip 内容，并将文件推送到你的 Azure Repos 仓库。 + + 如果你的内容已在 Azure Repos 中，请点击 **Continue setup**。 + + + 1. 点击 **Connect Microsoft**。 + 2. 使用一个是项目管理员或对要连接的仓库拥有 **Manage permissions** 的 Microsoft 账号登录。 + + 登录后，Microsoft 会将你重定向到 Mintlify 的 Git 设置。 + + + 选择以下值。每个列表都会显示你的 Microsoft 账号可以访问的资源。 + + - **Organization**：Azure DevOps 组织。例如，在 `https://dev.azure.com/acme/docs-project/_git/docs` 中，`acme` 是组织。 + - **Project**：包含该仓库的项目，例如 `docs-project`。 + - **Repository**：仓库名称，例如 `docs`。 + - **Deploy branch**：发布到生产文档站点的分支，例如 `main`。 + + + 1. 如果你的 `docs.json` 文件位于子目录中，请启用 **docs.json is in a subdirectory**。 + 2. 输入包含 `docs.json` 文件的目录路径。例如，如果你的 `docs.json` 位于 `apps/docs/` 目录中，请输入 `apps/docs`。 + + + 1. 点击 **Connect**。 + 2. 确认更改。 + + Mintlify 会验证你的 Microsoft 账号能否管理该仓库，以及部署分支是否存在。随后，Mintlify 会注册用于保持站点和 Web 编辑器同步的 service hooks，并启动首次部署。 + + + +要确认 service hooks，请打开你的 Azure DevOps 项目并前往 **Project settings** > **Service hooks**。Mintlify 会为该仓库创建三个 **Web Hooks** 订阅：**Code pushed**、**Pull request created** 和 **Pull request updated**。 + +
+ ## 将现有部署切换到 Azure Repos +
+ +1. 在 [Git Settings](https://app.mintlify.com/settings/project/git-settings) 页面上，选择 **Azure Repos** 作为 Git 提供商。 +2. 如果尚未连接 Microsoft 账号，请点击 **Connect Microsoft** 并登录。 +3. 选择组织、项目、仓库和部署分支，并在需要时输入内容目录。 +4. 点击 **Switch to Azure Repos**。 + +
+ ## 更改已连接的 Microsoft 账号 +
+ +整个 Mintlify 组织共享 Git Settings 中的 Microsoft 账号，且只有管理员可以更改它。Mintlify 会自动刷新 Microsoft 凭据，因此你无需轮换令牌。 + +要使用其他账号，请在 [Git Settings](https://app.mintlify.com/settings/project/git-settings) 页面上打开 **Microsoft connection** 部分，然后点击 **Change account**。新账号必须是项目管理员或对该仓库拥有 **Manage permissions**。 + +
+ ## 在 Web 编辑器中编辑 +
+ +你可以在 [Web 编辑器](/zh/editor)中编辑 Azure Repos 内容。发布时，Mintlify 会将一个分支推送到 Azure Repos，并针对你的部署分支创建 pull request。 + +- 你推送到 Azure Repos 的分支会同步到编辑器中。 +- Azure Repos 中 pull request 的更改会同步到编辑器中对应的分支。 +- 当你在 Azure Repos 中删除分支时，Mintlify 会将其从编辑器中移除。 +- 如果你的部署分支设置了阻止性分支策略（例如必需的审阅者），请通过 pull request 发布。 + +
+ ## 预览部署 +
+ +当你针对部署分支创建 pull request 时，Mintlify 会构建一个[预览部署](/zh/deploy/preview-deployments)，并通过 pull request 上的 **Mintlify preview ready** 状态链接到该预览。当你向 pull request 的分支推送时，Mintlify 会重新构建预览；当你完成或放弃 pull request，或删除该分支时，Mintlify 会删除预览。 + +
+ ## 使用 Autopilot +
+ +[Autopilot](/zh/autopilot) 支持 Azure Repos。当代码合并到已连接的仓库时，它会运行并在你的 Azure Repos 仓库中创建 pull request。你可以在 Autopilot 页面上接受或关闭其 pull request，也可以在 Azure Repos 中合并它们。 + +要为 Autopilot 提供更多上下文，请在 Git Settings 中连接你的源代码仓库，然后在 Autopilot 页面的 **Azure Repos** 行中选择它们。请参阅 [Azure Repos 仓库](/zh/autopilot#azure-repos-repositories)。 + +在 Azure Repos 上，Autopilot 不会分配 pull request、请求审阅或回复 pull request 评论。要请求修改，请在 Autopilot 页面上对应的建议中发送消息。 + +
+ ## 在 Slack 中使用 agent +
+ +[Slack 中的 agent](/zh/agent/slack) 支持 Azure Repos。当你要求它更新内容时，它会在你的 Azure Repos 仓库中创建 pull request。 + +
+ ## 故障排除 +
+ + + + 请让你租户中的 Entra 管理员向 Mintlify 应用授予同意，然后重新连接仓库。 + + + Mintlify 仅支持由 Microsoft Entra ID 支持的 Azure DevOps 组织。请在 Azure DevOps 的 **Organization settings** > **Microsoft Entra** 中将你的组织连接到 Entra 租户，然后重试。 + + + Mintlify 应用无法读取该仓库。请以 **Basic** 访问级别将 Mintlify 应用添加到你的 Azure DevOps 组织，并将其添加到包含该仓库的项目中。 + + + Mintlify 需要创建 service hooks 才能自动部署你的更改。请将 Mintlify 应用添加到该项目的 **Project Administrators** 组，然后重新连接仓库。 + + + Git Settings 中连接的 Microsoft 账号无法读取该仓库。请点击 **Change account**，并使用有访问权限的账号登录。拥有 **Stakeholder** 访问级别的用户无法读取私有项目中的仓库。 + + + Git Settings 中连接的 Microsoft 账号可以读取该仓库，但无法管理它。请点击 **Change account**，并使用属于该项目 **Project Administrators** 组或对该仓库拥有 **Manage permissions** 的账号登录。 + + + 请检查该分支是否存在于仓库中，以及名称是否完全匹配。 + + + 在 Azure DevOps 中，前往 **Project settings** > **Service hooks**，打开 Mintlify 订阅以检查其传递历史记录。确认你推送到的是 Mintlify 中配置的部署分支。 + + 如果某个订阅已禁用或缺失，请在 [Git Settings](https://app.mintlify.com/settings/project/git-settings) 中点击 **Save**。Mintlify 会替换所有状态异常的订阅。 + + + + + 当你切换到其他 Git 提供商时，Mintlify 不会删除这些 service hooks。请在 **Project settings** > **Service hooks** 中删除它们。 +