云客户?
免费开始>
在MyJFrog >中升级
云有什么新>





概述

Artifactory通过TeamCity Artifactory插件提供了与TeamCity CI Server的紧密集成。除了管理构件到Artifactory的有效部署之外,插件还允许您捕获有关已部署的构件、已解决的依赖关系、与TeamCity构建运行相关的环境数据等信息,从而有效地为您的构建提供完整的可跟踪性。

从版本2.1.0开始,TeamCity Artifactory插件为发布管理和推广提供了强大的特性。详情请参阅TeamCity Artifactory插件-发布管理


在开始之前

请参阅有关的一般资料Artifactory的构建集成在使用TeamCity Artifactory插件之前。

源代码可用!

TeamCity Artifactory插件是一个GitHub上的开源项目你可以自由浏览和分叉。

构建运行器支持

TeamCity Artifactory插件支持大多数构建运行器类型,包括:Maven2, Maven 3常春藤/蚂蚁(有Ivy模块支持),GradleNAntMSBuildFxCop而且知识产权

安装插件

插件部署到TeamCity的方法是将打包的插件放在<TeamCity数据目录> /插件目录重新启动TeamCity。您也可以通过TeamCity UI via来实现这一点管理|插件列表|上传插件Zip并从文件系统中选择zip文件。您需要重新启动TeamCity (tomcat)才能使插件生效。

.从。下载插件的最新版本在这里

删除旧版本

如果您使用的是旧版本的插件,请确保在升级到新版本之前将其删除

页面内容



配置

要使用TeamCity Artifactory插件,您首先需要在TeamCity的服务器配置中配置您的Artifactory服务器。然后,您可以设置一个项目构建运行器,将构件和build Info部署到一个已配置的Artifactory服务器上的存储库。

配置系统范围的Artifactory服务器

要使Artifactory服务器对项目运行器配置全局可用,必须在管理|集成| Artifactory

选择创建新的Artifactory服务器配置并填写Artifactory服务器的URL。

部署人员凭据可以在全局级别为所有构建设置,但也可以在项目构建级别覆盖和设置。

为解析器存储库指定用户名和密码是可选的。它仅在查询Artifactory的REST API以获得配置的存储库列表时使用,并且仅在目标实例不允许匿名访问时使用。

使用Artifactory插件运行构建

一般

Artifactory Plugin将Artifactory配置添加到内置MavenGradle而且蚂蚁建造台阶。

此外,敬业Artifactory码头工人build step允许从Artifactory中提取和推送docker映像,同时收集和发布构建信息到Artifactory。

通用构建集成允许从Artifactory下载和上传通用文件,同时收集构建信息并将其发布到Artifactory。通用构建集成配置由Artifactory添加到以下构建步骤:

  • 命令行
  • FxCop
  • MSBuild
  • Powershell
  • XCode项目
  • NuGet发布
  • NAnt
  • Visual Studio (sln)
  • Visual Studio 2003
  • SBT, Scala构建工具

添加到这些构建步骤中的配置允许使用“文件规格”或“遗留模式”定义要上传和下载的构件。

文件规格

文件规格以JSON格式指定。您可以读取File Spec模式在这里

遗留模式(已弃用)

从1.8.0版本开始,遗留模式已弃用,并将在未来的版本中删除。

自定义发布的工件
允许您指定构建生成的工件文件应该发布到Artifactory。在构建的最后,插件根据指定的工件模式在构建的签出目录中定位工件,并将它们发布到Artifactory的一个或多个位置,可选地为每个部署的工件的目标路径应用映射。发布工件的模式和映射语法类似于TeamCity所使用的构建构件
自定义构建依赖项
允许您指定在运行构建之前应该从Artifactory下载的已发布工件的依赖项模式。通过使用基于查询的解析,您可以对解析和下载哪些工件进行详细的控制,在您的工件路径中添加一个具有工件在下载之前应该具有的属性的查询。欲了解更多信息,请阅读此处属性解析


配置通用上传

从版本2.1.4开始,上述配置不向后兼容,您可能需要重新保存构建配置以使其正常运行。


在Artifactory中触发构建保留

您可以在向Artifactory发布构建信息时触发构建保留。

用JFrog x射线扫描构建

TeamCity Artifactory插件通过JFrog Artifactory与JFrog Xray集成,允许您扫描构建工件的漏洞和其他问题。如果发现问题或漏洞,您可以选择让构建作业失败。扫描结果的详细信息总是打印到生成日志中。此集成需要JFrog Artifactory v4.16上面还有JFrog x射线v1.6及以上。

要使用x射线扫描构建,您需要配置使用正确的过滤器,指定哪些工件和漏洞应该触发警报,并为该手表设置“失败构建作业操作”。您可以阅读更多关于CI/CD与Xray集成的信息在这里

将可搜索参数附加到Build-Info和已发布工件

生成配置设置您可以选择参数定义应该附加到工件及其相应的构建信息的系统属性或环境变量。

要定义参数,请单击添加新参数按钮。

添加一个新参数

填写相应的字段。

与通过Artifactory运行的构建相关的参数是:

  • buildInfo.property。*所有以这个前缀开头的属性都被添加到build-info的根属性中
  • artifactory.deploy。*-以此前缀开头的所有属性都附加到任何已部署的工件上

您可以在单个文件中指定所有属性,然后定义另一个指向该文件的属性。

要将插件指向属性文件,请定义名为buildInfoConfig.propertiesFile并将其值设置为属性文件的绝对路径。

也可以将插件指向包含上述属性的属性文件。

属性文件应该位于运行构建代理的机器上,不是在服务器上!


指定系统属性和环境变量


在Artifactory中浏览已发布的构建信息

如果你将构建步骤配置为将构建信息发布到Artifactory,你可以从构建运行视图直接链接到Artifactory中的构建信息:


触发构建对构件变化的反应

这个插件允许你设置一种新类型的触发器,周期性地轮询Artifactory中的一个路径,一个文件夹或一个单独的文件。只要在轮询元素中检测到更改,就会触发TeamCity构建。例如,当新的工件部署到Artifactory中的指定路径时,构建可能会被触发。

需要Artifactory Pro

触发构建只在Artifactory Pro中可用


要配置新的生成触发器,请执行管理,选择$ project_name | $ build_name然后,选择触发器。

单击添加新的触发器按钮以选择Artifactory构建触发器


建立触发器

选择Artifactory服务器URL目标库中。

为所选存储库完成有效部署人员的用户名和密码字段。

部署permssion

指定的用户必须对存储库具有部署权限

然后,在值得关注的项目,指定所选存储库中的路径,其中的更改将自动触发生成。

在Artifactory中定义构建触发器

在观看项目中尽可能具体

为了确定是否发生了更改,Artifactory必须遍历中指定的所有文件夹及其子文件夹注意事项.如果指定的文件夹有很多内容和子文件夹,这是一项资源密集型操作,可能会花费很长时间。

因此,我们建议在指定文件夹时尽可能具体注意事项



代理配置

如果通过代理访问Artifactory服务器,则需要通过在$ TEAMCITY_USER_HOME / .BuildServer / config / internal.properties文件。如果该文件不存在,则需要创建它。

Org.jfrog.artifactory.proxy.host org.jfrog.artifactory.proxy.port org.jfrog.artifactory.proxy.username org.jfrog.artifactory.proxy.password

从版本2.5.0开始,您还可以为特定的生成代理定义代理。您可以通过将TeamCity代理名称添加到上述属性名称的末尾来实现这一点。

例如,如果您希望为“my-agent”代理配置一个代理,代理属性配置应该如下所示:

org.jfrog.artifactory.proxy.host。我的经纪人org.jfrog.artifactory.proxy.port。我的经纪人org.jfrog.artifactory.proxy.username。我的经纪人org.jfrog.artifactory.proxy.password.my-agent

如果构建代理名称包含空白,则应将属性名称中的空白替换为\ u0020。

例如,下面介绍如何为默认代理”:

org.jfrog.artifactory。代理宿主默认\ u0020Agent


执照

TeamCity Artifactory插件在Apache v2许可证下可用。


发布说明

2.9.1(2021年6月6日
  1. 错误修复-由于缺少JSON属性,Artifactory响应解析可能会失败https://github.com/jfrog/build-info/pull/502
2.9.0(2020年12月1日
  1. 新的Artifactory Docker构建步骤
2.8.0(2019年1月3日
  1. 支持Teamcity 2018tcap - 322
  2. 允许使用只包含“build”的文件规范下载(“pattern”或“aql”不是强制性的)(tcap - 326
2.71(2018年8月20日
  1. 修复TeamCity 2018中的构建信息链接tcap - 318
  2. 允许在Artifactory中修改构建名称tcap - 210
  3. 使用文件规格时并行上传到Artifactorytcap - 315
2.6.0(2018年4月9日
  1. 大于5mb的文件使用范围请求并发下载tcap - 312
2.5.0 (2017年9月28日
  1. 允许每个代理进行代理配置tcap - 237
  2. 在文件规格中支持模式排除tcap - 300
  3. 文件规格AQL优化tcap - 302
  4. 错误修复tcap - 297tcap - 299tcap - 301tcap - 303
测试盒框(6月29日
  1. 支持TeamCity插件中的保留策略tcap - 283
  2. 支持x射线构建扫描tcap - 292
  3. 添加从文件规范上传和下载支持通用作业tcap - 294
  4. 允许使用文件规格提取受支持的格式tcap - 295
  5. 错误修复tcap - 167tcap - 293tcap - 296
2.3.1 (1月23日
  1. 支持全路径规格(TCAP-287
  2. 向文件规范添加按构建名称和编号下载工件的能力(tcap - 288
  3. 更改文件规格模式(tcap - 285
tripwire (1311月2016)
  1. 上传和下载文件规格支持通用作业tcap - 284
2.2.1 (19五月2016)
  1. 错误修正(tcap - 214
2.2.0 (213月2016)
  1. 错误修复(tcap - 238tcap - 239tcap - 241tcap - 244tcap - 245tcap - 247tcap - 250tcap - 258tcap - 236
2.1.13 (4五月2015)
  1. 支持多Artifactory构建触发器(tcap - 222
  2. 支持SBT构建工具(tcap - 223
  3. 错误修正(tcap - 214
2.1.12 (123月2015)
  1. 添加对自由文本存储库配置的支持(tcap - 217
2.1.11(2014年12月7日)
  1. 与Gradle 2的兼容性。x (tcap - 211
  2. 错误修正(tcap - 205
2.1.10(2014年5月8日)
  1. 错误修正(tcap - 206tcap - 72
2.1.9(2014年4月17日)
  1. 在Artifactory Build Info JSON中添加版本控制Url属性。(tcap - 203
  2. 对TeamCity 8.1版本管理特性问题的支持
  3. 支持使用maven 3.1.1
  4. 错误修正(tcap - 197tcap - 161
2.1.8(2014年1月15日)
  1. 允许远程存储库缓存用于生成触发tcap - 196
  2. 错误修复
2.1.7(2013年12月18日)
  1. 添加对blackduck集成的支持-tcap - 185
2.1.6(2013年9月3日)
  1. TeamCity 8.0。X完全兼容问题-tcap - 172
  2. 全局和构建证书问题tcap - 153
  3. 凭据问题刷新的存储库-tcap - 166
  4. Xcode构建上的通用部署解决方案tcap - 180
  5. 工作目录在Gradle构建问题-tcap - 125
2.1.5(2013年7月7日)
  1. 解决安全问题tcap - 172
  2. 〇提高一般分辨率bi - 152
2.1.4(2012年8月21日)
  1. 兼容TeamCity7.1。
  2. 错误修复
2.1.3(2012年5月30日)
  1. 与TeamCity7兼容。
  2. 在发布管理中支持“Perforce”。
  3. 在通用部署中为相同的源模式支持多个部署目标。
  4. 支持每次构建的自定义构建依赖项解析。
2.1.2(2011年12月12日)
  1. 与Gradle 1.0-milestone-6兼容。
2.1.1(2011年8月09日)
  1. 对Gradle里程碑-4的支持
  2. 更好地支持发布嵌套Maven项目
  3. 修复了轻微的Maven部署差异
2.1.0(2011年7月14日)
  1. 发布管理功能
  2. 错误修复
2.0.1(2011年1月9日)
  1. 自动快照/发布目标存储库选择
  2. 添加ivy/artifact部署模式
  3. 改进的Gradle支持
  4. 错误修复
2.0.0(2010年12月5日)
  1. 支持Gradle构建
  2. 支持maven3构建
  3. 默认部署器添加解析器凭据
  4. 支持多步骤构建
1.1.3(2010年11月21日)
  1. 包括/排除构件部署模式
1.1.2(2010年11月7日)
  1. 控件,用于在运行许可证检查时包含已发布的工件
  2. 限制许可证检查范围
  3. 控件,用于在运行许可证检查时关闭许可证发现
  • 没有标签
版权所有©2022 JFrog Ltd.