TeamCity 2020.2 ヘルプ

TeamCity と VCS ホスティングサービスの統合

GitHub.com(英語)GitHub Enterprise(英語)Bitbucket クラウド(英語)GitLab.com(英語)、または GitLab CE/ EE(英語) に組織アカウントがある場合は、TeamCity をこれらのソースコードホスティングサービスに接続して、組織ユーザーが新しいプロジェクト、Git または Mercurial VCS ルート、GitHub または Bitbucket を簡単に作成できるようにすることができます。すぐに利用できるサポートされているトラッカー。

TeamCity を Azure DevOps サービス(英語)に接続して、VSTS リポジトリまたは課題追跡を使用するプロジェクトの設定を本当に簡単にすることもできます。

接続を構成

接続はプロジェクトレベルで作成され、構成された接続は現在のプロジェクトとそのすべてのサブプロジェクトでアクセスできます。GitHub や Bitbucket Cloud などのグローバル VCS ホスティングサービスを使用する場合は、ルートプロジェクトに単一の接続を構成するのが理にかなっています。または、組織管理者が親プロジェクトを作成し、そこで GitHub への接続を一度構成すると、ユーザーは TeamCity Web UI に GitHub リポジトリの URL のリストを表示できるため、サブプロジェクトの設定が非常に簡単になります。

接続はプロジェクト管理 | 接続ページで構成されます。

Adding a GitHub connection

TeamCity が提供する情報を使用して TeamCity アプリケーションを VCS ホスティングサービスに登録し、TeamCity フォームにサービスが提供するアクセス詳細を入力し、TeamCity から VCS ホスティングサービスにログインして、VCS の TeamCity アプリケーションを承認する必要があります。以下の詳細を参照してください。

GitHub への接続

GitHub URL からプロジェクトを作成する、URL からの VCS ルートを作成する、Git VCS ルートを作成する、GitHub 課題追跡システムを作成する、または GitHub 認証を有効にするには、GitHub リポジトリ接続が必要です。

GitHub 接続を構成するには:

  1. プロジェクト管理 | 接続で、コネクションの追加をクリックします。

  2. 接続型として GitHub.com または GitHub のエンタープライズを選択します。開いたページには、TeamCity アプリケーションを GitHub サービスに登録するときに使用するパラメーターが表示されます。

  3. 登録申請リンクをクリックします。GitHub ページが開きます。
    TeamCity を OAuth アプリケーション(英語)として GitHub に登録する必要があります。
    GitHub アカウントでは、次の手順が実行されます。

    • GitHub アカウントにサインインします。新しい OAuth アプリケーションを登録するページで、名前とオプションの説明、ホームページ URL、TeamCity によって提供されるコールバック URL を指定します。

    • アプリケーション登録をクリックします。ページは、TeamCity アプリケーションのクライアント ID とクライアントシークレット情報で更新されます。

  4. TeamCity で接続の構成を続行します。コネクションの追加ページで、次のように指定します。

    • アプリケーション ID
    • シークレット
    • サーバー URL (GitHubEnterprise のみ )

  5. 接続設定を保存します。

  6. 接続が構成され、リポジトリ URL を指定できるいくつかの場所で小さな GitHub アイコンがアクティブになります: URL からプロジェクトを作成、URL から VCS ルートを作成、Git VCS ルートを作成、GitHub 課題追跡システムを作成します。アイコンをクリックし、GitHub にログインして、TeamCity を認証します。許可されたアプリケーションには、プライベートリポジトリの完全な制御と、リポジトリフック書き込み権限が付与されます。

Bitbucket クラウドへの接続

Bitbucket URL からプロジェクトを作成する、URL からの VCS ルートを作成する、Mercurial VCS ルートを作成する、Bitbucket 課題追跡システムを作成する、または BitBucket Cloud 認証を有効にするには、Bitbucket クラウド接続が必要です。

Bitbucket クラウド接続を構成するには:

  1. プロジェクト管理 | 接続で、コネクションの追加をクリックします。

  2. 接続型として Bitbucket を選択します。
    開いたページには、Bitbucket クラウドに OAuth コンシューマーを登録するときに使用するパラメーターが表示されます。登録申請リンクをクリックします
    Bitbucket クラウド上に OAuth コンシューマー(英語)を作成する必要があります。Bitbucket アカウントでは、次の手順が実行されます。
    1. Bitbucket アカウントにログインし、アバターをクリックして、メニューから Bitbucket 設定を選択します。アカウントページが開きます。

    2. メニューバーから OAuth をクリックします。OAuth コンシューマーを追加するページで、名前とオプションの説明、コールバック URL、TeamCity が提供する URL を指定します。

    3. 権限のセットを指定します。TeamCity には、アカウントとリポジトリへの「読み取り」アクセスが必要です。

    4. 設定を保存してください。

    5. 開いたページの OAuth コンシューマーセクションで、TeamCity アプリケーションの名前をクリックして、キーとシークレットを表示します。

  3. TeamCity で接続の構成を続けます。開いているコネクションの追加ページで、キーとシークレットを指定します。

  4. 接続設定を保存します。

  5. 接続が構成され、リポジトリ URL を指定できるいくつかの場所で小さな Bitbucket アイコンがアクティブになります: URL からプロジェクトを作成、URL から VCS ルートを作成、Mercurial VCS ルートを作成、Bitbucket 課題追跡システムを作成します。アイコンをクリックし、Bitbucket にログインして、TeamCity を認証します。TeamCity はあなたの公開リポジトリへのアクセスを許可されます。プライベートリポジトリの場合、Bitbucket クラウドは有効期限のないアクセストークンを提供しないため、TeamCity による認証に使用する Bitbucket 資格情報を提供する必要があります。関連するディスカッション(英語)を参照してください。

GitLab への接続

GitLab URL からプロジェクトを作成する、URL からの VCS ルートを作成する、または GitLab 認証を有効にするには、GitLab 接続が必要です。

TeamCity で GitLab 接続を構成するには:

  1. プロジェクト管理 | 接続で、コネクションの追加をクリックします。

  2. 接続タイプとして GitLab.com または GitLabCE/ EE を選択します。

  3. TeamCity は、GitLab に OAuth アプリケーションを登録するために必要なリダイレクト URL を表示します
    アプリケーションを登録するには、この指示(英語)に従ってください(英語)。TeamCity リダイレクト URLリダイレクト URI として挿入し、api スコープ(英語)を選択します。アプリケーションを保存し、GitLab によって生成されたシークレットアプリケーション ID をコピーします。

  4. 準備ができたら、TeamCity の接続の構成に戻り、次のフィールドに入力します。
    • アプリケーション ID
    • シークレット
    • サーバー URL (GitLab CE/ EE のみ )

  5. 接続設定を保存します。

  6. 接続が設定され、リポジトリの URL を指定できるいくつかの場所で小さな GitLab アイコンがアクティブになります。URL からプロジェクトを作成し、URL から VCS ルートを作成します。アイコンをクリックして GitLab にサインインし、TeamCity を承認します。TeamCity はリポジトリへのアクセスを許可されます。

Azure DevOps Services への接続

Azure DevOps Services(または Azure DevOps Server、以前は Team Foundation Server)への接続を構成して、URL からプロジェクトを作成、URL からの VCS ルートを作成、TFS VCS ルートを作成、または Team Foundation 作業項目トラッカーを作成できます。

Azure DevOps Services への接続を構成するには、次の手順を実行します。

  1. プロジェクト管理 | 接続で、コネクションの追加をクリックします。

  2. 接続型として Azure DevOps サービスを選択します。
    開いたページには、TeamCity を AzureDevOps サービスに接続するときに使用するパラメーターが表示されます。

  3. Azure DevOps Services アカウントにログインして、マイクロソフトのドキュメント(英語)の説明に従って、すべてのスコープを持つパーソナルアクセストークンを作成します。

  4. TeamCity で接続の構成を続けます: 開いているコネクションの追加ページで、指定します
    • https://{account}.visualstudio.com 形式のサーバー URL または https://{server}:8080/tfs/ としての Team Foundation サーバー Web ポータル

    • 個人アクセストークン

  5. 接続設定を保存します。

  6. The connection is configured, and now a small Azure DevOps Services icon becomes active in several places where a repository URL can be specified: create project from URL, create VCS root from URL, create TFS VCS root, create Team Foundation 作業項目 tracker. Click the icon, log in to Azure DevOps Services and authorize TeamCity. TeamCity will be granted full access to all of the resources that are available to you.
    When configuring Commit Status Publisher for Git repositories hosted in TFS/VSTS, the personal access token can be filled out automatically if a VSTS project connection is configured.

TeamCity の URL からエンティティを作成する

TeamCity の URL からエンティティを作成するのは非常に簡単です: GitHub、Bitbucket、GitLab、または VSTS アイコンをクリックすると、現在のユーザーが利用できるリポジトリのリストが表示されます(設定された接続を介して公開されている Bitbucket リポジトリのみが利用できることに注意してください)。

Available Bitbucket repositories

URL を選択して、構成を続行できます。