TeamCity と GitHub Issues の統合
GitHub の問題(英語)を使用すると、開発チームは現在の問題に優先順位を付け、それを実行可能なタスクに分割し、そのステータスを追跡できます。
コミットメッセージに既存の課題への参照が含まれている場合、TeamCity はビルド履歴ページと ビルド結果 ページにこの課題へのリンクを表示します。
この統合は、 プルリクエスト 機能が構成されたプロジェクトでも動作します。プルリクエストが既存の課題に言及している場合、TeamCity は対応するデータを UI に表示します。
この統合が実施されると、GitHub 問題 ID パターン (たとえば、 #054) に一致する文字列は、対応する GitHub 問題への参照として扱われ、クリック可能なリンクに変換されることに注意してください。 例: ビルドステータスを手動で「成功」または「失敗」に切り替える理由を記述するときに、問題を参照できます。
GitHub リポジトリにこの ID に関する問題がない場合、 課題が見つかりません ヒントが表示されます。
GitHub 課題の統合を構成する
開始する前に、リポジトリで GitHub 問題機能が 有効になっており(英語) 、アクティブな問題が少なくとも 1 つあることを確認してください。
プロジェクト設定を開き、 課題トラッカー設定タブに移動します。
新しい接続を作成 をクリックし、接続タイプとして GitHub を選択します。
統合の公開名を入力します。 このお名前は TeamCity UI でのみ使用されます。
リポジトリ URL と認証フィールドに入力します。 すべてのデータを手動で入力することも、既存の GitHub 接続を活用することもできます。
リポジトリ URL フィールドに、リポジトリのメインページの URL (クローン URL ではありません) を入力します。 例:
https://github.com/johndoe/my-repo(https://github.com/johndoe/my-repo.gitやgit@github.com:johndoe/my-repo.gitではありません)。必要な 認証 メソッドを選択します。
匿名 認証は、ユーザーのログインを必要としないパブリックリポジトリや問題に使用できます。
アクセストークン には、GitHub で発行された静的な 個人トークン(英語)が必要です。
GitHub アプリのアクセストークン は、動的な非個人トークンを活用する最も安全なオプションです。 指定した URL のリポジトリが既存の GitHub アプリ接続経由で利用できる場合、TeamCity はこのオプションを表示します。 リフレッシュ可能なトークンの詳細については、次の記事を参照してください: 更新可能なアクセストークンを管理する。
リポジトリ URL フィールドの横にある GitHub アイコンをクリックします。
TeamCity は、関連する接続を通じて利用可能なリポジトリをスキャンします。 必要なリポジトリを選択すると、必要なすべてのオプション (認証設定を含む) が自動的に入力されます。
課題 ID パターンフィールドで、このプロジェクトに属する課題をフィルターする正規表現パターンを指定します。 通常は、デフォルト設定の
#(\d+)のままにできます。 詳細については、この記事を参照してください: 文字列を課題へのリンクに変換する接続をテスト をクリックし、ダイアログの指示に従って課題トラッカー接続をテストします。
作成 をクリックして設定を保存し、セットアップを終了します。
Kotlin DSL
Kotlin DSL で TeamCity-GitHub の課題統合を作成するには、新しい githubIssues オブジェクトをプロジェクトの 機能 ブロックに追加します。