TeamCity 2020.1ヘルプ

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

GitHub(英語)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接続を構成するには:

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

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

  3. アプリケーション登録リンクをクリックします。GitHubページが開きます。
    GitHubでTeamCityをOAuthアプリケーション(英語)として登録する必要があります。
    次の手順は、GitHubアカウントで実行されます。
    • GitHubアカウントにログインします。新しいOAuthアプリケーションの登録ページで、TeamCityが提供する名前とオプションの説明、ホームページURL、コールバックURLを指定します。

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

  4. TeamCityで接続の構成を続行します。開いている接続の追加ページで、クライアントIDとクライアントシークレットを指定します。

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

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

Bitbucketへの接続

URLからプロジェクトを作成する、URLからのVCSルートを作成する、Mercurial VCSルートを作成する、またはBitbucket課題トラッカーを作成するには、パブリックBitbucketリポジトリへの接続を構成する必要があります。

Bitbucket接続を構成するには:

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

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

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

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

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

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

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

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

  5. 接続が設定され、リポジトリURLを指定できる複数の場所で小さなBitbucketアイコンがアクティブになります: URLからプロジェクトを作成、URL から VCSルートを作成、Mercurial VCSルートを作成、Bitbucket課題トラッカーを作成。アイコンをクリックして、Bitbucketにログインし、TeamCityを認証します。TeamCityは、公開リポジトリへのアクセスを許可されます。プライベートリポジトリの場合、Bitbucketは期限切れのないアクセストークンを提供しないため、Bitbucketにサインインする必要があります。関連する議論(英語)を参照してください。

GitLabへの接続

パブリックGitLabリポジトリへの接続を構成して、URLからプロジェクトを作成するか、URLからのVCSルートを作成する必要があります。

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

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

  2. 接続タイプとしてGitLab.comまたはGitLab CE / 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をAzure DevOps Servicesに接続するときに使用するパラメーターが表示されます。

  3. マイクロソフトのドキュメント(英語)の説明に従って、Azure DevOps Servicesアカウントにログインして、すべての範囲で個人用アクセストークンを作成します。

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

    • 個人アクセストークン

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

  6. 接続が設定され、リポジトリURLを指定できるいくつかの場所で小さなAzure DevOps Servicesアイコンがアクティブになります: URLからプロジェクトを作成、URL から VCSルートを作成、TFS VCSルートを作成、Team Foundation作業項目トラッカーを作成。アイコンをクリックして、Azure DevOps Servicesにログインし、TeamCityを認証します。TeamCityは、利用可能なすべてのリソースへのフルアクセスを許可されます。
    TeamCity 2017.2 EAP1以降は、TFS / VSTSでホストされるGitリポジトリのコミットステータスパブリッシャーを構成するときに、VSTSプロジェクト接続が構成されている場合、個人アクセストークンを自動的に入力できます。

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

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

Available Bitbucket repositories

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