Bitbucket のコミット、ブランチ、プル リクエストをClickUpタスクと統合します。 これにより、次のことが可能になります。

• タスクに関連するすべての Bitbucket アクティビティをClickUpで直接表示します。
• オプションで、新しい Bitbucket アクティビティ項目がタスクに追加されたときにClickUp通知を受信します。
• ClickUpタスクに自動的 (または手動で) アタッチします。
• #{taskID}[status]という形式を使用してコミットにClickUpタスク ID を追加することで、Bitbucket アクションでステータスを自動的に変更します。例： #1abc2de[closed]

  

  Screenshot of a Bitbucket task activity notification.

必要なもの

• Bitbucket 統合はすべてのClickUpプランで利用できます。
• 統合を設定できるのは、ワークスペースのオーナーと管理者のみです。
• GuestsはBitbucket 統合を使用できません。

ClickUp がBitbucket に接続することを承認する

ClickUpと Bitbucket.org またはセルフホスト バージョンの Bitbucket を統合できます。 認証プロセスは、使用する Bitbucket のバージョンによって異なります。

• オプション 1 ： Bitbucket.org アカウントを認証する
• オプション 2 ：セルフホスト型 Bitbucket アカウントを承認する

オプション 1 ： Bitbucket.orgアカウントを認証する

1. App Center を開きます。
2. [Bitbucket] をクリックします。
3. [Activate Bitbucket for Team]をクリックします。
4. [+ Add Bitbucket]をクリックします。
5. [No, I use bitbucket.com]を選択し、[Link Bitbucket]をクリックします。
   
6. ログインしていない場合は、Bitbucket.orgアカウントにログインするように求められます。
7. 必要な権限を確認し、[Grant access]をクリックします

   

アカウントを承認したので、次の手順に進み、 Bitbucket リポジトリをワークスペースに接続します。

オプション 2 ：セルフホスト型Bitbucketアカウントを承認する

セルフホスト版の Bitbucket を使用している場合は、HTTP アクセス トークンを作成してClickUpを承認できます。 Bitbucket HTTP アクセス トークンの詳細をご覧ください。

1. App Center を開きます。
2. [Bitbucket]をクリック
3. [Activate Bitbucket for Team]をクリック
4. [+ Add Bitbucket]をクリック
5. [Yes, I use a hosted version of Bitbucket]を選択し、Bitbucket で次の手順に従います。 
   
6. ホストされている Bitbucket で、右上にあるユーザー プロファイル アバターをクリックします。
7. [Manage account]を選択します。 
   
8. 左サイドバーの[HTTPaccess tokens]を選択します。
9. ProjectsとRepositoriesの両方に対してadmin権限を持つ新しいアクセス トークンを作成します。
10. HTTP access tokenをコピーします。
11. ClickUpに戻り、コピーしたトークンを[Access token]フィールドに貼り付けます。
12. 以下の Bitbucket アカウントの詳細を入力：
    • Host URL
    • Canonical URL (オプション)
      
13. 設定を選択してください：
    • ホストされたシークレットを使用しますか?
    • 固定IP
14. [Link Bitbucket]をクリックします。

アカウントを承認したので、次の手順に進み、 Bitbucket リポジトリをワークスペースに接続します。

Bitbucket リポジトリをワークスペースにアタッチする

ClickUpではワークスペース内で複数の人がBitbuckett認証することができ、ワークスペースと共有するリポジトリをカスタマイズすることもできます。 

つまり、すべてのリポジトリをアタッチしなくても個人アカウントを承認でき、アタッチするリポジトリをカスタマイズできます。 

リポジトリをアタッチしても、ユーザーにリポジトリのコードベースへのアクセス権が付与されるわけではありません。 ユーザーは、指定したスペースにそのリポジトリの履歴項目を添付できるようになります。 

ステップ3 ：リポジトリに添付するスペースを選択する

Team Reposの右側にあるドロップダウンを展開すると、リポジトリがアタッチされるスペースをカスタマイズできます。 Bitbucket アイテムをタスクに添付するには、スペースをリポジトリに添付する必要があります。

Screenshot linking Bitbucket repositories with ClickUp Spaces.

ClickUpで Bitbucket アクティビティを自動的に関連付ける

ClickUp は新しいアクティビティを自動的に取得し、タスクに関連付けます。 

これを有効にするには、次の操作を行う必要があります。 

プル リクエストのタイトル、ブランチ名、またはコミット メッセージの任意の部分に、次のいずれかの形式でClickUpタスク IDを追加します。 

#{task_id} 

CU-{task_id} 

{custom_task_id} 

例えば： 

#1abc2de 

CU-1abc2de 

prefix-1

Bitbucketアクティビティを手動で関連付ける

1. 任意のタスクのBitbucketアイコンをクリックします
2. リポジトリを選択
3. Branchを選択
4. コミットを添付する

Bitbucket 経由でタスクのStatusを自動的に変更する

コミットまたはプルリクエストからタスクのステータスを変更することもできます。 これを行うには、次の手順を実行します。

コミット メッセージの任意の部分に ClickUpタスク IDを追加し、括弧内に希望するステータスを追加します。 

例： #ud5b[ready]

Screenshot of a commit in Bitbucket.

1. リポジトリ設定に移動
2. [Links]をクリック
3. 新しいリンクを追加
4. Link type：Custom
5. Link URL ： app.clickup.com/t/\1
6. Link key： CU-(\w{3,10})(\[\w+\])?

これはコミットとプルリクエストの両方で機能します。

Actions

Quick actionsを使用して、 ClickUp内から新しいブランチをすばやく簡単に作成します。

1. [Bitbucket icon]をクリックしてGitモーダルを開きます
2. 左側には、提案された名前、ローカルで新しいブランチをチェックアウトしてリンクするコマンド、単一のコミットをリンクするコマンド、プルリクエストを開くコマンドなど、自動生成されたさまざまなクイックコピーオプションがあります。

   

   Screenshot of the git branch modal on a ClickUp task.

これらのオプションで使用される自動生成された名前は、Bitbucket 統合設定でカスタマイズできます。

Screenshot of the Bitbucket branch name settings.

プルリクエスト

これで、 ClickUp内からプル リクエストを作成したり、既存のプル リクエストをリンクしたりできるようになりました。ClickUpで新しいプルリクエストを作成するには：

1. リンクするタスクの Bitbucket アイコンをクリックし、[New Pull Request]ボタンをクリックします。
2. モーダルでは、提案されたプル リクエストのタイトルに、提案されたタイトルが事前に入力されます。 自動生成されたタイトルが気に入らない場合は、Bitbucket 統合設定で調整できます。
3. ターゲットブランチとソースブランチを選択する
4. descriptionを入力
5. プルリクエストを作成する

ClickUpでプル リクエストを作成するか、既存のプル リクエストをリンクするとすぐに、関連付けられたClickUpタスクへのリンクがプル リクエストに追加されます。

Screenshot of a task linked notification in Bitbucket.

プル リクエストがリンクされると、リンクされた ClickUp タスク内から、誰がそれを開いたか、ClickUp担当者 (割り当てられている場合)、CI/CD ステータス、プル リクエスト ステータス (オープン、レビュー要求済み、レビュー中、マージ済み、クローズ済み) をすべて確認できるようになります。

Screenshot of pull request activity in ClickUp's git modal.

Bitbucket で問題が発生していますか?

トラブルシューティングのドキュメントを読むか、Bitbucket カスタマー サポートにこちらからお問い合わせください。

Bitbucket統合をRemove

統合を無効にできるのは、ワークスペースのオーナーと管理者のみです。

統合を削除するには、 App Centerから次の手順を実行します。

1. [Bitbucket]を選択します。
2. 下にスクロールして、[authorization for my Bitbucket repositories]をクリックします。