TeamCity と GitHub の統合方法

TeamCity はフルに機能する GitHub.com と GitHub Enterprise との統合を実現するため、合理的な開発者ワークフローを維持しながら、個々のコミットの品質を検証することができます。

TeamCity では、通常の GitHub.com インスタンスと GitHub Enterprise の両方への接続を作成できます。このチュートリアルでは、GitHub へのビルドステータス情報の返送、プルリクエスト時のビルド、および GitHub 課題トラッカーとの統合を行えるように TeamCity を構成する方法を説明します。

Commit Status Publisher (コミットステータスパブリッシャー)の統合

TeamCity と GitHub に接続するには、Project(プロジェクト)| Build configuration(ビルド構成)| Edit(編集)を開いて Build Feature(ビルド機能)セクションに切り替え、Add new build feature(新しいビルド機能の追加)をクリックして Commit Status Publisher を選択します。

tutorials-img

これは選択できる最初の TeamCity と GitHub の統合です。この統合を構成した状態でビルドが発生すると、ビルドステータスに関する情報(成功の可否)が TeamCity によって GitHub に送り返されます。その後、この情報は GitHub に表示されます。

tutorials-img

この統合を構成するには、Publisher(パブリッシャー)セクションから VCS root(VCS ルート)| GitHub を選択します。GitHub URL と個人用アクセストークンを貼り付ける必要があります。その後、接続をテストできます。

tutorials-img

Pull Requests(プルリクエスト)の統合

使用できる 2 つ目の TeamCity と GitHub の統合は、GitHub の Pull Requests(プルリクエスト)ビルド機能です。詳細は以下のチュートリアルをご覧ください。

課題トラッカーの統合

GitHub には課題トラッカーもあり、TeamCity でそれを統合することも可能です。これを行うには、Project(プロジェクト)| Issue Trackers(課題トラッカー)| Connection type – Github(接続タイプ – GitHub)を開きます。

tutorials-img

表示名を選択し、リポジトリ URL へのリンクを貼り付けます。課題トラッカーへのリンクではなく、リポジトリ URL を必ず使用してください。

tutorials-img

認証方法も選択する必要があります。この TeamCity チュートリアルでは、アクセストークン認証方法を使用しています。

tutorials-img

接続が確立したら、GitHub でコードをコミットした際に TeamCity で変更を確認できるようになります。

tutorials-img

Change(変更)セクションに課題 #3 を参照しているハイパーリンクがあります。このリンクを新しいタブで開くと、GitHub の課題にリダイレクトされます。

tutorials-img

ここではコミットが検証済みであり、ビルドが成功したことを確認できます。Details(詳細)リンクをクリックすると TeamCity の概要ページにリダイレクトされ、そこでビルドに関する詳細を調べることができます。