TeamCity 2020.1ヘルプ

プロジェクトの作成と編集

このセクションではTeamCity Web UIを介したプロジェクトの作成について詳しく説明します。その他のオプションには、REST APIKotlin言語に基づくDSLでTeamCityプロジェクト構成を使用することが含まれます。

プロジェクトを作成

プロジェクトを作成するには、右上隅にある管理リンクを使用してプロジェクトの作成をクリックします。プロジェクトの作成ページが表示されます。

プロジェクトを作成する方法はいくつかあります。

デフォルトでは、リポジトリのURLから手動の2つのオプションしか使用できません。一部のVCSホスティングサービスへの接続がルートプロジェクト(または作成するプロジェクトの親プロジェクト)で設定されている場合は、対応するオプションが利用可能になるため、既存のVCS接続仕様を使用してプロジェクトを作成できます。

サブプロジェクトを作成するには、親プロジェクトのプロジェクト設定ページに移動し、プロジェクトの作成と同様に、使用可能なオプションのいずれかを使用します。

リポジトリURLを指すプロジェクトを作成する

1. On the プロジェクトの作成 page, select to create a project from a repository URL.

2. プロジェクト設定を指定します。

設定

説明

親プロジェクト

ドロップダウンから親プロジェクトを選択します。

リポジトリ URL

VCSリポジトリURL。TeamCityは、Subversion、Git、およびMercurialのURLを認識します。TFSおよびPerforceは部分的にサポートされています。

このフィールドの隣のアイコンは、TeamCityによってサポートされているVCSホスティングサービスを表します。アクティブな(強調表示された)アイコンをクリックすると、既存の接続仕様を選択することができます。無効なアイコンをクリックすると、コネクションの追加フォームにリダイレクトされます。

ユーザー名

リポジトリへのアクセスに認証が必要な場合はユーザー名を入力してください

パスワード

リポジトリへのアクセスに認証が必要な場合はユーザー名を入力してください

3. Click Proceed. TeamCity will configure the rest of settings for you.

  • それはVCSリポジトリの種類を決定し、VCSリポジトリ設定を自動設定し、プロジェクト名とビルド設定名を提案します。

  • プロジェクト、ビルド構成、およびVCSルートが自動的に作成されます。

  • TeamCityはVCSビルドトリガーを追加します。

  • TeamCityは、ビルドステップAnt、NAnt、Gradle、Maven、MSBuild、Visual Studioソリューションファイル、PowerShell、Xcodeプロジェクトファイル、Rake、およびIntelliJ IDEAプロジェクトの自動検出を試みます。

4. 自動検出ビルドステップページで、ビルド構成で使用する検出されたステップを選択します。選択を使用をクリックします。ステップが見つからない場合は、ビルドステップを手動で構成する必要があります。

5. Your project and a build configuration are configured. Click the 実行 button to start the build.
Depending on the build configuration settings, TeamCity can suggest some additional configuration options. Review Suggestions at the end of the settings list and configure required ones.

GitHub.comリポジトリを指すプロジェクトを作成する

  1. プロジェクトの作成ページで、プロジェクトGitHub.comからを作成するように選択します。

  2. リポジトリを選択してください。TeamCityはリポジトリ接続を確認します。接続が確認されると、新しいページが開きます。

  3. TeamCity will display the project and build configuration name. If required, modify the names and click Proceed.

  4. TeamCity will add a VCS build trigger and attempt to auto-detect build steps: Ant, NAnt, Gradle, Maven, MSBuild, Visual Studio solution files, PowerShell, Xcode project files, Rake, and IntelliJ IDEA projects.
    On the 自動検出ビルドステップ page, select the detected step(s) to use in your build configuration. Click 選択を使用 .
    If no steps found, you will have to configure build steps manually.

  5. プロジェクトとビルド構成が構成されました。実行をクリックしてビルドを開始します。ビルド構成設定に応じて、TeamCityはいくつかの追加構成オプションを提案することができます。設定リストの最後にある提案を見直し、必要なものを設定してください。

Bitbucketクラウドを指すプロジェクトを作成する

  1. On the プロジェクトの作成 page, select to create a project from Bitbucket Cloud.

  2. リポジトリを選択してください。TeamCityはリポジトリ接続を確認します。接続が確認されると、新しいページが開きます。

  3. TeamCity will display the project and build configuration name. If required, modify the names and click Proceed.

  4. TeamCity will add a VCS build trigger and attempt to auto-detect build steps: Ant, NAnt, Gradle, Maven, MSBuild, Visual Studio solution files, PowerShell, Xcode project files, Rake, and IntelliJ IDEA projects.
    On the 自動検出ビルドステップ page, select the detected step(s) to use in your build configuration. Click 選択を使用 .
    If no steps found, you will have to configure build steps manually.

  5. プロジェクトとビルド構成が構成されました。実行をクリックしてビルドを開始します。ビルド構成設定に応じて、TeamCityはいくつかの追加構成オプションを提案することができます。設定リストの最後にある提案を見直し、必要なものを設定してください。

GitLab.comを指すプロジェクトを作成する

  1. プロジェクトの作成ページで、プロジェクトGitLab.comからを作成するように選択します。

  2. リポジトリを選択してください。TeamCityはリポジトリ接続を確認します。接続が確認されると、新しいページが開きます。

  3. TeamCity will display the project and build configuration name. If required, modify the names and click Proceed.

  4. TeamCity will add a VCS build trigger and attempt to auto-detect build steps: Ant, NAnt, Gradle, Maven, MSBuild, Visual Studio solution files, PowerShell, Xcode project files, Rake, and IntelliJ IDEA projects.
    On the 自動検出ビルドステップ page, select the detected step(s) to use in your build configuration. Click 選択を使用 .
    If no steps found, you will have to configure build steps manually.

  5. プロジェクトとビルド構成が構成されました。実行をクリックしてビルドを開始します。ビルド構成設定に応じて、TeamCityはいくつかの追加構成オプションを提案することができます。設定リストの最後にある提案を見直し、必要なものを設定してください。

Azure DevOps Servicesを指すプロジェクトを作成する

  1. On the プロジェクトの作成 page, select to create project from Azure DevOps Services.

  2. リポジトリを選択してください。TeamCityはリポジトリ接続を確認します。接続が確認されると、新しいページが開きます。

  3. TeamCity will display the project and build configuration name. If required, modify the names and click Proceed.

  4. TeamCity will add a VCS build trigger and attempt to auto-detect build steps.
    On the 自動検出されたビルドステップページ select the detected step(s) to use in your build configuration. Click 選択を使用 .
    If no steps found, you will have to configure build steps manually.

  5. Your project and a build configuration are configured. Click 実行 to start the build.
    Depending on the build configuration settings, TeamCity can suggest some additional configuration options. Review 提案 at the end of the settings list and configure required ones.

手動でプロジェクトを作成する

1. プロジェクトの作成ボタンをクリックし、手動を選択します。

2. 新規プロジェクトの作成ページで、プロジェクト設定を指定します。

設定

説明

親プロジェクト

ドロップダウンから親プロジェクトを選択します。

名前

プロジェクト名

プロジェクトID

プロジェクトのID

説明

プロジェクトのオプションの説明。

3. 作成をクリックします。空のプロジェクトが作成されます。

4. プロジェクトのビルド構成を作成する(ビルド設定の選択、VCS設定の構成ビルドランナーの選択)。

5. 特定のビルドエージェントにビルド構成を割り当てる

プロジェクト管理

デフォルトではアルファベット順にリストされているプロジェクトページに、使用可能なすべてのプロジェクトとサブプロジェクトを表示できます。管理者はデフォルトの順序をカスタマイズできます

To copy, move, delete or archive a project, use the アクション menu in the upper right corner of the プロジェクト設定 page or the さらに button

moreButton.PNG
next to the project on the parent プロジェクト設定 page. These options are not available for the Root project.

プロジェクトをコピー

Use the corresponding item from the アクション menu in the upper right corner of the プロジェクト設定 page or the さらに button

moreButton.PNG
next to the project on the parent プロジェクト設定 page.

プロジェクト管理者は、プロジェクトをコピーして別のプロジェクトに移動することができます。

コピーは、元のプロジェクトのすべての設定、サブプロジェクトビルド構成、およびテンプレートを複製しますが、ビルドに関連するデータは保持されません。空のビルド履歴と統計なしでコピーが作成されます。

プロジェクトを同じ親または別の親にコピーできます。

On copying, TeamCity automatically assigns a new name and ID to the copy. It is also possible to change the name and ID manually.
Selecting the プロジェクト関連のユーザー、エージェント、その他の設定をコピーする option makes sure that all the settings like notification rules or agent's compatibility are exactly the same for the copied and original projects for all the users and agents affected.

ビルド構成のビルド番号をコピーすることもできます。

プロジェクトを移動

To move a project, use the corresponding item from the アクション menu in the upper right corner of the プロジェクト設定 page or the さらに button

moreButton.PNG
next to the project on the parent プロジェクト設定 page.

プロジェクトを移動するとき、TeamCityはすべての設定、サブプロジェクトビルド構成 / テンプレート、および関連データ、さらにビルド履歴を保存します。

アーカイブプロジェクト

Use the corresponding item from the アクション menu in the upper right corner of the プロジェクト設定 page or the さらに button

moreButton.PNG
next to the project on the parent プロジェクト設定 page. Refer to the dedicated page.

一括編集ID

  1. Use the corresponding item from the アクション menu in the upper right corner of the プロジェクト設定 page or the さらに button

    moreButton.PNG
    next to the project on the parent プロジェクト設定 page.

  2. 現在のプロジェクトとビルド構成IDが表示されます。すべてのサブプロジェクト、VCSルート、ビルド設定、およびテンプレートのIDを修正またはリセットできます。再生するをクリックして新しいIDを自動的に取得するか、手動で編集します。

  3. サブミットをクリックします。

トリガーの一時停止/有効化

You can pause triggers for all or selected build configurations of a project. Use the corresponding item from the アクション menu in the upper right corner of the プロジェクト設定 page or the さらに button

moreButton.PNG
next to the project on the parent プロジェクト設定 page.

プロジェクトをエクスポートする

You can export configuration files of a project with its children to move it to a different TeamCity server. Use the corresponding item from the アクション menu in the upper right corner of the プロジェクト設定 page or the さらに button

moreButton.PNG
next to the project on the parent プロジェクト設定 page.

プロジェクトを削除する

Use the corresponding item from the アクション menu in the upper right corner of the プロジェクト設定 page or the さらに button

moreButton.PNG
next to the project on the parent プロジェクト設定 page.

プロジェクトを削除すると、TeamCityはその.xml設定ファイルを削除します。削除後、プロジェクトは<TeamCityデータディレクトリ> /config/_trash/.ProjectID.projectNディレクトリに移動されます。次回のビルド履歴のクリーンアップ中に、削除されたプロジェクトのデータベース(ビルド履歴、成果物など)に格納されているすべてのプロジェクト関連データが完全に削除されるまでに、構成可能なタイムアウト(デフォルトは5日)があります。クリーンアップを実行する前に、削除したプロジェクトを復元できます。

<TeamCityデータディレクトリ> / config / _trash /ディレクトリは自動的にクリーンアップされず、削除したプロジェクトが不要であると確信できる場合は手動で空にすることができます。

最終更新日: 2020年8月14日

関連ページ:

REST APIリファレンス

プロジェクトとビルド構成/テンプレートリスト:プロジェクト一覧 GET http://teamcity:8111/app/rest/projects プロジェクトの詳細 GET http://teamcity:8111/app/rest/projects/<projectLocator&g...

Kotlin DSL

XML形式のバージョン管理で設定を保存することに加えて、TeamCityでは(Kotlin言語に基づいて)DSLに設定を保存できます。バージョン管理に保存されたDSLを使用すると、プログラムで設定を定義できます。Kotlinは静的に型指定されるため、IDEで自動補完機能を自動的に受け取ります。これに...

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

GitHub、GitHub Enterprise、Bitbucketクラウド、GitLab.com、またはGitLab CE / EEに組織アカウントがある場合は、TeamCityをこれらのソースコードホスティングサービスに接続すると、組織のユーザーが新しいプロジェクト、GitまたはMercuria...

リポジトリURLから設定を推測する

TeamCityは、リポジトリURLからVCSタイプと設定を自動的に検出できます。VCSルートを構成する場合、ドロップダウンからリポジトリURLから推測オプションを選択し、URLを指定します。TeamCityは、サポートされているバージョン管理のURLを認識し、VCSルートを自動的に作成します。VC...

ビルド構成の作成と編集

このページでは、TeamCity Web UIを使用したビルド構成の作成について詳しく説明しています。他のオプションには、REST APIおよびKotlin言語に基づくDSLでのTeamCityプロジェクト構成の使用が含まれます。ビルド構成を作成するには、プロジェクトの一般設定を開き、ビルド構成セク...

ビルド構成テンプレート

概要:構成テンプレートを作成するallow you to eliminate duplication of build configuration settings. If you want to have several similar (not necessarily identical) bu...