Configuration de Bitbucket

Stockez votre code source dans un dépôt (repo) nouveau ou existant sur bitbucket.org et participez au codage social par le biais de wikis, du suivi des problèmes et des demandes d'extraction.

Configurez Bitbucket pour collaborer avec votre équipe sur le code :

Dans la console IBM Cloud, cliquez sur l' Menu > Automatisation de la plateforme > Chaînes d'outils. Sur la page Chaînes d'outils, cliquez sur la chaîne d'outils à laquelle vous souhaitez ajouter Bitbucket. Vous pouvez également, depuis la page de présentation de l'application, sur la carte Distribution continue, cliquer sur Afficher la chaîne d'outils. Ensuite, cliquez sur Vue d'ensemble.

a. Cliquez sur Ajouter un outil.

b. Dans la section Intégrations d'outils, cliquez sur Bitbucket.

Si vous configurez cette intégration d'outils sur IBM Cloud Public et que vous n'avez pas autorisé IBM Cloud à accéder à Bitbucket, cliquez sur Autorisation pour accéder au site Web Bitbucket. Si vous n'avez pas de session Bitbucket active, vous êtes invité à vous connecter. Cliquez sur Accorder l'accès pour autoriser IBM Cloud Toolchains à accéder aux parties suivantes de votre compte Bitbucket :
- Lisez vos informations de compte. Obtenez des informations de base sur l'utilisateur pour remplir l'interface utilisateur.
- Lisez et modifiez les problèmes des référentiels. Autorisez Continuous Delivery à mettre à jour les problèmes pour indiquer le moment où le pipeline déploie les validations associées à ces problèmes.
- Lisez les paramètres de projet de votre équipe ainsi que les référentiels contenus dans les projets de votre équipe.. Autorisez Continuous Delivery à intégrer les référentiels appartenant à des équipes.
- Lisez et modifiez vos référentiels et leurs demandes d'extraction. Autorisez Continuous Delivery à envoyer un exemple de code dans des référentiels, lorsque les utilisateurs demandent le code.
- Administrez vos référentiels. Autorisez Continuous Delivery à créer des référentiels, à la demande des utilisateurs.
- Lisez les informations d'appartenance à votre équipe. Autorisez Continuous Delivery à afficher une liste de vos équipes dans le menu Propriétaire qui s'affiche lorsque vous créez un nouveau référentiel.
- Lisez et modifiez les webhooks de vos référentiels. Autorisez le pipeline à déclencher des générations lorsque des validations sont envoyées dans un référentiel.
Si vous disposez d'une session Bitbucket active mais n'avez pas saisi votre mot de passe récemment, vous êtes invité à entrer votre mot de passe Bitbucket pour confirmation.
Cliquez sur le serveur Bitbucket que vous souhaitez utiliser.
Si vous souhaitez utiliser un référentiel Bitbucket en particulier, entrez son URL. Pour le type de référentiel, cliquez sur Existant.
Si vous souhaitez utiliser un nouveau référentiel Bitbucket, saisissez un nom pour le référentiel, entrez l'URL du référentiel que vous clonez ou déviez, puis sélectionnez le type de référentiel :

a. Pour créer un référentiel vide, cliquez sur Nouveau.

b. Pour créer une copie d'un référentiel, cliquez sur Cloner.

c. Pour dévier un référentiel afin de pouvoir participer aux modifications via des demandes d'extraction, cliquez sur Dévier.
Pour créer un référentiel privé sur le serveur, cochez la case Rendre ce référentiel privé.
Pour utiliser Bitbucket Issues pour le suivi des problèmes, cochez la case Activer Bitbucket Issues.
Pour suivre le déploiement des modifications du code en créant des étiquettes et des commentaires sur les validations, ainsi que des libellés et des commentaires sur les problèmes référencés par les validations, cochez la case Suivi du déploiement des modifications du code. Pour plus d'informations, voir Suivre où votre code est déployé avec les chaînes d'outils.
Cliquez sur Créer une intégration.
Depuis votre chaîne d'outils, sur la carte Outils tiers, cliquez sur l'intégration de l'outil Bitbucket pour le référentiel Bitbucket avec lequel vous souhaitez travailler. Le site Web de Bitbucket s'ouvre avec le contenu du référentiel.
Si vous avez activé Bitbucket Issues, cliquez sur Bitbucket Issues pour l'ouvrir. Vous pouvez utiliser cette instance de Bitbucket Issues pour l'ensemble de votre chaîne d'outils, même si cette dernière contient plusieurs référentiels Bitbucket.

Si vous ne disposez pas d'un droit maître ou propriétaire sur le référentiel avec lequel vous établissez une liaison, votre intégration sera limitée car vous ne pouvez pas utiliser un webhook. Les webhooks sont nécessaires pour exécuter un pipeline automatiquement lorsqu'une validation est envoyée par commande push au référentiel. Sans webhook, vous devez démarrer manuellement vos pipelines.

Configurer Bitbucket en utilisant l'API

L'intégration d'outils Bitbucket prend en charge les paramètres de configuration suivants que vous pouvez utiliser avec l'API HTTP de chaîne d'outils et les logiciels SDK lorsque vous créez, lisezet mettez à jour les intégrations d'outils.

Vous devez spécifier la propriété tool_type_id dans le corps de la demande avec la valeur bitbucketgit.

Paramètres d'intégration de l'outil Bitbucket
Paramètre	Utilisation	Type	Argument Terraform	Description
url_racine_API	facultatif, pouvant être mis à jour	Chaîne	url_racine_API	URL de l'API Bitbucket, telle que `https://api.bitbucket.org`.
branch_par_défaut	facultatif, pouvant être mis à jour	Chaîne	branch_par_défaut	Nom de la branche par défaut, par exemple, `main`.
enable_traceability	facultatif, actualisable, " `Default: false`	Booléen	enable_traceability	Définissez cette valeur sur " `true` pour suivre le déploiement des modifications de code en créant des étiquettes et des commentaires sur les commits, les pull requests et les problèmes référencés.
git_id	facultatif, non modifiable	Chaîne	git_id	Définissez cette valeur sur `bitbucketgit` pour bitbucket.orgou sur l'identificateur global unique d'un serveur Bitbucket personnalisé.
has_issues	facultatif, actualisable, " `Default: true`	Booléen	toolchain_issues_enabled	Définissez cette valeur sur `true` pour activer les problèmes sur le référentiel Bitbucket et pour ajouter une carte d'outil Problèmes à la chaîne d'outils. Définissez cette valeur sur `false` pour supprimer la carte d'intégration d'outils de la chaîne d'outils. Ce paramètre n'a pas d'impact sur l'activation des problèmes dans le référentiel Bitbucket lui-même.
propriété_intégration	facultatif, pouvant être mis à jour	Chaîne	propriété_intégration	Utilisateur qui effectue des opérations Git.
owner_id	facultatif, non modifiable	Chaîne	owner_id	Utilisateur ou groupe Bitbucket propriétaire du référentiel. Ce paramètre est obligatoire lorsque vous créez un référentiel ou que vous clonez ou déviez un référentiel. Cette valeur est calculée lorsque vous établissez un lien vers un référentiel existant.
rep_privé	facultatif, immuable, " `Default: false`	Booléen	rep_privé	Définissez cette valeur sur `true` pour rendre le référentiel privé lorsque vous créez un référentiel ou lorsque vous clonez ou déviez un référentiel. Ce paramètre n'est pas utilisé lorsque vous établissez un lien vers un référentiel existant.
repo_id	facultatif, non modifiable	Chaîne	repo_id	ID du référentiel Bitbucket.
repo_name	facultatif, non modifiable	Chaîne	repo_name	Le nom du repo Bitbucket à créer. Ce paramètre est obligatoire lorsque vous créez un référentiel ou que vous clonez ou déviez un référentiel. Cette valeur est calculée lorsque vous établissez un lien vers un référentiel existant.
repo_url	facultatif, non modifiable	Chaîne	repo_url	URL du référentiel Bitbucket pour cette intégration d'outils. Ce paramètre est obligatoire lorsque vous établissez un lien vers un référentiel existant. Cette valeur est calculée lorsque vous créez un référentiel ou que vous clonez ou bifurquez un référentiel.
url_repo_source	facultatif, non modifiable	Chaîne	url_repo_source	URL du référentiel que vous souhaitez dévier ou cloner. Ce paramètre est obligatoire lorsque vous déviez ou clonez un référentiel, mais il n'est pas utilisé lorsque vous créez un référentiel ou un lien vers un référentiel existant.
url_jeton	facultatif, pouvant être mis à jour	Chaîne	url_jeton	URL de jeton utilisée pour l'autorisation avec le serveur Bitbucket.
type	requis, non modifiable	Chaîne	type	Opération à effectuer pour initialiser la nouvelle intégration d'outils. Utilisez `new` pour créer un référentiel Git, `clone` pour cloner un référentiel existant dans un nouveau référentiel Git, `fork` pour dévier un référentiel Git existant ou `link` pour le lier à un référentiel Git existant.

Plus d'informations sur Bitbucket

Pour en savoir plus sur Bitbucket, consultez les ressources Bitbucket Cloud.