Bitbucket Cloud
Connectez un dépôt Bitbucket Cloud à Mintlify pour des déploiements automatisés, des prévisualisations de pull requests et une synchronisation continue.
Bitbucket Cloud nécessite un plan Enterprise.
Mintlify se connecte à Bitbucket Cloud via OAuth. Après avoir connecté un dépôt, Mintlify déploie automatiquement les modifications poussées sur votre branche de déploiement et crée des déploiements de prévisualisation pour les pull requests.
Mintlify prend en charge les dépôts Bitbucket Cloud hébergés sur bitbucket.org. Bitbucket Data Center, l’agent Slack et les automatisations ne prennent pas en charge les dépôts Bitbucket.
- Un compte Bitbucket Cloud
- L’autorisation de créer un webhook dans le dépôt que vous souhaitez connecter
- Un accès administrateur à votre organisation Mintlify
- Un fichier
docs.jsondans votre dépôt
Lorsque vous ouvrez Git Settings pour la première fois, un assistant de configuration vous guide pour connecter votre dépôt Bitbucket.
Sélectionner Bitbucket comme fournisseur
- Sur la page Git Settings, sélectionnez Connect to Bitbucket.
- Cliquez sur Continue.
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 Bitbucket.
Si votre contenu est déjà dans Bitbucket, cliquez sur Continue setup.
Autoriser Bitbucket
- Cliquez sur Connect Bitbucket.
- Bitbucket ouvre une nouvelle page pour autoriser Mintlify à accéder à votre compte Bitbucket. Autorisez Mintlify à accéder au dépôt que vous souhaitez connecter.
Après autorisation, Bitbucket vous redirige vers vos paramètres Git Mintlify.
Configurer le dépôt
Saisissez les valeurs suivantes :
- Workspace : Le slug du workspace Bitbucket qui possède le dépôt. Par exemple, dans
https://bitbucket.org/acme/docs,acmeest le slug du workspace. - Repository : Le slug du dépôt. Par exemple, dans
https://bitbucket.org/acme/docs,docsest le slug du dépôt. - Deploy branch : La branche qui publie sur votre site de documentation en production, comme
main.
Configurer un répertoire de contenu (facultatif)
- Si votre fichier
docs.jsonse trouve dans un sous-répertoire, activez Docs are in a subdirectory sur votre page de paramètres Git. - Saisissez le chemin du répertoire qui contient votre fichier
docs.json. Par exemple, si votredocs.jsonse trouve dans le répertoireapps/docs/, saisissezapps/docs.
Connecter le dépôt
- Cliquez sur Connect.
- Confirmez le changement. Mintlify vérifie que le compte Bitbucket autorisé peut accéder à votre dépôt et enregistre le webhook qui déclenche les déploiements et les prévisualisations de pull requests.
- Accédez à la page Git Settings de votre tableau de bord Mintlify.
- Développez la section Bitbucket OAuth.
- Activez ou désactivez chaque dépôt individuellement. La désactivation d’un dépôt supprime son webhook Mintlify.
La révocation d’une connexion supprime les webhooks Mintlify pour tous les dépôts connectés via ce compte.
Vous pouvez combiner du contenu provenant de plusieurs dépôts Bitbucket dans un seul site. Chaque source du déploiement doit utiliser Bitbucket, et vous devez activer chaque dépôt sous Bitbucket OAuth avant de l’ajouter comme source.
Consultez Déploiements multi-dépôts pour les instructions de configuration et des informations sur les chemins d’URL, les sources de base et la navigation.