创建和编辑项目
此部分详细介绍了通过 TeamCity 网页用户界面创建项目的步骤。 其他选项包括 REST API 和使用基于 Kotlin 语言 的 TeamCity 项目配置。
创建项目
要创建项目，请使用右上角的 Administration 链接，然后点击 Create project。 Create project 页面已显示。
有几种创建项目的选项：
请注意，默认仅提供两个选项：从仓库 URL和手动。 如果在根项目（或要创建的项目的父项目）中配置了到某个 VCS 托管服务的 连接 ，则相应的选项将变得可用，因此您可以使用现有的 VCS 连接规格创建项目。
要创建子项目，请转到父项目的 项目设置 页面，并使用其中的一个可用选项，与创建项目类似。
创建指向仓库 URL 的项目
1. 在 Create project（创建项目）页面上，点击 "From a repository URL" （从仓库 URL）的图块。
2. 指定项目设置：
设置 | 描述 |
|---|---|
父项目 | 从下拉菜单中选择父项目。 |
存储库 URL | 一个 VCS 仓库 URL。 TeamCity 可识别 Subversion 、 Git 和 Mercurial 的 URL。 TFS 和 Perforce 部分得到支持。 位于此字段旁的图标代表 TeamCity 支持的 VCS 托管服务。 如果您点击活动（高亮）图标，您将能够选择一个现有的连接规格。 如果您点击一个非活动图标，将会被重定向至 Add Connection 表单。 |
用户名 | 如果访问仓库需要身份验证，请提供用户名。 |
密码 | 如果仓库访问需要验证，请提供密码或者令牌。 |
3. 点击 Proceed。 TeamCity 将为您配置其余的设置。
它将确定 VCS 仓库的类型，自动配置 VCS 仓库设置，并建议项目和构建配置名称。
对于 Git 仓库，TeamCity 将自动检测默认分支，但您可以选择更改它，并通过输入其他分支的 规格 来监视其他分支。项目，构建配置和 VCS 根将自动创建。
TeamCity 将添加一个 VCS 构建触发器。
TeamCity 将尝试自动检测构建步骤：Ant 、NAnt 、Gradle 、Maven 、 MSBuild 、Visual Studio 解决方案文件、PowerShell 、Xcode 项目文件、Rake ，以及 IntelliJ IDEA 项目。
4. 在 自动检测的构建步骤 页面上，选择您的构建配置中要使用的检测到的步骤。 点击 Use selected。 如果找不到步骤，您将必须手动配置构建步骤。
5. 您的项目和构建配置已经配置好了。 点击Run按钮以开始构建。
根据构建配置设置，TeamCity可以提供一些额外的配置选项。 在设置列表的末尾查看建议，并配置所需的选项。
创建指向 GitHub.com 仓库的项目
在 创建项目 页面上，点击一个 "From GitHub" 磁贴以从一个 现有连接 创建项目。
选择一个仓库。 TeamCity 将验证仓库连接。 如果连接已经验证，新的页面会打开。
TeamCity 将显示项目和构建配置名称。 如果需要，修改名称并点击 继续。 TeamCity 将自动检测默认的 Git 分支，但您可以选择更改它，并通过输入其 规格 来添加其他需要监控的分支。
TeamCity 将添加一个 VCS 构建触发器，并尝试自动检测构建步骤：Ant ，NAnt ，Gradle ，Maven ，MSBuild ，Visual Studio 解决方案文件，PowerShell ，Xcode 项目文件，Rake ，以及 IntelliJ IDEA 项目。
在 自动检测构建步骤 页面上，选择检测到的步骤以用于您的构建配置。 点击 使用所选。
如果未找到步骤，您将不得不手动配置构建步骤。您的项目和构建配置已经配置好了。 点击 Run 开始构建。 根据构建配置设置，TeamCity 可以提供一些额外的配置选项。 在设置列表的最后查看 Suggestions 并配置所需的项。
创建指向 Bitbucket 的项目
在 Create project 页面，点击相应的 "From Bitbucket" 图块，与 Bitbucket Cloud、Server 或 Data Center 的现有连接创建项目。 参阅此帮助文章，了解如何设置新的连接：Bitbucket Cloud | Bitbucket Server 和 Data Center。
选择一个仓库。 TeamCity 将验证仓库连接。 如果连接已经验证，新的页面会打开。
TeamCity 将显示项目和构建配置名称。 如果需要，修改名称并点击 继续。 对于 Git 仓库，TeamCity 会自动检测默认分支，但您有更改它的选项，并通过输入其他分支的规格来添加要监控的其他分支。
TeamCity 将添加一个 VCS 构建触发器，并尝试自动检测构建步骤：Ant ，NAnt ，Gradle ，Maven ，MSBuild ，Visual Studio 解决方案文件，PowerShell ，Xcode 项目文件，Rake ，以及 IntelliJ IDEA 项目。
在 自动检测构建步骤 页面上，选择检测到的步骤以用于您的构建配置。 点击 使用所选。
如果未找到步骤，您将不得不手动配置构建步骤。您的项目和构建配置已经配置好了。 点击 Run 开始构建。 根据构建配置设置，TeamCity 可以提供一些额外的配置选项。 在设置列表的最后查看 Suggestions 并配置所需的项。
创建指向 GitLab.com 的项目
在 Create project 页面，点击 "From GitLab" 图块以从 现有连接 创建项目。
选择一个仓库。 TeamCity 将验证仓库连接。 如果连接已经验证，新的页面会打开。
TeamCity 将显示项目和构建配置名称。 如果需要，修改名称并点击 继续。 TeamCity 将自动检测默认的 Git 分支，但您可以选择更改它，并通过输入其 规格 来添加其他需要监控的分支。
TeamCity 将添加一个 VCS 构建触发器，并尝试自动检测构建步骤：Ant ，NAnt ，Gradle ，Maven ，MSBuild ，Visual Studio 解决方案文件，PowerShell ，Xcode 项目文件，Rake ，以及 IntelliJ IDEA 项目。
在 自动检测构建步骤 页面上，选择检测到的步骤以用于您的构建配置。 点击 使用所选。
如果未找到步骤，您将不得不手动配置构建步骤。您的项目和构建配置已经配置好了。 点击 Run 开始构建。 根据构建配置设置，TeamCity 可以提供一些额外的配置选项。 在设置列表的最后查看 Suggestions 并配置所需的项。
创建指向 Azure DevOps Services 的项目
在 创建项目 页面，点击 "From Azure DevOps" 砖块以从 现有连接 创建项目。 推荐的 Git 仓库方法是使用基于 OAuth 2.0 协议的连接。 如果您需要连接到 TFVC 仓库，请使用已过时的基于 PAT 的连接。
选择一个仓库。 TeamCity 将验证仓库连接。 如果连接已经验证，新的页面会打开。
TeamCity 将显示项目和构建配置名称。 如果需要，修改名称并点击 继续。 对于 Git 仓库，TeamCity 会自动检测默认分支，但您有更改它的选项，并通过输入其他分支的规格来添加要监控的其他分支。
TeamCity 将添加一个 VCS 构建触发器，并尝试自动检测构建步骤。
在 自动检测的构建步骤页面 选择您的构建配置中要使用的检测步骤。 点击 使用所选。
如果未找到步骤，您将不得不手动配置构建步骤。您的项目和构建配置已经配置好了。 点击 Run 开始构建。 根据构建配置设置，TeamCity 可以提供一些额外的配置选项。 在设置列表的最后查看 Suggestions 并配置所需的项。
创建指向 JetBrains Space 的项目
在从 JetBrains Space 创建项目之前，您需要配置一个 专用连接到您的 Space 实例。
在 Create project 页面，点击 "From JetBrains Space" 图块以从现有连接创建项目。 首次使用时，系统将提示您登录 Space 并授权 TeamCity 查看您的用户资料和项目。 为了能够做到这一点，TeamCity 将为您的 Space 实例创建一个服务令牌以进行身份验证。
选择一个仓库。 TeamCity 将验证仓库连接。 如果连接已经验证，新的页面会打开。
TeamCity 将会显示项目和构建配置的名称。 如有需要，修改它们，然后点击 继续。 对于 Git 仓库，TeamCity 会自动检测默认分支，但您有更改它的选项，并通过输入其他分支的规格来添加要监控的其他分支。
TeamCity 将添加一个 VCS 构建触发器，并尝试自动检测构建步骤。
在 自动检测的构建步骤页面 选择您的构建配置中要使用的检测步骤。 点击 使用所选。
如果未找到步骤，您将不得不手动配置构建步骤。您的项目和构建配置已经配置好了。 点击 Run 开始构建。 根据构建配置设置，TeamCity 可以提供一些额外的配置选项。 在设置列表的最后查看 Suggestions 并配置所需的项。
手动创建项目
1. 点击 创建项目 按钮并选择 手动。
2. 在 Create New Project 页面上，指定项目设置：
设置 | 描述 |
|---|---|
父项目 | 从下拉菜单中选择父项目。 |
名称 | 项目名称。 |
项目 ID | 项目的 ID |
描述 | 项目的可选描述。 您可以在描述中以 Markdown 格式添加链接： [My Project](https://www.example.com) |
3. 点击 Create。 创建了一个空项目。
4. 创建构建配置（选择构建设置，配置 VCS 设置，并选择构建运行程序）为项目。
5. 将构建配置分配给特定的构建代理。
管理项目
您可以在默认情况下按字母顺序列出的 Projects 页面上查看所有可用的项目和子项目。 管理员可以 自定义默认顺序。
当您从列表中选择一个项目时，TeamCity 会显示 项目主页，在此页面上，您可以预览其嵌套构建配置和最近的构建结果。 要访问项目的设置，请在屏幕右上角点击 编辑项目设置。
要复制、移动、删除或归档一个项目，请在项目设置页面的右上角使用操作菜单，或者在父级项目设置页面上项目旁边的更多按钮
。 这些选项对 Root 项目来说并不可用。
复制项目
在 项目设置 页面的右上角或父级 项目设置 页面上项目旁边的 更多 按钮 旁，使用 操作 菜单中的对应项。
项目可以由项目管理员复制并移动到另一个项目。
一个副本会复制原始项目的所有设置，子项目，构建配置和模板，但是与构建相关的数据不会保留。 副本是在没有 构建历史 和没有 统计数据 的情况下创建的。
您可以将项目复制到相同或另一个父级中。
在复制时，TeamCity 会自动为副本分配一个新的名称和 ID。 也可以手动更改名称和 ID。
选择 复制项目关联的用户、代理及其他设置 选项可确保所有用户和代理的复制项目和原始项目的所有设置（如通知规则或代理的兼容性）完全相同。
您也可以选择复制构建配置的构建编号。
移动项目
要移动一个项目，您可以在 项目设置 页面右上角的 操作 菜单中选择对应的项，或者在父级 项目设置 页面中，项目旁边的 更多 按钮 旁选择。
归档项目
在 项目设置 页面的右上角或父级 项目设置 页面上项目旁边的 更多 按钮 旁，使用 操作 菜单中的对应项。 请参阅专用的 页面。
批量编辑 ID
在 项目设置 页面的右上角或父级 项目设置 页面上项目旁边的 更多 按钮
旁，使用 操作 菜单中的对应项。当前的项目和构建配置 IDs 已显示。 您可以修改或重置所有子项目，VCS 根，构建配置和模板的 ID。 点击 Regenerate 以自动获取新的 Ids，或手动编辑它们。
点击 Submit。
暂停 / 激活 触发器
您可以为项目的所有或选择的构建配置暂停触发器。 在 项目设置 页面的右上角或父级 项目设置 页面上项目旁边的 更多 按钮 旁，从 操作 菜单中使用对应的项目。
导出项目
您可以导出配置文件以及项目的子文件，以便将其迁移到另一台 TeamCity 服务器。 在 项目设置 页面的右上角或父级 项目设置 页面上项目旁边的 更多 按钮 旁，从 操作 菜单中使用对应的项目。
删除项目
在 项目设置 页面的右上角或父级 项目设置 页面上项目旁边的 更多 按钮 旁，使用 操作 菜单中的对应项。
当您删除一个项目时，TeamCity 将会移除其 .xml 配置文件。 删除后，项目将被移动到 <TeamCity 数据目录>/config/_trash/ .ProjectID.projectN 目录。 在所有与删除的项目相关的数据（构建历史、工件等）在下一次构建历史清理过程中完全删除之前，有一个 可配置 的超时期限（默认为5天）。
<TeamCity 数据目录>/config/_trash/ 目录不会自动清理，如果您确定不再需要已删除的项目，可以手动清空该目录。