Bitbucket Cloud を Slack と連携する
Atlassian は、ユーザーが Bitbucket の最新情報を常に把握できるようサポートします。常時提供するのは次の情報です。
プル リクエストの承認
ビルドの終了と、その成功または失敗
リポジトリへの新しいブランチの追加
その他
さらに、一部の通知では、ユーザーが通知内から直接アクションを実行できます。
プル リクエストに未対応のレビュワーへの再依頼
課題トラッカー、コミット、またはプル リクエストのコメントへの返信
承認されたプル リクエストのマージ
失敗したパイプライン ビルドの再実行
このような機能により、ユーザーの取り組みを支援します。アトラシアンでは、お客様のフィードバックに基づいてこのアプリの機能をさらに強化できるよう尽力します。
アプリのインストール
通知を設定するリポジトリを開きます。
Select Repository settings.
Select Slack, then Settings.
Select the Connect button under Slack. A dialog for Slack login might open if you are not already logged in.
リポジトリに接続する Slack ワークスペースを選択します。
Slack に「ようこそ」メッセージが自動的に送信されます。
リポジトリで過去の Slack 連携を使用している場合
リポジトリで Slack の通知をトリガーするようにすでに設定している場合、通知の重複を防ぐため、連携を再設定することをお勧めします。Bitbucket または Slack のいずれかからこれらの通知を停止することができます。
Bitbucket で、リポジトリの Slack Webhook を削除します。
From Repository settings, select Webhooks.
Select Delete for the webhooks configured for Slack.
Slack から Bitbucket アプリを削除します。
From the Slack App Directory, select Manage.
Bitbucket アプリ (古いロゴのついたもの) を見つけ、アプリを削除します。
Slack チャンネルで Bitbucket リポジトリをサブスクライブする
Slack チャンネルにサブスクリプションを追加し、そのサブスクリプションでの通知を選択します。サブスクリプションは Bitbucket リポジトリを Slack チャンネルに接続し、ユーザーはそのチャンネルに通知する Bitbucket イベントを定義できます。
通知を追加または変更するには、リポジトリ管理者権限が必要です。
Log into Bitbucket.
Slack に接続されているアカウントで、通知を追加するリポジトリを開きます。
Select Repository settings.
Shen Slack, then Settings.
以下のいずれかを選択します。
Select Add subscription, if you've already connected this repository to Slack.
Select the Connect button, if this the first time your connecting a repository to your Slack workspace.
Select Add subscription, and then select Add new workspace, if you’re adding a new subscription, to a new workspace.
リポジトリに接続する Slack ワークスペースとチャンネルを選択します。
You can subscribe to additional repositories by going to Slack, then Settings, or by typing/bitbucket connect <repository URL> in a Slack workspace that has been previously connected to Bitbucket.
プライベート チャンネル用にサブスクリプションを作成する
既定では、プライベート チャンネルは、サブスクリプション作成ダイアログのチャンネルの選択肢には表示されません。ただし、アクセス権を持っている任意のプライベート チャンネルで /bitbucket connect <repository URL> と入力すると、そのチャンネルにサブスクリプションを作成することができます。
DM にサブスクリプションを作成する
You can also have notifications sent only to you by direct message from the Bitbucket Slack bot. To create a subscription in a DM, select the Bitbucket bot in the Apps section of your Slack's left sidebar, and send it the message /bitbucket connect <repository URL>.
各サブスクリプションの通知を設定する
アプリをインストールした後、各リポジトリの設定で通知を選択できます。通知の取得先となる特定のブランチを選択して、チャンネルに必要な情報のみを提供することもできます。
Slack に接続しているいずれかのリポジトリを開きます。
Select Repository settings.
Select Slack, then Settings.
特定のブランチを選択してブランチ パターンを設定するか、すべてのブランチで通知を取得する場合はリポジトリ全体を選択します。
注: 特定のブランチに対して特定の通知を選択すると便利です。たとえば、すべてのブランチの各コミットの通知は不要だが、本番環境用ブランチではコミットの通知が必要な場合が考えられます。選択したブランチに対して通知を選択します。
通知用ブランチ パターン
ブランチ パターンを選択すると、ユーザーおよびワークスペースのメンバーは、特定のパターンと一致する新しいブランチすべてに関して継続的に通知を受け取ることができます。ブランチの数が多いワークフローでは特に便利です。
特定のパターンのブランチ名 ( "projectname*" など) やプレフィックス ("DEV*" や "DEV/**/rocket*" など) に対して通知を設定することができます。パターンの完全なリストについては、次のヒントをご参照ください。
ブランチ パターンのワイルドカードのヒント
Glob patterns don't allow any expression to start with a star. Every expression that starts with a star needs to be put in quotes.
|
|
|
|
|
|
|
|
|
|
|
|
通知で利用可能なアクション
現在利用可能な通知の一覧です。
セクション | 通知タイプ | 意味 | 通知アクション |
|---|---|---|---|
リポジトリ |
| Repository 通知には一般に次の情報が含まれます。
|
|
| forked | リポジトリがフォークされました。フォークはリポジトリのコピーです。クローンと似ていますが、完全に別のリポジトリとしてコピーされます。 |
|
| commit comment | リポジトリ内の特定のコミットにコメントが追加されました。 | 返信: プル リクエスト コメントに返信するダイアログを開きます。 コメントを表示: Bitbucket Cloud のコミット画面を開いてコメントの全文を表示します。 |
パイプライン |
| パイプライン通知には一般に次の情報が含まれます。
|
|
| pipeline succeed | パイプラインの正常完了 |
|
| pipeline failed | パイプラインの失敗 | Re-run: 失敗したパイプラインを Slack から再び開始できます。 |
| pipeline fixed | 過去に失敗した (または返された) パイプラインを正常に完了 |
|
| デプロイメントの成功 | デプロイメントが成功しました。 |
|
| デプロイメントの停止 | デプロイメントが停止しました。これは手動による停止か、進行中の他のデプロイメントによる自動的な一時停止可能性があります。 |
|
| deployment failed | デプロイメントに失敗したか、エラーが発生しました。 |
|
Build |
| Build 通知には一般に次の情報が含まれます。
|
|
| build succeeded | ビルドが正常に成功しました |
|
| build failed | ビルドを完了できませんでした |
|
ブランチ |
| Branch 通知には一般に次の情報が含まれます。
|
|
| branch created
| リポジトリに新しいブランチが追加されました
|
|
| branch updated | コミットまたは一連のコミットがブランチに追加されました | プル リクエストの作成: Bitbucket Cloud でこのブランチのプル リクエストの作成ページを開きます。 |
| branch merged | ブランチはリポジトリ内の別のブランチに正常にマージされました。 |
|
| branch deleted | リポジトリからブランチが削除されました。 |
|
| force push branch updated 通知をサブスクライブしている場合、この通知が届きます。 | 標準のローカルからリモートの祖先の外部で変更が強制的にプッシュされました。 | プル リクエストの作成: Bitbucket Cloud でこのブランチのプル リクエストの作成ページを開きます。 |
Pull request |
| Pull request 通知には一般に、次の情報が含まれます。
|
|
| pull request created | 新しいプル リクエストが作成されました。 |
|
| pull request updated | プル リクエストに、別の通知に含まれていない更新があります。一般に、ほかのユーザーが新しい変更をソース ブランチにプッシュしたタイミングとなります。 |
|
| pull request approved | ワークスペースのメンバーがこのプル リクエストに承認を追加しました。 | マージ: 承認 済みのプルリクエストを Slack からマージできます。 このアクションは、マージ チェックが有効化されている場合に表示されます。 現在、マージ ボタンは、すべてのマージ チェックが合格したかどうかを示します。マージを開始してマージ チェックが合格しなかった場合はエラーが表示されます。 |
| pull request unapproved | ワークスペースのメンバーがこのプル リクエストの承認を削除しました。 |
|
| pull request merged | プルリクエストは正常にマージされました。 |
|
| pull request declined | プルリクエストが却下され、アクティブではなくなりました。 |
|
| pull request comment | 誰かがプル リクエストにコメントしました。 | 返信: プル リクエスト コメントに返信するダイアログを開きます。 コメントを表示: Bitbucket Cloud のプル リクエスト画面を開いてコメントの全文を表示します。 |
Tag |
| Tag 通知には一般に次の情報が含まれます。
|
|
| tag created | リポジトリに新しいタグが追加されました。 |
|
| tag updated | リポジトリの既存のタグに変更が加えられました。 |
|
| tag deleted | リポジトリからタグが削除されました。 |
|
Issue tracker |
| Issue 通知には一般に次の情報が含まれます。
|
|
| issue created | 新しい課題が作成されました。 |
|
| issue updated | いずれかの課題フィールドに、フィールドの更新や追加などの変更が加えられました。 |
|
| issue comment | 誰かが課題にコメントを追加しました。 | 返信: 課題コメントに返信するダイアログを開きます。 コメントを表示: Bitbucket Cloud の課題の画面を開いてコメントの全文を表示します。 |
| transitioned この通知は、Issue updated 通知をサブスクライブしている場合に送信されます。 | 課題がワークスペースの別のメンバーに割り当てられました。 |
|
Automated responses |
| ようこそメッセージおよび管理者メッセージには通常、次の情報が含まれます。
|
|
| Welcome (direct to administrator) | Bitbucket Cloud for Slack のインストールを完了したときに管理者に表示される最初のメッセージです。アプリをインストールした管理者へのダイレクト メッセージとして表示されます。 |
|
| Welcome (open to the channel) | 関連するワークスペースのすべてのユーザーに最初に表示されるメッセージです。 |
|
| New channel response | アプリをチャンネルに追加したときに自動で送信されるようこそメッセージです。チャンネルの全ユーザーに表示されます。 |
|
| New repository response | 新しいリポジトリがチャンネルに接続されたときの自動メッセージです。チャンネルの全ユーザーに表示されます。Bitbucket Cloud のリポジトリ管理者のみがアクションを実施できます。 | リポジトリ設定を開く: Bitbucket Cloud リポジトリの設定ページを開きます。 |
| Unable to find repository | 誰かがリポジトリへの接続を試みたが、URL が一致するリポジトリが見つからないときの自動応答です。 | Bitbucket を開く: Bitbucket Cloud を開き、管理者がリポジトリを見つけて、通知が適切に設定されているかどうかを確認できるようにします。 |
Slack メッセージをプル リクエストにコメントとして追加する
To make responding to pull requests even easier, Slack includes an Action that allows you to add Slack messages as comments to pull requests.
Slack メッセージをプル リクエストに追加するには、次の手順を利用します。
1. Hover over the message and select the icon.
2. Select Attach to pull request.
3. Select the repository with the pull request.
4. Select the pull request in the repository.
The message then appears as a comment on the pull request you selected, showing the author and the user who added the message. To gain more context around the comment, select the message link to take you back to the conversation in Slack.
Bitbucket Cloud for Slack アプリ用のスラッシュ コマンド
アプリでは複数のスラッシュ コマンドを使用できます。
コマンド | 意味または動作 | 必要な権限 |
|---|---|---|
/bitbucket | Bitbucket Cloud 接続とサブスクリプションの管理 |
|
/bitbucket help | アプリで利用可能なコマンドを一覧表示 |
|
/bitbucket connect <repository url> | リポジトリをサブスクライブして通知を受信 |
|
/bitbucket login | Bitbucket Cloud ワークスペースを Slack ワークスペースにリンク |
|
/bitbucket logout | 現在のアカウントからログアウトして他のユーザーとしてログイン |
|
/bitbucket whoami | 自分がワークスペース内で使用している Bitbucket ユーザーの確認 |
|
/bitbucket feedback | アプリについてのフィードバックを送信 |
|
/bitbucket list | ワークスペースに接続しているすべてのリポジトリの一覧表示 |
|
この内容はお役に立ちましたか?