Artifactory 4.倍

5.使用Artifactory。x ?
JFrog Artifactoryx用户指南

全部展开 全部折叠

有问题吗?想要报告问题?联系JFrog支持

跳到元数据的末尾
进入元数据的开始

概述

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模块支持)，Gradle，NAnt，MSBuild，FxCop而且知识产权．

页面内容

安装插件

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

从网站下载插件2.3.1版(最新版本)在这里．

删除旧版本

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

配置

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

配置系统范围的Artifactory服务器

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

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

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

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

配置Artifactory服务器

配置特定于项目的运行程序

编辑项目特定的配置

要设置一个项目运行器，将构建信息和工件部署到Artifactory，请转到项目管理并选择要配置的项目。

然后，在构建配置部分，单击编辑要配置的版本的链接。

下生成配置设置，选择相关的构建步骤然后点击编辑要配置的生成步骤的链接。

中选择值时Artifactory服务器URL字段时，将查询所选服务器以获得已配置存储库的列表(使用对应的Artifactory服务器配置)。这就填充了目标库字段，其中包含可选择部署到的存储库列表。

点击自由文本模式复选框允许您以自由文本的形式键入存储库名称。你也可以将变量作为文本的一部分。
例如:libs-%variableName%

配置错误

如果目标库list保持为空，检查指定的Artifactory服务器URL、凭据和代理信息(如果提供)是否有效。

关于可能发生的通信错误的任何信息都可以在TeamCity服务器日志中找到。



运行License检查

如果您正在使用Artifactory Pro，您可以从许可证管理的商品作为构建的一部分发现和处理第三方依赖项许可问题的特性。
如果你查看运行许可证检查复选框，Artifactory将扫描并检查此构建使用的所有依赖项的许可证。还可以指定应通过电子邮件接收任何许可证违反通知的收件人列表。

黑鸭代码中心集成

如果您正在使用Artifactory Pro，并有一个帐户黑鸭子代码中心，您可以通过自动的、非侵入性的、开源组件审批流程运行构建，并监视安全漏洞。

黑鸭代码中心集成

通用构建集成

通用构建集成为以下运行程序类型提供了构建信息支持:

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

这允许上面的构建:

  1. 上传任何工件到Artifactory，连同自定义属性元数据，并保持已发布的工件与TeamCity构建相关联。
  2. 从Artifactory下载构建所需的构件。

您可以使用“文件规格”或“遗留模式”来定义要上传和下载的构件。

文件规格

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

遗留模式(已弃用)

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

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

配置通用上传

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

如果没有找到匹配的工件，请记住，这些参数可能是区分大小写的，这取决于运行它们的操作系统、代理和服务器。

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

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

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

添加一个新参数

填写相应的字段。

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

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

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

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

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

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


指定系统属性和环境变量

查看项目特定的配置

中可以查看现有项目配置设置下项目| $PROJECT_NAME | $BUILD_NAME:

查看项目特定的配置

使用Artifactory插件运行构建

一旦您完成了项目运行器的设置，您就可以运行项目构建。Artifactory插件在构建结束时生效，并执行以下操作:

  1. 对于所有构建运行器类型——将指定的已发布构件发布到选定的目标存储库，并应用相应的路径映射。
  2. 对于Maven或Ivy/Ant构建运行器——在构建结束时将所有工件一起部署到选定的目标存储库(而不是像Maven和Ivy那样在每个模块构建结束时分别部署)。
  3. 将Artifactory BuildInfo部署到Artifactory，提供Artifactory中构建的完整可追溯性，链接回到TeamCity中的构建。

    建立日志

你也可以从构建运行视图中直接链接到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

执照

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

观看录像

要查看Teamcity插件的实际运行情况，您可以观看下面的简短演示视频。

更改日志

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 - 238，tcap - 239，tcap - 241，tcap - 244，tcap - 245，tcap - 247，tcap - 250，tcap - 258，tcap - 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 - 206，tcap - 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 - 197，tcap - 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. 控件，用于在运行许可证检查时关闭许可证发现
  • 没有标签