Bitbucket インテグレーション
ClickUpマニュアル｜ClickUpタスクをBitbucketのコミット、ブランチ、PRと同期して、プロジェクト管理を効率化します。
Bitbucket のコミット、ブランチ、プル リクエストをClickUpタスクと統合します。 これにより、次のことが可能になります。
タスクに関連するすべての Bitbucket アクティビティをClickUpで直接表示します。
オプションで、新しい Bitbucket アクティビティ項目がタスクに追加されたときにClickUp通知を受信します。
ClickUpタスクに自動的 (または手動で) アタッチします。
#{taskID}[status]という形式を使用してコミットにClickUpタスク ID を追加することで、Bitbucket アクションでステータスを自動的に変更します。例： #1abc2de[closed]
必要なもの
Bitbucket 統合はすべてのClickUpプランで利用できます。
統合を設定できるのは、ワークスペースのオーナーと管理者のみです。
GuestsはBitbucket 統合を使用できません。
ClickUp がBitbucket に接続することを承認する
ClickUpと Bitbucket.org またはセルフホスト バージョンの Bitbucket を統合できます。 認証プロセスは、使用する Bitbucket のバージョンによって異なります。
オプション 1 ： Bitbucket.orgアカウントを認証する
App Center を開きます。
[Bitbucket] をクリックします。
[Activate Bitbucket for Team]をクリックします。
[+ Add Bitbucket]をクリックします。
[No, I use bitbucket.com]を選択し、[Link Bitbucket]をクリックします。
ログインしていない場合は、Bitbucket.orgアカウントにログインするように求められます。
必要な権限を確認し、[Grant access]をクリックします
アカウントを承認したので、次の手順に進み、 Bitbucket リポジトリをワークスペースに接続します。
オプション 2 ：セルフホスト型Bitbucketアカウントを承認する
セルフホスト版の Bitbucket を使用している場合は、HTTP アクセス トークンを作成してClickUpを承認できます。 Bitbucket HTTP アクセス トークンの詳細をご覧ください。
App Center を開きます。
[Bitbucket]をクリック
[Activate Bitbucket for Team]をクリック
[+ Add Bitbucket]をクリック
[Yes, I use a hosted version of Bitbucket]を選択し、Bitbucket で次の手順に従います。
ホストされている Bitbucket で、右上にあるユーザー プロファイル アバターをクリックします。
[Manage account]を選択します。
左サイドバーの[HTTP access tokens]を選択します。
ProjectsとRepositoriesの両方に対してadmin権限を持つ新しいアクセス トークンを作成します。
HTTP access tokenをコピーします。
ClickUpに戻り、コピーしたトークンを[Access token]フィールドに貼り付けます。
以下の Bitbucket アカウントの詳細を入力：
Host URL
Canonical URL (オプション)
設定を選択してください：
ホストされたシークレットを使用しますか?
固定IP
[Link Bitbucket]をクリックします。
アカウントを承認したので、次の手順に進み、 Bitbucket リポジトリをワークスペースに接続します。
Bitbucket リポジトリをワークスペースにアタッチする
ClickUpではワークスペース内で複数の人がBitbuckett認証することができ、ワークスペースと共有するリポジトリをカスタマイズすることもできます。
つまり、すべてのリポジトリをアタッチしなくても個人アカウントを承認でき、アタッチするリポジトリをカスタマイズできます。
リポジトリをアタッチしても、ユーザーにリポジトリのコードベースへのアクセス権が付与されるわけではありません。 ユーザーは、指定したスペースにそのリポジトリの履歴項目を添付できるようになります。
ステップ3 ：リポジトリに添付するスペースを選択する
Team Reposの右側にあるドロップダウンを展開すると、リポジトリがアタッチされるスペースをカスタマイズできます。 Bitbucket アイテムをタスクに添付するには、スペースをリポジトリに添付する必要があります。
ClickUpで Bitbucket アクティビティを自動的に関連付ける
ClickUp は新しいアクティビティを自動的に取得し、タスクに関連付けます。
これを有効にするには、次の操作を行う必要があります。
プル リクエストのタイトル、ブランチ名、またはコミット メッセージの任意の部分に、次のいずれかの形式でClickUpタスク IDを追加します。
#{task_id}
CU-{task_id}
{custom_task_id}
例えば：
#1abc2de
CU-1abc2de
prefix-1
Bitbucketアクティビティを手動で関連付ける
任意のタスクのBitbucketアイコンをクリックします
リポジトリを選択
Branchを選択
コミットを添付する
Bitbucket 経由でタスクのStatusを自動的に変更する
コミットまたはプルリクエストからタスクのステータスを変更することもできます。 これを行うには、次の手順を実行します。
コミット メッセージの任意の部分に ClickUpタスク IDを追加し、括弧内に希望するステータスを追加します。
例： #ud5b[ready]
リポジトリ設定に移動
[Links]をクリック
新しいリンクを追加
Link type：Custom
Link URL ： app.clickup.com/t/\1
Link key： CU-(\w{3,10})(\[\w+\])?
これはコミットとプルリクエストの両方で機能します。
Actions
Quick actionsを使用して、 ClickUp内から新しいブランチをすばやく簡単に作成します。
[Bitbucket icon]をクリックしてGitモーダルを開きます
左側には、提案された名前、ローカルで新しいブランチをチェックアウトしてリンクするコマンド、単一のコミットをリンクするコマンド、プルリクエストを開くコマンドなど、自動生成されたさまざまなクイックコピーオプションがあります。
これらのオプションで使用される自動生成された名前は、Bitbucket 統合設定でカスタマイズできます。
プルリクエスト
これで、 ClickUp内からプル リクエストを作成したり、既存のプル リクエストをリンクしたりできるようになりました。ClickUpで新しいプルリクエストを作成するには：
リンクするタスクの Bitbucket アイコンをクリックし、[New Pull Request]ボタンをクリックします。
モーダルでは、提案されたプル リクエストのタイトルに、提案されたタイトルが事前に入力されます。 自動生成されたタイトルが気に入らない場合は、Bitbucket 統合設定で調整できます。
ターゲットブランチとソースブランチを選択する
descriptionを入力
プルリクエストを作成する
ClickUpでプル リクエストを作成するか、既存のプル リクエストをリンクするとすぐに、関連付けられたClickUpタスクへのリンクがプル リクエストに追加されます。
プル リクエストがリンクされると、リンクされた ClickUp タスク内から、誰がそれを開いたか、ClickUp担当者 (割り当てられている場合)、CI/CD ステータス、プル リクエスト ステータス (オープン、レビュー要求済み、レビュー中、マージ済み、クローズ済み) をすべて確認できるようになります。
Bitbucket で問題が発生していますか?
トラブルシューティングのドキュメントを読むか、Bitbucket カスタマー サポートにこちらからお問い合わせください。
Bitbucket統合をRemove
統合を無効にできるのは、ワークスペースのオーナーと管理者のみです。
統合を削除するには、 App Centerから次の手順を実行します。
[Bitbucket]を選択します。
下にスクロールして、[authorization for my Bitbucket repositories]をクリックします。
Last updated