TeamCity On-Premises 2024.03 Help

快速设置指南

这篇文章描述了在同一台机器上设置 TeamCity 服务器和一个构建代理的 评估设置,适用于最受欢迎的操作系统。

要对如何安装 TeamCity 进行评估有一个大致的了解,您可以观看此视频教程,或阅读下方的完整指南。

要为生产设置安装 TeamCity ,请阅读 此部分

下载 TeamCity

下载免费的 TeamCity 专业版,它是一个功能齐全的 TeamCity,附带3个构建代理,限制为100个构建配置。
经过评估后,您可以切换到企业版。 阅读我们的 许可政策定价 的详细信息。

在 Windows 上安装并运行

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

安装 过程中,您可以:

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

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

    TeamCity 服务器和代理作为 Windows 服务
  • 配置端口:

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

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

      配置构建代理端口

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

  • 启动服务器和默认代理:

    .\runAll.bat start
  • 停止服务器和默认代理:

    .\runAll.bat stop

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

在 Linux 和 macOS 上安装并运行

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

    打开命令行终端,运行以下命令:

    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
  4. 解压缩归档文件后,TeamCity 网页服务器和一个构建代理将在当前机器上可用。

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

  • 启动服务器和默认代理:

    ./runAll.sh start
  • 停止服务器和默认代理:

    ./runAll.sh stop

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

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

<Connector port="8111" ...>

TeamCity 首次启动

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

  1. 审查TeamCity 数据目录的位置,所有的配置信息都存储在这里。 点击 Proceed (继续)。

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

    选择数据库类型

    TeamCity 配置必要组件需要一些时间。

  3. 在下一个屏幕上,接受许可协议以继续启动过程。 点击 Continue (继续)。

  4. TeamCity 显示 Create Administrator Account 页面。 指定管理员凭证并点击 创建帐户

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

最后修改日期: 16日 7月 2024年