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

Ce que la connexion vous apporte

Connecter Bitbucket permet de déployer un site depuis l'un de vos dépôts Bitbucket Cloud : poussez vers la branche et le site se met à jour.

Avant de commencer

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

1. Créer la clé sur Bitbucket

Bitbucket propose deux types d'identifiants, qui fonctionnent tous les deux :

• Un jeton d'accès pour un dépôt, un projet ou un espace de travail, créé à partir des paramètres correspondants de ce dépôt, projet ou espace de travail sous Access tokens. Il est lié à ce dépôt, projet ou 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. Nommez-le, définissez une date d'expiration, choisissez Bitbucket comme application et sélectionnez l'accès en lecture aux dépôts. Bitbucket affiche le jeton une seule fois ; copiez-le à ce moment-là.

2. Connecter ici

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

Nous testons ce que vous collez avant qu'un enregistrement ne soit effectué. Une clé qui ne fonctionne pas n'est jamais stockée, et le message indique ce qui n'allait pas. Une clé valide est conservée sous forme chiffrée dans notre coffre-fort de secrets — jamais dans notre base de données — et n'est plus jamais affichée, pas même pour 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é.

Que se passe-t-il ensuite

• Un site peut être déployé directement à partir d'un dépôt de ce compte : choisissez-le lors de la connexion du dépôt du site, sélectionnez le dépôt et la branche, et une action de type push déclenche le déploiement.
• Chaque autre branche peut disposer de sa propre version de prévisualisation, vous permettant de vérifier une modification avant qu'elle n'atteigne le site en production.
• Les hébergeurs statiques construits à partir de Git, tels que Render et Azure Static Web Apps, utilisent cette connexion comme source du code du site.

En cas de problème de connexion

Un dépôt est manquant. Un jeton d'accès n'atteint que le dépôt, le projet ou l'espace de travail dans lequel il a été créé. Créez-en un au niveau requis pour couvrir tous les dépôts dont vous avez besoin.

La connexion a fonctionné puis s'est arrêtée. Les deux types de jeton peuvent expirer. Créez-en un nouveau et connectez-le.

Un message indique que la clé a été rejetée. Il s'agit presque toujours de l'une de ces trois causes : un espace ou un saut de ligne copié avec la clé, une clé expirée, ou une clé révoquée ou régénérée après que vous l'avez copiée. Créez une nouvelle clé et collez-la à nouveau.

La connexion réussit, mais une action ultérieure échoue. La clé s'authentifie mais ne dispose pas d'une autorisation requise par l'action. Créez une nouvelle clé dotée des autorisations énuméré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 l'utilisant s'arrête lors de sa prochaine action, et les écrans qui en dépendaient l'indiquent explicitement au lieu de subir un échec silencieux.

La déconnexion n'annule pas ce qui a déjà été fait : les enregistrements, déploiements ou 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 compromise, révoquez-la également auprès du fournisseur ; la déconnexion supprime notre copie, pas la sienne.