Bitbucket の構成

bitbucket.org上の新規または既存のリポジトリ（repo）にソースコードを保存し、Wiki、課題追跡、プルリクエストを通じてソーシャルコーディングに参加しましょう。

チームとコードの共同作業を行うために Bitbucket を構成するには、以下のようにします。

IBM Cloudコンソールから、メニューアイコンの >Platform Automation>Toolchains をクリックします。「ツールチェーン」ページで、Bitbucket を追加するツールチェーンをクリックします。あるいは、アプリの「概要」ページの「継続的デリバリー」カードで、**「ツールチェーンの表示」をクリックします。次に、「概要」**をクリックします。

a. **「ツールの追加」**をクリックします。

b. 「ツール統合」セクションで、**「Bitbucket」**をクリックします。

IBM Cloud Public でこのツール統合を構成しており、Bitbucket へのアクセスを IBM Cloud に許可していない場合は、**「許可」**をクリックして Bitbucket Web サイトに移動します。アクティブな Bitbucket セッションがない場合は、ログインするよう求められます。 **「アクセス権限の付与 (Grant access)」**をクリックして、IBM Cloud ツールチェーンが Bitbucket アカウントの以下の部分にアクセスできるようにします。
- アカウント情報をお読みください。基本的なユーザー情報を取得して、ユーザー・インターフェースを設定します。
- リポジトリーの問題を読み取り、変更します。 Continuous Delivery で問題を更新し、これらの問題にアタッチされているコミットをパイプラインがデプロイするときにそのことが示されるようにします。
- チームのプロジェクト設定を読み、チームのプロジェクト内に含まれるリポジトリーを読み取ります。 Continuous Delivery で、チームが所有するリポジトリーと統合できるようにします。
- リポジトリーとそのプル・リクエストを読み取り、変更します。ユーザーがコードを要求したときに、Continuous Delivery でサンプル・コードをリポジトリーにプッシュできるようにします。
- リポジトリーを管理します。ユーザーから要求された場合に、Continuous Delivery で新規リポジトリーを作成できるようにします。
- チーム・メンバーシップ情報をお読みください。 Continuous Delivery で、新規リポジトリーの作成時に表示される**「所有者」**メニューにチームのリストを表示できるようにします。
- リポジトリーの Web フックを読み取り、変更します。コミットがリポジトリーにプッシュされたときに、パイプラインがビルドをトリガーできるようにします。
アクティブな Bitbucket セッションはあるものの、最近パスワードを入力していない場合は、確認のために Bitbucket パスワードの入力を求められることがあります。
使用する Bitbucket サーバーをクリックします。
既存の Bitbucket リポジトリーを使用する場合は、そのリポジトリーの URL を入力します。リポジトリー・タイプには、**「既存」**をクリックします。
新しい Bitbucket リポジトリーを使用する場合は、そのリポジトリーに付ける名前を入力し、複製またはフォークするリポジトリーの URL を入力し、リポジトリー・タイプを次のように選択します。

a. 空のリポジトリーを作成する場合は、**「新規」**をクリックします。

b. リポジトリーのコピーを作成する場合は、**「クローンを作成する (Clone)」**をクリックします。

c. リポジトリーをフォークし、プル・リクエストで変更内容を提供できるようにする場合は、**「フォーク (Fork)」**をクリックします。
サーバー上にプライベート・リポジトリーを作成するには、**「このリポジトリーをプライベートにする (Make this repository private)」**チェック・ボックスを選択します。
問題のトラッキングに Bitbucket Issues を使用する場合は、**「Bitbucket Issues を使用可能にする (Enable Bitbucket Issues)」**チェック・ボックスにチェック・マークを付けます。
コミットに対するタグおよびコメントと、コミットで参照される問題に対するラベルおよびコメントを作成することによって、コード変更のデプロイメントをトラッキングするには、**「コード変更のデプロイメントを追跡する (Track deployment of code changes)」**チェック・ボックスにチェック・マークを付けます。詳しくは、ツールチェーンでコードがどこにデプロイされたかを追跡するを参照のこと。
「統合の作成」 をクリックします。
ツールチェーンの**「サード・パーティー・ツール」**カードで、処理する Bitbucket リポジトリーの「Bitbucket ツール統合」をクリックします。 Bitbucket の Web サイトが開きます。そこでリポジトリーの内容を表示できます。
Bitbucket Issues を使用可能にした場合、**「Bitbucket Issues」**をクリックして開きます。ツールチェーンに複数の Bitbucket リポジトリーが含まれれている場合でも、Bitbucket Issues のこのインスタンスをツールチェーン全体に使用できます。

リンクしようとしているリポジトリーに対する所有者またはマスター特権がない場合は、Web フックを使用できないので統合は制限されます。リポジトリーにコミットがプッシュされたときにパイプラインが自動的に実行されるようにするには、Web フックが必要です。 Web フックがない場合、パイプラインを手動で開始する必要があります。

APIを使ってBitbucketを設定する

Bitbucket ツール統合は、作成、読み取り、および更新のツール統合時にツールチェーンの HTTP API および SDK で使用できる以下の構成パラメーターをサポートします。

bitbucketgit 値を使用して、要求本体に tool_type_id プロパティーを指定する必要があります。

Bitbucketツール統合パラメータ
パラメーター	使用法	タイプ	Terraform 引数	説明
API のルート URL	オプション、更新可能	ストリング	API のルート URL	Bitbucket API の URL (例: `https://api.bitbucket.org`)。
デフォルト・ブランチ	オプション、更新可能	ストリング	デフォルト・ブランチ	デフォルト・ブランチの名前 (例えば、 `main`)。
enable_traceability	任意、更新可能、'`Default: false`	ブール値	enable_traceability	この値を'`true` に設定すると、コミット、プルリクエスト、参照された課題に対してタグ、ラベル、コメントを作成し、コード変更のデプロイメントを追跡します。
Git_id	オプション、不変	ストリング	Git_id	この値を `bitbucketgit` ( bitbucket.orgの場合)、またはカスタム Bitbucket サーバーの GUID に設定します。
has_issues	任意、更新可能、'`Default: true`	ブール値	ツールチェーンの発行が有効	Bitbucket リポジトリーで問題を有効にし、問題ツール・カードをツールチェーンに追加するには、この値を `true` に設定します。ツールチェーンからツール統合カードを削除するには、この値を `false` に設定します。この設定は、Bitbucket リポジトリー自体で Issues が有効になっているかどうかには影響しません。
統合所有者	オプション、更新可能	ストリング	統合所有者	Git 操作を実行するユーザー。
owner_id	オプション、不変	ストリング	owner_id	このリポジトリーを所有する Bitbucket ユーザーまたはグループ。このパラメーターは、リポジトリーを作成する場合、またはリポジトリーを複製またはフォークする場合に必要です。この値は、既存のリポジトリーにリンクすると計算されます。
プライベート・リポジトリー	任意、不変、'`Default: false`	ブール値	プライベート・リポジトリー	リポジトリーを作成するとき、またはリポジトリーを複製またはフォークするときに、リポジトリーをプライベートにするには、この値を `true` に設定します。既存のリポジトリーにリンクする場合、このパラメーターは使用されません。
リポジトリー ID	オプション、不変	ストリング	リポジトリー ID	ビット・バケット・リポジトリーの ID。
repo_name	オプション、不変	ストリング	repo_name	作成する Bitbucket リポジトリの名前。このパラメーターは、リポジトリーを作成する場合、またはリポジトリーを複製またはフォークする場合に必要です。この値は、既存のリポジトリーにリンクすると計算されます。
repo_url	オプション、不変	ストリング	repo_url	このツール統合のための Bitbucket リポジトリーの URL。既存のリポジトリーにリンクする場合、このパラメーターは必須です。この値は、リポジトリーを作成するとき、またはリポジトリーを複製またはフォークするときに計算されます。
ソース repo_URL	オプション、不変	ストリング	ソース repo_URL	フォークまたはクローンの対象となるリポジトリーの URL。このパラメーターは、リポジトリーをフォークまたはクローン作成するときには必須ですが、リポジトリーまたは既存のリポジトリーへのリンクを作成するときには使用されません。
トークン URL	オプション、更新可能	ストリング	トークン URL	Bitbucket サーバーでの許可に使用されるトークン URL。
タイプ	必須、変更不可能	ストリング	タイプ	新規ツール統合を初期化するために実行する操作。 `new` を使用して Git リポジトリーを作成します。 `clone` を使用して既存のリポジトリーを新しい Git リポジトリーに複製します。 `fork` を使用して既存の Git リポジトリーをフォークするか、 `link` を使用して既存の Git リポジトリーにリンクします。

Bitbucket に関する詳細

Bitbucketの詳細については、Bitbucket Cloudのリソースをご覧ください。