Connectez votre compte Bitbucket pour que vos sites soient déployés à partir d’un dépôt

Les avantages de cette connexion

Connecter Bitbucket permet à un site d’être déployé depuis l’un de vos dépôts Bitbucket Cloud : publiez sur la branche et le site se met à jour.

Avant de commencer

Un compte Bitbucket Cloud disposant d’un accès aux dépôts que vous souhaitez déployer.

1. Créez la clé sur Bitbucket

Bitbucket propose deux types d’identifiants, et l’un comme l’autre fonctionne :

• Un jeton d’accès pour un dépôt, un projet ou un espace de travail, créé à partir des paramètres propres à ce dépôt, ce projet ou cet espace de travail sous Access tokens. Il est lié à ce dépôt, ce projet ou cet espace de travail plutôt qu’à une personne. Donnez-lui un accès en lecture aux dépôts.
• Un jeton d’API sur votre compte Atlassian. Sélectionnez votre profil, puis Account settings → Security → Create and manage API tokens → Create API token with scopes. Donnez-lui un nom, définissez une date d’expiration, choisissez Bitbucket comme application et sélectionnez l’accès en lecture aux dépôts. Bitbucket n’affiche le jeton qu’une seule fois ; copiez-le à ce moment-là.

2. Connectez-la ici

Ouvrez Integrations dans votre tableau de bord et choisissez Connect an account. Choisissez Code hosting comme groupe et Bitbucket comme compte, renseignez API token — ainsi que Account username si vous avez créé un jeton sur votre compte Atlassian plutôt qu’un jeton d’accès —, puis appuyez sur Connect account.

Nous testons ce que vous collez avant d’enregistrer quoi que ce soit. Une clé qui ne fonctionne pas n’est jamais stockée, et la réponse indique la nature du problème. Une clé fonctionnelle est conservée sous forme chiffrée dans notre coffre-fort de secrets — jamais dans notre base de données — et ne sera plus jamais affichée, pas même à vous.

Le nom d’utilisateur détermine la manière dont nous envoyons le jeton, ne le saisissez donc que pour un jeton de compte. Un jeton d’accès saisi avec un nom d’utilisateur, ou un jeton de compte sans nom d’utilisateur, sera refusé.

Ce qui se passe ensuite

• Un site peut être déployé directement depuis un dépôt associé à ce compte : sélectionnez-le sur la connexion de dépôt du site, choisissez le dépôt et la branche, et une publication déclenche le déploiement.
• Chaque autre branche peut disposer de son propre aperçu, afin que vous puissiez vérifier une modification avant qu’elle n’atteigne le site en production.
• Les hébergeurs statiques basés sur Git tels que Render et Azure Static Web Apps utilisent cette connexion comme source du code du site.

En cas d’échec de la connexion

Un dépôt est manquant. Un jeton d’accès ne permet d’accéder qu’au dépôt, au projet ou à l’espace de travail dans lequel il a été créé. Créez-en un au niveau qui couvre tous les dépôts dont vous avez besoin.

La connexion fonctionnait puis s’est arrêtée. Les deux types de jetons peuvent expirer. Créez-en un nouveau et connectez-le.

Il est indiqué que la clé a été rejetée. Il s’agit presque toujours de l’une de ces trois situations : un espace ou un saut de ligne a été copié avec celle-ci, la clé a expiré, ou la clé a été révoquée ou régénérée après que vous l’avez copiée. Créez-en une nouvelle et collez-la à nouveau.

La connexion s’établit, mais une action ultérieure échoue. La clé s’authentifie mais ne dispose pas d’une autorisation requise pour l’action. Créez une nouvelle clé avec les autorisations indiquées ci-dessus, puis déconnectez l’ancienne connexion et connectez la nouvelle clé.

Déconnexion

Ouvrez Integrations, recherchez le compte et appuyez sur Disconnect. Cela supprime immédiatement la clé stockée. Tout élément qui l’utilisait s’arrêtera lors de sa prochaine action, et les écrans qui en dépendaient le signaleront au lieu d’échouer silencieusement.

La déconnexion n’annule pas ce qui a déjà été effectué — les enregistrements, les déploiements ou les paramètres que nous avons modifiés sur votre compte restent inchangés. Si vous pensez que la clé elle-même a pu être divulguée, révoquez-la également auprès du fournisseur ; la déconnexion supprime notre copie, pas la leur.