TeamCity と GitHub の統合の問題

GitHub の問題(英語)を使用すると、開発チームは現在の問題に優先順位を付け、それを実行可能なタスクに分割し、そのステータスを追跡できます。

コミットメッセージに既存の問題への参照が含まれている場合、TeamCity はビルド履歴とビルド結果ページにこの問題へのリンクを表示します。

この統合は、プルリクエスト機能が構成されたプロジェクトでも機能します。プルリクエストに既存の問題が記載されている場合、TeamCity は UI に対応するデータを表示します。

この統合が実施されると、GitHub 問題 ID パターン (たとえば、#054) に一致する文字列は、対応する GitHub 問題への参照として扱われ、クリック可能なリンクに変換されることに注意してください。例: ビルドステータスを手動で「成功」または「失敗」に切り替える理由を記述するときに、問題を参照できます。

GitHub リポジトリにこの ID に関する問題がない場合、問題が見つかりませんヒントが表示されます。

GitHub Issues 統合を構成する

開始する前に、リポジトリで 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 の問題統合を作成するには、プロジェクトの features ブロックに新しい githubIssues オブジェクトを追加します。

project {
    // ...
    features {
        githubIssues {
            id = "PROJECT_EXT_17"
            displayName = "Default GH Issue Tracker"
            repositoryURL = "..."
            authType = storedToken {
                tokenId = "..."
            }
        }
    }
}

2025 年 4 月 07 日

関連ページ：

ビルド結果ページ

TeamCity では、ビルドに関するすべての情報 (キューに入っているか、実行中か、完了しているかに関係なく) がビルド結果ページに蓄積されます。ビルド結果を表示するには、任意の構成を選択してビルド履歴を表示し、必要なビルド番号をクリックします。このページには、いくつかの静的タブ (概要、変更、ビルドログ、アーティファクトなど) と、特定の構成機能に応じて表示が決まるコンテキストタブが含まれます。例: 依存関係タブは、親構成がビルドチェーンに属するビルドに対してのみ表示されます。内部ビルド ID...

プルリクエスト

プルリクエストビルド機能は、GitHub、Bitbucket サーバー、Bitbucket クラウド、GitLab、Azure DevOps、JetBrains Space リポジトリのプル (マージ) リクエストとの TeamCity 統合を強化します。共通情報：ビルド構成にプルリクエスト機能を追加すると、次のことが可能になります。ビルド構成の概要ページで、プルリクエストブランチと保留中の変更を表示します。

ビルドの主なアクション

この記事では、TeamCity のビルドに適用できるアクションについて説明します。ビルド実行：TeamCity では、ビルドを実行できます。自動的に、さまざまなビルドトリガーを使用します。手動で、オンデマンド。ビルドを手動で実行するには、画面の右上隅にある実行をクリックします。このアクションは、編集モードと表示モードモードの両方で使用できます。特定のビルド構成で実行ボタンが表示されない場合は、そのビルド構成でビルドを開始するための権限が不足していることを意味します。実行ボタンの横にあるコンテキ...

プロジェクト管理者ガイド

このセクションでは、プロジェクト管理に焦点を当てます。TeamCity プロジェクトとビルド構成の作成、ビルドステップの設定、依存関係チェーンの構成などについて説明します。基本的な TeamCity ワークフロー：次のダイアグラムは、基本的な TeamCity ワークフローを示しています。TeamCity サーバーはリポジトリの変更を検出しました。サーバーはこの変更をデータベースに書き込みます。ビルド構成に添付されたトリガーは、データベース内の関連する変更を検出し、ビルドを開始します。トリガー...

接続を構成

TeamCity 接続は、外部サービスへのアクセスに必要な資格情報を保存します。このサードパーティサービスの種類に基づいて、2 つの主要な接続カテゴリがあります。VCS 接続これらの接続は、GitHub、GitLab、Bitbucket クラウドなどの VCS プロバイダーへのアクセスに必要な情報を保存します。これらの接続は、プロジェクト、ビルド構成、パイプラインを最も速く作成する方法を提供します。認証は自動的に処理されるため、リポジトリを選択するだけでビルドステップの設定を開始できます。接続が...

リフレッシュ可能なアクセストークンの管理

TeamCity には、機能上 VCS ホスティングプロバイダーへのアクセスを必要とするエンティティが複数あります:VCS ルート、コミットステータスパブリッシャー、プルリクエスト機能など。これらのエンティティは通常、複数の VCS 認証オプションを提供します。通常のユーザー名 / ログイン資格情報 — この認証方法は最も脆弱であるため、主要な VCS ホスティングプロバイダーによって徐々に廃止されています。個人アクセストークン (PAT) — VCS プロバイダー側で発行され、TeamCity...