Bitbucket 統合

リポジトリ

統合バージョン管理システムのリポジトリへのパスを表示します。

必要に応じて、統合を設定した後にリポジトリの場所を編集できます。手順については、リポジトリ設定の編集を参照してください。

メイン YouTrack プロジェクト

VCS 統合がアクティブなプライマリプロジェクトを設定します。

追加プロジェクト

リンクされたリポジトリを 1 つ以上の追加プロジェクトと統合します。

コミット者

コミットメッセージ内のコマンドに関する課題を、指定されたグループのメンバーに更新する機能を制限します。選択したグループのメンバーではないユーザーからの VCS の変更は、関連する課題にまだ関連付けられていますが、コミットで指定されているコマンドはすべて無視されます。

VCS 変更の処理スキーム

コミットメッセージが課題 ID を参照する場合に、VCS の変更を処理する方法を選択します。次のオプションがサポートされています。

• コミットを追加し、コマンドを無視する : コミットメッセージが統合プロジェクトの課題に属する ID を参照している場合、VCS の変更を課題に追加します。コミットメッセージ内のコマンドはすべて無視されます。

• すべてのプロジェクトにコミットを追加し、メインにコマンドを適用します : コミットメッセージが統合プロジェクトの課題に属する ID を参照している場合、VCS の変更を課題に追加します。現在選択されているメインプロジェクトに属する課題にのみコマンドを適用します。

• コミットを追加し、すべてのプロジェクトにコマンドを適用します : コミットメッセージが統合プロジェクトの課題に属する ID を参照している場合、VCS の変更を課題に追加します。コミットメッセージにコマンドが含まれている場合、統合プロジェクトの課題を更新します。

監視対象のブランチ

変更をモニターしたいブランチの名前を保管します。

• + を使用してブランチを含めます。

• ブランチを除外するには、- を使用します。

• branch name の場合は、ブランチの完全修飾名を使用してください。例: refs/heads/<branch name>

• ワイルドカードとして * を使用してください。このプレースホルダは、文字列内の 1 つ以上の文字と一致します。例: すべての機能ブランチを含めるには、次のように使用します。

  +:refs/heads/feature/*

  ブランチパターンごとにワイルドカード文字を 1 つだけ使用できます。複数のアスタリスク文字を含むパターンを指定した場合、最初のアスタリスク文字のみがワイルドカードとして評価されます。

• すべてのブランチを監視するには、入力フィールドを空のままにします。

リポジトリに接続したときにリポジトリ URL として入力したアドレスが特定のブランチを指している場合、このブランチは、接続のセットアップ時に監視対象のブランチのリストに自動的に追加されます。

課題コメントに対するコミットを解析します

有効にすると、コミットメッセージ内の特定のテキスト行がコメントとして課題にコピーされます。コミットメッセージの一部をコメントとして課題にコピーすると、@mention 通知をトリガーし、VCS の変更にアクセスできないユーザーに情報を公開できます。

この設定は、コミットメッセージが VCS の変更にどのように表示されるかには影響しません。コマンドや課題のコメントを含むコミットメッセージ全体は、アクティビティストリームの VCS 変更レコードの一部として常に表示されます。

次の場合にのみこのオプションを有効にしてください。

• コミットメッセージで他のユーザーにメンションし、テキストが issue のコメントにコピーされたときに通知を生成します。

• VCS の変更の可視性を制限し、コミット関連の情報をコメントとして外部ユーザーに見えるようにします。

YouTrack がメッセージをコミットする方法の詳細については、VCS コミットでのコマンドの適用を参照してください。

課題の参照については、ブランチ名を確認してください

有効にすると、統合は、コミットおよびプルリクエストのブランチ名で課題への参照をチェックします。このオプションは、チケットごとのブランチプロセスを使用するチーム向けに追加されたため、開発者はコミットメッセージで課題 ID を明示的にメンションする必要がありません。

VCS 変更の表示対象

VCS 変更の可視性を YouTrack 内の 1 つ以上のユーザーグループに制限します。制限されていない場合、VCS の変更点のリストは、課題を読む権限を持つすべてのユーザーに表示されます。

使用不可

統合プロジェクトと VCS リポジトリ間の接続を遮断します。設定は変更されず、いつでも有効にできます。

編集

選択したプロジェクトとリポジトリのサイドバーにある統合設定ダイアログを開きます。

削除

YouTrack から統合プロジェクトの設定を削除します。

このアクションにより、リンクされたリポジトリのコミットの課題に追加されたすべての VCS の変更も削除されます。

アクション自体を元に戻すことはできませんが、インポートアクションを使用して、誤って削除された VCS の変更を復元できます。

コミットのインポートとプルリクエストのオープン

リンクされたリポジトリのコミット履歴を確認し、コミットメッセージで参照されている課題に VCS の変更を追加します。このオプションは、現在有効になっている統合でのみ使用できます。

このアクションを使用して、統合が誤って削除されたときに削除された VCS の変更を復元したり、新しいプロジェクトの課題へのリンクを移行したりできます。

統合 VCS の Web フックが存在しない、無効になっている、その他の不正な形式です。

VCS リポジトリの設定で Web フックを確認してください。Web フックが存在し、それらが有効になっていることを確認してください。

Web フックに課題があると思われる場合は、VCS の設定で Web フックを削除するか無効にして、YouTrack に新しい VCS 統合を設定してください。

リポジトリへの変更をコミットしたユーザーは、統合設定のコミット者グループのメンバーではありません。

YouTrack で指定されたグループにコミッターを追加するか、統合設定で選択を変更してください。

リポジトリへの変更をコミットしたユーザーには、接続プロジェクトの課題を更新する権限がありません。

これらのユーザーをプロジェクトチームに追加するか、読み取り課題権限と更新の課題権限を含むプロジェクト内のロールを割り当てます。

YouTrack は、コミットメッセージの作成者と一致するユーザーアカウントを見つけることができません。

ユーザーは、YouTrack と Bitbucket の両方のアカウントに同じメールアドレスを使用するか、Bitbucket プロファイルにニックネームとして保存されている値を Hub アカウントの VCS ユーザー名のリストに追加する必要があります。

詳しくは、変更作成者と YouTrack ユーザーの一致を参照してください。

Bitbucket での認証に使用されるユーザー名とパスワードは、リポジトリの所有者ではなく、管理者レベルのアクセス権を持たないユーザーに属しています。この統合では、リポジトリの所有者と管理者アクセスを許可された他のユーザーのみが作成できる Webhook を使用します。

リポジトリのユーザーとグループのアクセス設定にアクセスし、Bitbucket で認証するために使用しているユーザーに管理者アクセス権を付与します。このユーザーがメンバーとなっているグループに管理者アクセス権を付与することもできます。

または、リポジトリで管理者アクセスがすでに許可されているアカウントのユーザー名とパスワードを使用します。