Bitbucket 統合
YouTrack のプロジェクトを、bitbucket.org(英語) でホストされる VCS リポジトリと統合できます。
Bitbucket 統合により、YouTrack で以下の機能が有効になります。
コミットメッセージの YouTrack 課題にコマンドを適用します。詳細については、VCS コミットでのコマンドの適用を参照してください。
各課題について、アクティビティストリーム内の特定の課題に関連するコミットを追跡します。詳しくは、コミット数を参照してください。
プル(マージ)リクエストのステータスを、プルリクエストのタイトルまたは説明で参照されている課題のアクティビティストリームに直接表示します。詳細については、プルリクエストを参照してください。
コミットメッセージまたはブランチ名に YouTrack の課題へのリンクを追加します。詳細については、VCS コミットのリンクの課題を参照してください。
前提条件
YouTrack はインバウンド接続にアクセス可能です。具体的には、ネットワークが VCS サーバーと YouTrack の間の接続をブロックしていないことを確認する必要があります。
Bitbucket への接続に使用するアカウントは、リポジトリの所有者であるか、リポジトリへの管理者レベルのアクセス権を持っています。これは、ユーザー名とパスワードが認証に使用されるユーザーアカウントです。リポジトリへの管理者レベルのアクセス権を持たないアカウントを使用すると、
unable to perform operation
エラーが発生します。
Bitbucket 統合を構成する
最初のステップは、プロジェクトと YouTrack および Bitbucket 内のリポジトリとの間の接続を確立することです。Bitbucket に接続するには、Bitbucket アカウントの認証情報を入力する必要があります。この認証は、Bitbucket で自分のアカウントに付与されているアクセスに基づいて、YouTrack にリポジトリへのアクセスを許可します。
統合を設定するために使用するフォームは、あなたの Bitbucket アカウントのパスワードまたはアプリのパスワードのいずれかを受け入れます。アプリのパスワードを使用することを強くお勧めします。
Bitbucket リポジトリに接続するには:
YouTrack で
ページを開きます。
新しい VCS 統合ボタンをクリックしてください。
メイン YouTrack プロジェクトリストから、VCS リポジトリと統合するプライマリプロジェクトの名前を選択します。リポジトリへの接続を設定した後で、追加の YouTrack プロジェクトとの統合を追加できます。
サーバータイプの場合は、Bitbucket を選択します。
Bitbucket リポジトリを指す URL をリポジトリ URL 入力フィールドに貼り付けます。
Bitbucket アカウントのユーザー名とパスワードを入力します。
パスワード入力フィールドはあなたの Bitbucket アカウントのパスワードかアプリのパスワードのどちらかを受け付けます。
アプリのパスワードを作成するには、アプリのパスワードを作成するリンクをクリックして Bitbucket のアカウントにアクセスします。この統合用のアプリパスワードには、次の権限が必要です。
カテゴリ
アクセス権
リポジトリ
読む、管理者
プルリクエスト
読み取り
課題
読み取り
Web フック
読み書き
保存ボタンをクリックしてください。
YouTrack プロジェクトは Bitbucket で選択したリポジトリと統合されています。
プロジェクト内の課題を参照する Bitbucket リポジトリからのコミットは、参照されている課題のアクティビティストリームに表示されます。
サイドバーには、VCS 統合を設定するための追加設定が表示されます。
これらの設定の詳細については、統合設定を参照してください。
統合設定
デフォルトでは、VCS 統合は、任意のブランチの任意のユーザーによってリポジトリにコミットされた変更を処理します。YouTrack で課題にアクセスできるユーザーは、課題アクティビティストリームでこれらの変更を確認できます。
指定されたブランチで特定のユーザーによる変更のみを処理する場合、または YouTrack での VCS 変更の表示を制限する場合は、統合設定をカスタマイズできます。統合をカスタマイズするには、次の設定を使用します。
設定 | 説明 |
---|---|
リポジトリ | 統合バージョン管理システムのリポジトリへのパスを表示します。 必要に応じて、統合を設定した後にリポジトリの場所を編集できます。手順については、リポジトリ設定の編集を参照してください。 |
メイン YouTrack プロジェクト | VCS 統合がアクティブなプライマリプロジェクトを設定します。 |
追加プロジェクト | リンクされたリポジトリを 1 つ以上の追加プロジェクトと統合します。 |
コミット者 | コミットメッセージ内のコマンドに関する課題を、指定されたグループのメンバーに更新する機能を制限します。選択したグループのメンバーではないユーザーからの VCS の変更は、関連する課題にまだ関連付けられていますが、コミットで指定されているコマンドはすべて無視されます。 |
VCS 変更の処理スキーム | コミットメッセージが課題 ID を参照する場合に、VCS の変更を処理する方法を選択します。次のオプションがサポートされています。
|
監視対象のブランチ | 変更をモニターしたいブランチの名前を保管します。
リポジトリに接続したときにリポジトリ URL として入力したアドレスが特定のブランチを指している場合、このブランチは、接続のセットアップ時に監視対象のブランチのリストに自動的に追加されます。 |
課題コメントに対するコミットを解析します | 有効にすると、コミットメッセージ内の特定のテキスト行がコメントとして課題にコピーされます。コミットメッセージの一部をコメントとして課題にコピーすると、@mention 通知をトリガーし、VCS の変更にアクセスできないユーザーに情報を公開できます。 この設定は、コミットメッセージが VCS の変更にどのように表示されるかには影響しません。コマンドや課題のコメントを含むコミットメッセージ全体は、アクティビティストリームの VCS 変更レコードの一部として常に表示されます。 次の場合にのみこのオプションを有効にしてください。
YouTrack がメッセージをコミットする方法の詳細については、VCS コミットでのコマンドの適用を参照してください。 |
課題の参照については、ブランチ名を確認してください | 有効にすると、統合は、コミットおよびプルリクエストのブランチ名で課題への参照をチェックします。このオプションは、チケットごとのブランチプロセスを使用するチーム向けに追加されたため、開発者はコミットメッセージで課題 ID を明示的にメンションする必要がありません。 |
VCS 変更の表示対象 | VCS 変更の可視性を YouTrack 内の 1 つ以上のユーザーグループに制限します。制限されていない場合、VCS の変更点のリストは、課題を読む権限を持つすべてのユーザーに表示されます。 |
使用可能なアクション
リストで統合バージョン管理システムを選択すると、ツールバーで次のアクションを使用できます。
アクション | 説明 |
---|---|
使用不可 | 統合プロジェクトと VCS リポジトリ間の接続を遮断します。設定は変更されず、いつでも有効にできます。 |
編集 | 選択したプロジェクトとリポジトリのサイドバーにある統合設定ダイアログを開きます。 |
削除 | YouTrack から統合プロジェクトの設定を削除します。 このアクションにより、リンクされたリポジトリのコミットの課題に追加されたすべての VCS の変更も削除されます。 アクション自体を元に戻すことはできませんが、インポートアクションを使用して、誤って削除された VCS の変更を復元できます。 |
コミットのインポートとプルリクエストのオープン | リンクされたリポジトリのコミット履歴を確認し、コミットメッセージで参照されている課題に VCS の変更を追加します。このオプションは、現在有効になっている統合でのみ使用できます。 このアクションを使用して、統合が誤って削除されたときに削除された VCS の変更を復元したり、新しいプロジェクトの課題へのリンクを移行したりできます。 |
トラブルシューティング
状態 — YouTrack での VCS の変更として、VCS コミットの課題への参照は表示されません。
原因 | ソリューション |
---|---|
統合 VCS の Web フックが存在しない、無効になっている、その他の不正な形式です。 | VCS リポジトリの設定で Web フックを確認してください。Web フックが存在し、それらが有効になっていることを確認してください。 Web フックに課題があると思われる場合は、VCS の設定で Web フックを削除するか無効にして、YouTrack に新しい VCS 統合を設定してください。 |
条件 — VCS コミットで指定されたコマンドは、YouTrack の課題には適用されません。
原因 | ソリューション |
---|---|
リポジトリへの変更をコミットしたユーザーは、統合設定のコミット者グループのメンバーではありません。 | YouTrack で指定されたグループにコミッターを追加するか、統合設定で選択を変更してください。 |
リポジトリへの変更をコミットしたユーザーには、接続プロジェクトの課題を更新する権限がありません。 | これらのユーザーをプロジェクトチームに追加するか、読み取り課題権限と更新の課題権限を含むプロジェクト内のロールを割り当てます。 |
YouTrack は、コミットメッセージの作成者と一致するユーザーアカウントを見つけることができません。 | ユーザーは、YouTrack と Bitbucket の両方のアカウントに同じメールアドレスを使用するか、Bitbucket プロファイルにニックネームとして保存されている値を Hub アカウントの VCS ユーザー名のリストに追加する必要があります。 詳しくは、変更作成者と YouTrack ユーザーの一致を参照してください。 |
状態 — Bitbucket リポジトリとの接続を確立しようとすると、YouTrack はエラー unable to perform operation
を返します。以下の手順に従って課題を解決してください。
原因 | ソリューション |
---|---|
Bitbucket での認証に使用されるユーザー名とパスワードは、リポジトリの所有者ではなく、管理者レベルのアクセス権を持たないユーザーに属しています。この統合では、リポジトリの所有者と管理者アクセスを許可された他のユーザーのみが作成できる Webhook を使用します。 | リポジトリのユーザーとグループのアクセス設定にアクセスし、Bitbucket で認証するために使用しているユーザーに管理者アクセス権を付与します。このユーザーがメンバーとなっているグループに管理者アクセス権を付与することもできます。 または、リポジトリで管理者アクセスがすでに許可されているアカウントのユーザー名とパスワードを使用します。 |
関連ページ:
![](https://resources.jetbrains.com/help/img/youtrack/2024.2/command-related-notifications.png)
VCS コミットでのコマンドの適用
バージョン管理システムのコードリポジトリへの変更をコミットするときに、コマンドを課題に適用できます。YouTrack を開く必要すらありません。これらの変更を適用するには、特別な形式を使用して、コミットメッセージでコマンドを指定します。YouTrack でサポートされているコマンドの完全なリストについては、コマンドリファレンスを参照してください。コミットメッセージに課題へのリンクを追加する方法をすでに見たかもしれません。これはさらに一歩進んだものです。課題とバージョン管理システム間を移動するのに...
![](https://resources.jetbrains.com/help/img/youtrack/2024.2/vcs-changes-activity-stream.png)
VCS の変更の表示と編集
アクティビティストリームには、現在の課題に関連付けられている VCS 変更のリストが表示されます。これらのイベントは、VCS の変更フィルターが有効になっている場合に表示されます。YouTrack は、バージョン管理システムに直接統合することも、バージョン管理に接続されたビルドサーバーを介して統合することもできます。統合の表示設定が 1 つ以上のグループに制限されている場合、指定したグループのいずれかのメンバーである場合にのみ、VCS の変更が表示されます。課題がメンションされたとき、名前に課題...
![](https://pleiades.io/icons/youtrack.png)
VCS コミットのリンクの課題
ソフトウェア開発チームは、課題に応じてアプリケーションコードに変更を適用することがよくあります。これらの更新は通常、バージョン管理システム(VCS)に適用されます。コードを VCS リポジトリにコミットする場合、変更内容とその理由を説明するコミットメッセージを書き込むオプションがあります。YouTrack サーバーが VCS リポジトリと統合されている場合は、コミットメッセージまたはブランチ名で課題を参照できます。これらの参照は、リポジトリ、ビルド、YouTrack の課題へのコミットを指すリン...
![](https://resources.jetbrains.com/help/img/youtrack/2024.2/project-administration-vcs-integration.png)
Bitbucket と統合する
YouTrack のプロジェクトを、bitbucket.org でホストされる VCS リポジトリと統合できます。Bitbucket 統合により、YouTrack で以下の機能が有効になります。コミットメッセージの YouTrack 課題にコマンドを適用します。詳細については、VCS コミットでのコマンドの適用を参照してください。各課題について、アクティビティストリーム内の特定の課題に関連するコミットを追跡します。詳しくは、コミット数を参照してください。プル(マージ)リクエストのステータスを、プル...
![](https://resources.jetbrains.com/help/img/youtrack/2024.2/gitlab-integration-setup.png)
GitLab の統合
このページの指示に従って、gitlab.com、自己ホスト GitLab Community Edition(CE)、または自己ホスト GitLab Enterprise Edition(EE) サーバーでホストされている VCS リポジトリと統合します。GitLab の統合により、YouTrack で次の機能が有効になります。コミットメッセージの YouTrack 課題にコマンドを適用します。詳細については、VCS コミットでのコマンドの適用を参照してください。各課題について、アクティビティス...
![](https://resources.jetbrains.com/help/img/youtrack/2024.2/bitbucket-server-new-vcs-integration.png)
Bitbucket サーバー統合
YouTrack のプロジェクトを、自己ホスト Bitbucket サーバー上の VCS リポジトリと統合できます。Bitbucket サーバーとの統合により、YouTrack で次の機能が有効になります。コミットメッセージの YouTrack 課題にコマンドを適用します。詳細については、VCS コミットでのコマンドの適用を参照してください。各課題について、アクティビティストリーム内の特定の課題に関連するコミットを追跡します。詳しくは、コミット数を参照してください。プル(マージ)リクエストのステ...