Saltar al contenido principal
Azure Repos requiere un plan Enterprise.
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 por primera vez, un asistente de configuración te guía para conectar tu repositorio.
1

Selecciona Azure Repos como tu proveedor

  1. En la página Git Settings, haz clic en Connect to Azure Repos.
  2. Haz clic en Continue.
2

Mueve el contenido alojado en Mintlify

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.
3

Conecta Microsoft

  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.
4

Selecciona el repositorio

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.
5

Configura un directorio de contenido (opcional)

  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.
6

Conecta el repositorio

  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, 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 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. 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 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 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. 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 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. 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.