快速设置指南
这篇文章描述了在同一台机器上设置 TeamCity 服务器和一个构建代理的 评估设置,适用于最受欢迎的操作系统。
要对如何安装 TeamCity 进行评估有一个大致的了解,您可以观看此视频教程,或阅读下方的完整指南。
要为生产设置安装 TeamCity ,请阅读 此部分。
下载 TeamCity
下载免费的 TeamCity 专业版,它是一个功能齐全的 TeamCity,附带3个构建代理,限制为100个构建配置。
经过评估后,您可以切换到企业版。 阅读我们的 许可政策 和 定价 的详细信息。
在 Windows 上安装并运行
运行下载的 .exe
文件,并遵循 TeamCity 设置向导的指示。 TeamCity 网络服务器和一个构建代理将会被安装在同一台机器上。
在 安装 过程中,您可以:
将 TeamCity 安装目录 设置为 TeamCity 将要安装的位置。
选择 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 上安装并运行
确保您已经安装了 Java 8 或 11(例如,使用捆绑的 Amazon Corretto)。
打开命令行终端,运行以下命令:
java -version请确保
JAVA_HOME
环境变量指向 Java 安装目录。 在命令行终端中运行以下命令:echo $JAVA_HOME使用
TeamCity<版本号>.tar.gz
存档文件解压捆绑了 Tomcat servlet container 的 TeamCity。
解压存档文件。 例如,在 Linux 下使用:tar xfz TeamCity<version number>.tar.gz解压缩归档文件后,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 节点中修改端口,例如:
TeamCity 首次启动
当您首次在浏览器中启动 TeamCity 时,它会提示您完成安装:
审查TeamCity 数据目录的位置,所有的配置信息都存储在这里。 点击 Proceed (继续)。
TeamCity 将构建历史、用户、构建结果和一些运行时数据存储在 SQL 数据库中,并允许您选择数据库类型。
目前,保持默认的内部数据库。 点击 Proceed(继续)。TeamCity 配置必要组件需要一些时间。
在下一个屏幕上,接受许可协议以继续启动过程。 点击 Continue (继续)。
TeamCity 显示 Create Administrator Account 页面。 指定管理员凭证并点击 创建帐户。
您已登录到 TeamCity :现在您可以配置您的用户设置并创建并运行您的第一个构建。