Skip to main content
Bitbucket Cloud requiere un plan Enterprise.
Mintlify se conecta a Bitbucket Cloud mediante OAuth. Después de conectar un repositorio, Mintlify despliega automáticamente los cambios enviados a tu rama de despliegue y crea despliegues de vista previa para las pull requests. Mintlify admite repositorios de Bitbucket Cloud alojados en bitbucket.org. Bitbucket Data Center, el agente de Slack y las automatizaciones no son compatibles con los repositorios de Bitbucket.

​
Requisitos

  • Una cuenta de Bitbucket Cloud
  • Permiso para crear un webhook 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 Bitbucket

Cuando abres Git Settings por primera vez, un asistente de configuración te guía en la conexión de tu repositorio de Bitbucket.
1

Selecciona Bitbucket como tu proveedor

  1. En la página de Git Settings, selecciona Connect to Bitbucket.
  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 un archivo zip. Extrae el contenido del zip y súbelo a tu repositorio de Bitbucket.Si tu contenido ya está en Bitbucket, haz clic en Continue setup.
3

Autoriza Bitbucket

  1. Haz clic en Connect Bitbucket.
  2. Bitbucket abre una nueva página para autorizar a Mintlify a acceder a tu cuenta de Bitbucket. Autoriza a Mintlify a acceder al repositorio que quieres conectar.
Después de la autorización, Bitbucket te redirige a la configuración de Git de Mintlify.
4

Configura el repositorio

Introduce los siguientes valores:
  • Workspace: El slug del workspace de Bitbucket que posee el repositorio. Por ejemplo, en https://bitbucket.org/acme/docs, acme es el slug del workspace.
  • Repository: El slug del repositorio. Por ejemplo, en https://bitbucket.org/acme/docs, docs es el slug del repositorio.
  • Deploy branch: La rama que se publica en tu sitio de documentación en producción, como main.
5

Configura un directorio de contenido (opcional)

  1. Si tu archivo docs.json está en un subdirectorio, activa Docs are in a subdirectory en tu página de configuración de Git.
  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 la cuenta de Bitbucket autorizada pueda acceder a tu repositorio y registra el webhook que activa los despliegues y las vistas previas de pull requests.

​
Actualizar una conexión existente

  1. Navega a la página de Git Settings de tu dashboard de Mintlify.
  2. Expande la sección Bitbucket OAuth.
  3. Activa o desactiva repositorios individuales. Desactivar un repositorio elimina su webhook de Mintlify.
Revocar una conexión elimina los webhooks de Mintlify de todos los repositorios conectados a través de esa cuenta.

​
Configurar varios repositorios

Puedes combinar contenido de varios repositorios de Bitbucket en un solo sitio. Todas las fuentes del despliegue deben usar Bitbucket, y debes activar cada repositorio en Bitbucket OAuth antes de añadirlo como fuente. Consulta Despliegues multirrepositorio para ver las instrucciones de configuración e información sobre rutas URL, fuentes base y navegación.

​
Solución de problemas

Si Mintlify informa de que ninguna instalación conectada puede acceder a tu repositorio, comprueba lo siguiente:
  • Los valores de workspace y repository usan los slugs correctos, no los nombres visibles.
  • La cuenta de Bitbucket conectada tiene los permisos necesarios para acceder al repositorio.
  • Has activado el repositorio en la sección Bitbucket OAuth de la configuración de Git de Mintlify.
Si el repositorio no aparece, vuelve a conectar tu cuenta de Bitbucket con una cuenta que tenga acceso al repositorio.
En Bitbucket, abre Repository settings > Webhooks y verifica que exista un webhook activo llamado Mintlify. Si falta, vuelve a la configuración de Git de Mintlify, desactiva el repositorio en Bitbucket OAuth y actívalo de nuevo.Verifica que la rama en la configuración de Git de Mintlify coincida con la rama de Bitbucket a la que envías los cambios.
Verifica que el webhook de Mintlify esté activo e incluya los eventos de pull request. Si tus permisos de Bitbucket cambiaron después de conectar el repositorio, vuelve a conectar tu cuenta de Bitbucket y activa el repositorio de nuevo.

Temas relacionados

¿Qué es Mintlify?Crear documentación para desarrolladoresConceptos de Git para la documentación