teamcity for administrator

发布时间:2023-05-01 08:00

1. 改变teamcity server配置:

Administration (右上)| Global Settings(左中)

2. teamcity 配置(Global Settings下的选项):

database:构建的历史,用户及其用户数据以及其他内容存再datebase中。
Date Directory:存配置文件,构建结果,和当前操作文件的目录。
安装服务的机器上的.BuildServer也存有相关信息。点击broser可以看到很多配置相关的文件。/TeamCity/conf/teamcity-startup.properties中保存了TeamCity数据存放目录。
Artifact directories:Build Artifact是一个build产生的文件。此目录存放Build Artifact,build data,build logs。

3.Version Control Setting

Default VCS changes check interval:默认的检测版本库是否发生改变的时间间隔。默认60s,可以通过设置VCS root进行设置。
Default VCS trigger quiet period:指明了上次VCS变变动到增加一个build到队列中这个时间段。这由teamcity维护。
Checkout directory:

4.Edit configuration Settings

首先选定项目,项目一般都有子项目。点击项目前的三角形就会罗列出来。选中对应项目后,点击右上角的build configuration home。可以看到以下几部分:

  • General Settings:
  • Agent requirement:
  • Dependencies
    一个build配置可以依赖多个配置。可以设置两种类型的依赖:Snapshot Dependency和Artifact Dependency。

    • Artifact Dependency是获取其他build生成的产品。当没有相应的Snapshot Dependency设置时,它主要用于build的配置与源无关的情况。例如一个为其他build提高可重用组件(文件,压缩包等)的build。

      如何添加一个artifact dependency?
      Dependencies|Add new artifact dependency,此时可以看到如下界面:
      \"teamcity

    各项说明如下:

选项 说明
Depend on 为当前build配置指明一个要依赖的buil配置
Get artifacts from 指明build类型,将从这个build获取产品(压缩包,文件等)。类型有:last successful build(获取最近的且build成功的产品), last pinned build(最近的固定依赖), last finished build(有Snapshot Dependency配置时,产品build和同源build获取), build from the same chain(有Snapshot Dependency配置才有效)
Build number 选择last finished build with specified tag才会用到
Build branch filter 此项只有当依赖中有一个在VCS root settings就指定的分支时才会生效。它允许设置一个分支过滤,从而限制源build只在匹配的分支中进行
Artifacts Rules 参考下文
Clean destination paths before downloading artifacts 在copy产品前,检查这个选项去删除目标目录的内容。它将应用到所有包含性规则中

Artifacts Rules
一般格式:[+:|-:]SourcePath[!ArchivePath][=>DestinationPath]
每条规则都指明了从源build要下载的文件。SourcePath指明了源build的产品的目录。它要么指明一个具体的文件或目录,要么用通配符匹配多个文件(支持通配符:*匹配任何文件名和目录名,但/和\\这两个目录分隔符除外。?匹配除开目录分隔符外的任何一个字符。**匹配任何符号,包含目录分隔符)。下载的内容会根据规则中的SourcePath的第一个*或?开始保持目录结构。DestinationPath指明在agent上的目标目录(放文件的地方)。如果它是相对路径,build checkout directory为当前目录。若目标路径不存在,会把文件下载到checkout根目录。

举例:
源目录文件结构a/b/c/file.txt。规则:a/b/**=>lib。则会目录会下载一个lib/c/file.txt的结构。
源目录文件结构a/b/c/file.txt。规则:**/*.txt=>lib。则会目录会下载一个lib/a/b/c/file.txt的结构。

ArchivePath用于下载压缩结构:zip,7zip,jar,tar和tar.gz。ArchivePath的匹配规则类似SourcePath

举例
release-.zip!.dll=>dlls 会下载匹配release-*.zip的所有.dll文件到dlls目录。
a.zip!**=>destination 会下载a.zip下的所有文件到destination目录
a.zip!a/b/c/**/*.dll=>dlls会下载a/b/c或它的子目录下的所有.dll文件(此处存疑)。

+:和-:是用来从要下载的内容中包含或排除指定的文件的。

举例:
*/.txt=>texts
-:bad/exclude.txt
以上两条规则会下载所有.txt文件。但bad目录下的exclude.txt文件除外。
+:release-.zip!/.dll=>dlls
-:release-0.0.1.zip!Bad.dll
以上两条规则会从release-.zip文件中下载所有的.dll文件。到release-0.0.1.zip中的Bad.dll除外。
*/.*=>target
-:excl/*/.*
+:excl/must_have.txt=>target
以上三条规则会下载所有目标文件,但excl目录下的文件不会下载,但会下载excl下的must_have.txt文件会下载。
  • Snapshot Dependency设置的是build间源层次的依赖。目的是通过创建不同的build配置形成复杂的build程序,而这些build配置用Snapshot Dependency关联起来。
  • Failure Conditions
    通过设置失败条件,从而定义一个build怎样才算失败(默认情况下,很多出错build的结果都是success)。

    • Common Failure Conditions(Fail build if:)
      it runs longer than ... minutes:build运行时间限制。以分钟为单位。设置为非零值时,会覆盖全局(server层次: Administration|Global settings)设置。设置为0,则是无时间限制,若有server层次的设置,则以它为准。
      the build process exit code is not zero:有一个build step以非0结束,则整个build失败。
      at least one test failed:有一个build step失败,则整个build失败。且后续的build step不会再运行。若为选中此此选项,即使有大量build step失败,后续build step仍会执行。
      an error message is logged by build runner:build runner报告了错误信息,则认为build失败。
      an out of memory or crash is detected (Java only):检测到JVM的崩溃,或Java的内存不足问题。
    • Additional Failure Conditions
      1.Fail build on metric change
      2.Fail build on specific text in build log
      当build 日志中出现特定的文本时,可以定义build失败。TeamCity会检查日志中的每一行。
      注意:匹配时,日志前的时间以及每个步骤开始前的步骤名称等会被忽略。当然,也可反向定义,即日志未出现某些文本时,认为build失败。

ItVuer - 免责声明 - 关于我们 - 联系我们

本网站信息来源于互联网,如有侵权请联系:561261067@qq.com

桂ICP备16001015号