概述
流行的詹金斯Artifactory插件带来Artifactory的构建集成支持詹金斯。
此集成允许您的构建作业部署工件并解析与Artifactory之间的依赖关系，然后将它们链接到创建它们的构建作业。这个插件包含了大量的特性，包括一个丰富的管道API库而且Maven和Gradle版本的发布管理分期和推广。
插件目前需要版本2.159詹金斯或以上。
Jenkins Artifactory插件支持以下Jenkins Build job:
与JFrog管道的集成
一般
JFrog管道JFrog pipeline的1.6版本和Jenkins Artifactory Plugin的3.7.0版本支持与Jenkins的集成。该集成允许从JFrog pipeline触发Jenkins作业。Jenkins作业是使用JFrog Pipeline的本机Jenkins步骤触发的。当Jenkins作业完成时，它将向JFrog pipeline报告状态。
集成支持:
- 将构建参数传递给Jenkins作业。
- 将Jenkins的数据发送回JFrog管道。
设置集成
- 打开JFrog pipeline UI。
- 下集成，按添加一个集成按钮。
- 选择詹金斯服务器集成类型，并填写所有必需字段。
- 点击生成按钮生成令牌。Jenkins使用这个令牌通过JFrog pipeline进行身份验证。
- 复制回调URL和令牌，并将它们保存在詹金斯|管理|配置系统|JFrog管道服务器
从JFrog管道触发Jenkins作业
要从JFrog pipeline触发Jenkins作业，在管道yaml中添加Jenkins步骤，如下所示。
—名称:MyJenkinsStep类型:Jenkins配置:jenkinsJobName: < Jenkins -job- Name > Integrations:—名称:MyJenkinsIntegration
一旦Jenkins作业完成，它将向Jenkins步骤报告状态。
更多的选择
对于Jenkins中的管道作业，您还可以选择将信息从Jenkins发送回JFrog pipeline。这个信息将被JFrog pipeline作为JFrog pipeline中Jenkins步骤的输出资源接收。2022世界杯阿根廷预选赛赛程以下是如何将这些资源添加到Jenkins管道脚本:2022世界杯阿根廷预选赛赛程
jfpipeline (outputRe2022世界杯阿根廷预选赛赛程sources: """[{"name": "pipelinesBuildInfo"， "content": {"buildName": "${env. outputResources: " {"JOB_NAME}”、“buildNumber”:“$ {env。Build_number}"}}]""")
默认情况下，Jenkins作业状态和可选输出资源在作业完成时由Jenkins发送到JFrog pipeline。2022世界杯阿根廷预选赛赛程不过，您还可以选择在Jenkins作业结束之前发送状态和输出资源。2022世界杯阿根廷预选赛赛程你可以这样做:
jfpipes (reportStatus: "SUCCESS")
在Jenkins向JFrog pipeline报告状态后，它不等待来自JFrog pipeline的任何响应，作业立即继续到下一步。
您还可以选择将reportStatus和outputResources放在一起，如下所示:2022世界杯阿根廷预选赛赛程
jfpipeline (reportStatus: "SUCCESS"， outputRe2022世界杯阿根廷预选赛赛程sources: """[{"name": "pipelinesBuildInfo"， "content": {"buildName": "${env. jfpipeline: ${env. jfpipeline: ${env. jfpipeline: ${env. jfpipeline: " {"name": "JOB_NAME}”、“buildNumber”:“$ {env。Build_number}"}}]""")
支持的状态有SUCCESS、不稳定、FAILURE、NOT_BUILT或ABORTED。
Jenkins作业将只向JFrog pipeline报告一次状态。如果你没有像上面所示的那样报告作为管道脚本的一部分的状态，Jenkins将在作业完成时报告它。
多个配置(自由泳)项目
一个多个配置项目可以用来避免重复许多由不同构建所执行的类似步骤。
该插件的使用方式与其他Freestyle构建相同，但在“将构件部署到Artifactory”下，您会发现一个强制性的“组合匹配”字段，在该字段中您可以输入插件将部署构件的特定矩阵组合。
组合匹配字段
在这里，您可以指定您想要的构建组合部署通过一个返回true或false的Groovy表达式。
当您在这里指定一个Groovy表达式时，只有生成的构建组合真正的将被部署到Artifactory。在计算表达式时，多配置轴作为变量公开(其值设置为计算的当前组合)。
Groovy表达式使用与中相同的语法滤光片组合下配置矩阵
例如，如果你正在为不同的jdk构建不同的代理，你可以指定以下内容:
部署“如果linux和jdk7都是无效的” |
jdk !(标签= =“linux”& & = =“jdk7” |
部署“如果在主机上，只需执行jdk7” |
(标签= =“大师”).implies (jdk = =“jdk7”) |
重要提示
不支持通过多个矩阵作业部署相同的Maven工件!
触发构建
的Artifactory触发允许在特定Artifactory路径中添加或修改文件时自动触发Jenkins作业。触发器定期轮询Artifactory，以检查作业是否应该被触发。
要启用Artifactory触发器，请遵循以下步骤:
1.在Jenkins作业UI中，转到建立触发器，并查看使Artifactory触发复选框。
2.选择一个Artifactory服务器．
3.中定义cron表达式时间表字段。例如，每十分钟拉一次Artifactory，设置*/10 * * * *
4.设置一个路看．例如，设置时generic-libs-local /构建/星际飞船，詹金斯在/构建/星际飞船文件夹下的generic-libs-local在Artifactory中存储新的或修改过的文件。
JIRA集成
Jenkins插件可以与詹金斯JIRA插件记录构建的影响问题，并将这些问题包含在Artifactory中的build Info描述符中，并作为已部署工件的可搜索属性。
SCM提交消息必须包括JIRA问题ID。例如:HAP-007 -摇，不是搅
要激活JIRA集成，请确保Jenkins设置了有效的JIRA站点配置，并选择使JIRA集成在任务配置页面中:
从以前的构建中聚合问题
可以在部署到Artifactory的构建中收集受此构建以及以前构建影响的所有JIRA问题。例如，这允许您查看从上一个版本到当前版本之间的所有问题，如果构建是一个新版本构建—则可以查看新版本中解决的所有问题。
要跨构建累积JIRA问题，请选中“从以前的构建累积问题”选项，并配置聚合应该从的最后一个构建状态开始。默认的最后状态是“已发布”(不区分大小写)，这意味着聚合将从最后一个“已发布”构建之后的第一个构建开始。
建立隔离
目前仅在Free-Style和Maven作业中支持构建隔离。
当并行执行相同的集成(快照)构建链时，可能会出现这样的情况:下游构建解析的快照依赖不是触发构建时存在的原始依赖。
当根上游构建运行并触发依赖于其生成的构件的下游构建时，就会发生这种情况。然后，在运行的下游构建完成之前，上游会再次运行，因此这些构建可能会解决新创建的上游工件，这些工件并不适合它们，从而导致冲突。
解决方案
Jenkins插件为它的Maven/Gradle构建提供了一个新的复选框“为下游构建启用隔离解析”，它会生成一个新的“构建”。添加到解析URL的root属性。
对象将读取此属性直接该构建的子构件，并将它们分别移植到它们的解析url中，从而确保解析的父构件是在运行构建之前构建的。
Maven
为了让Maven使用上述特性，只需要为根构建选中复选框，并通过使用“从Artifactory解析工件”特性确保所有工件都从Artifactory解析。这将强制Maven在Maven构建中使用解析URL，同时使用“构建”。属性作为解析URL中的矩阵参数。
Gradle
一旦检查了“为下游构建启用隔离解析”，则构建。根属性将被添加到所有现有的解析器。
排除的工件和BuildInfo
默认情况下，当为工件提供排他模式时，它们不会被部署到Artifactory中，但它们会被包含在最终的BuildInfo JSON中。
通过标记“筛选从构建信息中排除的工件”，排除的工件将出现在BuildInfo内部的不同部分中，通过这一点，提供了对整个构建的清晰理解。
这对于提升过程也是至关重要的，因为它扫描您的BuildInfo JSON并试图提升那里的所有构件，当您排除构件时，它将失败，除非您标记此选项。
丢弃旧的构建
若要在管道作业中使用此功能，请参阅其中一个触发构建保留部分的Artifactory Pipeline api文档页．
Jenkins项目配置允许您指定处理旧版本的策略。
您可以根据年龄或数量删除旧的构建，方法如下:
保持构建的天数 |
在删除构建之前应保留的天数 |
要保留的最大构建数量 |
应该保留的构建的最大数量。当创建一个新的构建时，最早的构建将被删除 |
定义了这些参数之后，在Post-build行动section，您可以指定Artifactory也应该根据以下设置丢弃旧的构建:
丢弃Artifactory中的旧构建 |
配置Artifactory以根据上面的Jenkins项目设置丢弃旧的构建 |
丢弃构建构件 |
配置Artifactory以丢弃构建中的工件 |
配置带有变量的存储库
本节只与Free-Style和Maven作业相关。
可以选择文本模式，在该模式中可以键入目标存储库。
在目标存储库名称中，可以使用在构建时动态替换为值的变量。
变量应该用$符号前缀指定，并用花括号括起来。
例如:${deployRepository}， ${resolveSnapshotRepository}， ${repoPrefix}-${repoName}等。
变量替换为来自以下作业环境之一的值:
- 预定义的Jenkins环境变量。
- Jenkins属性(阅读更多詹金斯维基）
- 在“此构建是参数化的”部分的Jenkins配置中配置的参数——这些参数可以由来自UI的值或使用Jenkins REST API替换。
- 通过Jenkins插件(例如“EnvInject”)注入变量。
动态禁用构件和构建信息的部署
Maven、Gradle和Ivy构建可以配置为将工件和/或构建信息部署到Artifactory。例如，在Gradle构建的情况下，你会设置发布库场和检查捕获并发布构建信息。Maven和Ivy具有类似(尽管略有不同)的配置参数。通过设置这些参数，您可以分别配置每个构建工具，将构建工件和/或构建信息部署到Artifactory。但是，在某些特定情况下，您可能希望覆盖此设置并禁用部署工件和构建信息。在这些情况下，您可以将以下两个系统属性传递给任何构建工具:
- artifactory.publish.artifacts
- artifactory.publish.buildInfo
例如，对于Maven构建，可以将这些系统属性添加到目标和选择字段如下:
清洁安装-Dartifactory.publish。工件= false -Dartifactory.publish.buildInfo = false
要动态地控制这些属性，可以用Jenkins变量或如下所定义的环境变量替换这些值
清洁安装-Dartifactory.publish。工件= $ PUBLISH_ARTIFACTS -Dartifactory.publish.buildInfo = $ PUBLISH_BUILDINFO
使用Jenkins工作DSL插件
Jenkins Job DSL插件允许使用DSL编程创建作业。使用Jenkins Job DSL插件，您可以创建Jenkins作业来运行Artifactory操作。要了解Jenkins作业DSL，请参阅工作DSL教程．
要查看每种类型的Jenkins作业的Seed作业示例和说明，请参见jenkins-job-dsl-examples．
观看视频
要看到詹金斯Artifactory集成在行动中，您可以观看以下截屏。
