快速设置

下载 TeamCity 免费专业版 ，这是一个功能齐全的 TeamCity，捆绑了 3 个构建代理，最多支持 100 个构建配置。
试用结束后，您可以 切换到企业版。 阅读我们的 许可政策 和 定价 的详细信息。

运行下载的 .exe 文件，并遵循 TeamCity 设置向导的指示。 TeamCity 网络服务器和一个构建代理将会被安装在同一台机器上。

在 安装 期间，您可以：

• 将 TeamCity 安装目录 设置为 TeamCity 将要安装的位置。

• 选择 TeamCity 服务器和代理是否以 Windows 服务的方式运行
  

  

• 配置端口：

  • 服务器端口： 8111 是默认端口。 请注意，它可能已被您机器上的其他应用程序占用。 如果此端口已被使用，您可以在安装过程中进行更改。 在下面的示例中，我们将端口设置为 7777。

  • 代理端口： 9090 是服务器传入连接的默认端口。 如果此端口已被使用，您可以将 ownPort 属性设置为不同的值以更改端口。
    

    

如果您已将 TeamCity 安装为 Windows 服务，请按照 常规程序启动和停止服务。
否则，要启动或停止 TeamCity 服务器和一个默认代理，同时通过命令行启动 runAll 脚本。 脚本位于 <TeamCity 安装目录>\bin 目录中。

• 对服务器和默认代理执行 start：

  .\runAll.bat start

• 对服务器和默认代理执行 stop：

  .\runAll.bat stop

如果您在安装过程中没有更改默认端口（8111 ），则可以在同一台机器上运行的网络浏览器中通过 http://localhost 访问 TeamCity 网页界面。 否则，请使用 http://localhost:<port> （在我们的例子中为 http://localhost:7777）。

1. 确保您已经安装了 Java 8 或 11（例如，使用捆绑的 Amazon Corretto）。

   tip

   Java 8 的支持将在 2023 年 4 月发布的 TeamCity 服务器 2023.04 中停止。 如果您使用的是非捆绑版的 Java 8，我们强烈建议您将服务器迁移到 Java 11。

   打开命令行终端，运行以下命令：

   java -version

2. 请确保 JAVA_HOME 环境变量指向 Java 安装目录。 在命令行终端中运行以下命令：

   echo $JAVA_HOME

3. 使用 TeamCity<版本号>.tar.gz 存档文件解压捆绑了 Tomcat servlet container 的 TeamCity。
   解压存档文件。 例如，在 Linux 下使用：

   tar xfz TeamCity<version number>.tar.gz

   tip

   该归档文件也可以在 Windows 上使用。

4. 解压缩归档文件后，TeamCity 网页服务器和一个构建代理将在当前机器上可用。

要同时启动/停止 TeamCity 服务器和一个默认代理，通过终端运行 runAll 脚本。 脚本位于 <TeamCity 安装目录>/bin 目录中。

• 对服务器和默认代理执行 start：

  ./runAll.sh start

• 对服务器和默认代理执行 stop：

  ./runAll.sh stop

默认情况下，TeamCity 在 http://localhost:8111/ 上运行，并在同一台机器上有一个已注册的构建代理。 如果其他应用程序已经使用了这个端口，TeamCity 服务器（Tomcat 服务器）将无法启动，服务器日志或服务器控制台会出现“ Address already in use ”的错误。

要更改服务器端口，请找到 <TeamCity 安装目录>/conf/server.xml 并在 <Connector> XML 节点中修改端口，例如：

<Connector port="8111" ...>

当您首次在浏览器中启动 TeamCity 时，它会提示您完成安装：

1. 审查 TeamCity 数据目录的位置，所有的配置信息都存储在这里。 单击 继续。

2. TeamCity 将构建历史、用户、构建结果和一些运行时数据存储在 SQL 数据库中，并允许您选择数据库类型。
   目前，保持默认的内部数据库。 单击 继续。
   

   

   TeamCity 将花费一些时间来配置必要的组件。

3. 在下一个屏幕上，接受许可协议以继续启动过程。 单击 继续。

4. TeamCity 显示 创建管理员账户 页面。 指定管理员凭据并单击 创建帐户。

您已登录到 TeamCity ：现在您可以配置您的用户设置并 创建并运行您的第一个构建。

TeamCity 提供各种各样的 授权选项 ，适合任何规模的团队。 除了多种可用的服务器许可证，您还可以购买额外的代理来扩展构建服务器的性能。

服务器和代理许可证可以在 管理 | 许可证 页面上激活。 我们建议激活您的服务器许可证，即使是免费的专业版，以确保系统管理员及时收到有关 TeamCity 服务器安全更新的重要电子邮件通知。

了解更多： 许可政策、 管理 TeamCity 许可证

在您的服务器启动并运行后，您可以继续创建第一个项目。

• 项目管理员指南 — 了解基本的 TeamCity 概念，例如构建配置、构建功能、触发器和 VCS 根。

• 配置并运行您的第一个构建 — 一个分步教程，引导您完成配置项目的主要阶段。

• 创建构建链 — 了解如何在单个链中链接独立的构建配置，其中多个构建可以并行运行。

• 用户指南 — 解释普通 TeamCity 用户如何运行构建、检查构建结果并调查问题。