概述
流行的Jenkins Artifactory Plugin带来Artifactory的构建集成支持詹金斯。
这种集成允许您的构建作业部署工件，并解析与Artifactory之间的依赖关系，然后将它们链接到创建它们的构建作业。这个插件包含了大量的特性，包括一个丰富的管道API库而且Maven和Gradle版本的发布管理与分期和推广。
插件当前需要版本2.159或高于詹金斯。
Jenkins Artifactory插件支持以下Jenkins Build job:
与JFrog管道集成
一般
JFrog管道从JFrog管道的1.6版和Jenkins Artifactory插件的3.7.0版开始，就支持与Jenkins的集成。这种集成允许从JFrog Pipelines触发Jenkins作业。Jenkins作业是使用JFrog Pipeline的本地Jenkins步骤触发的。当Jenkins作业完成时，它将状态报告给JFrog Pipelines。
集成支持:
- 将构建参数传递给Jenkins作业。
- 将Jenkins的数据发送回JFrog管道。
设置集成
- 打开JFrog Pipelines UI。
- 下集成，按添加集成按钮。
- 选择詹金斯服务器集成类型，并填写所有必需的字段。
- 点击生成按钮以生成令牌。Jenkins使用这个令牌通过JFrog pipeline进行身份验证。
- 复制回调URL和令牌，并将它们保存在詹金斯|管理|配置系统|JFrog管线服务器
从JFrog管线触发Jenkins作业
要从JFrog Pipelines中触发Jenkins作业，在管道yaml中添加Jenkins步骤，如下所示。
—Name: MyJenkinsStep Type: Jenkins配置:jenkinsJobName: < Jenkins -job- Name >集成:—Name: MyJenkinsIntegration
一旦Jenkins作业完成，它将向Jenkins步骤报告状态。
更多的选择
对于Jenkins中的管道作业，您还可以选择将信息从Jenkins发送回JFrog管道。这个信息将被JFrog管道接收，作为JFrog管道中Jenkins步骤的输出资源。2022世界杯阿根廷预选赛赛程以下是如何将这些资源添加到Jenkins管道脚本:2022世界杯阿根廷预选赛赛程
jfPipelines (outputR2022世界杯阿根廷预选赛赛程esources: """[{"name": "pipelinesBuildInfo"， "content": {"buildName": "${env. env. outputResources: "JOB_NAME}"， "buildNumber": "${env. "Build_number}"}}]""" ")
默认情况下，当作业完成时，Jenkins会将Jenkins作业状态和可选输出资源发送到JFrog Pipelines。2022世界杯阿根廷预选赛赛程但是，您还可以选择在Jenkins作业结束之前发送状态和输出资源。2022世界杯阿根廷预选赛赛程你可以这样做:
jfPipelines (reportStatus: "SUCCESS")
在Jenkins将状态报告给JFrog Pipelines之后，它并不等待JFrog Pipelines的任何响应，作业立即继续到下一步。
您还可以选择将reportStatus和outputResources放在一起，如下所示:2022世界杯阿根廷预选赛赛程
jfPipelines (reportStatus: "SUCCESS"， outputR2022世界杯阿根廷预选赛赛程esources: """ "[{"name": "pipelinesBuildInfo"， "content": {"buildName": "${env. env. "JOB_NAME}"， "buildNumber": "${env. "Build_number}"}}]""" ")
支持的状态有SUCCESS、stable、FAILURE、NOT_BUILT、ABORTED。
Jenkins作业将只向JFrog pipeline报告一次状态。如果您没有像上面所示的那样将状态报告为管道脚本的一部分，Jenkins将在作业完成时报告它。
多配置(自由式)项目
一个多个配置项目可以用来避免重复许多类似的步骤，否则将由不同的构建生成。
该插件的使用方式与其他Freestyle版本相同，但在“将工件部署到Artifactory”下，你会发现一个强制性的*组合匹配*字段，在这里你可以输入插件将部署工件的特定矩阵组合。
组合匹配字段
在这里，您可以指定您想要的构建组合部署通过返回true或false的Groovy表达式。
当您在这里指定一个Groovy表达式时，只有生成的组合真正的将被部署到Artifactory。在计算表达式时，多个配置轴作为变量公开(它们的值设置为当前计算的组合)。
Groovy表达式使用与滤光片组合下配置矩阵
例如，如果你为不同的jdk构建不同的代理，你可以指定如下:
部署“如果linux和jdk7都是无效的” |
(label=="linux" && jdk=="jdk7" |
部署“如果在master上，只执行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插件可以与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使用上述特性，只需要为根构建选中复选框，并通过使用“Resolve artifacts from Artifactory”特性确保所有工件都从Artifactory解析。这将强制Maven使用Maven构建的解析URL，以及“build”。属性作为解析URL中的矩阵参数。
Gradle
一旦“为下游构建启用隔离解析”被选中，构建。根属性将被添加到所有现有的解析器。
排除的工件和BuildInfo
默认情况下，当为工件提供排除模式时，它们不会被部署到Artifactory中，但会被包含在最终的BuildInfo JSON中。
通过标记“从构建信息中筛选排除的构件”，排除的构件将出现在BuildInfo内部的不同部分中，并通过这提供了对整个构建的清晰理解。
这对于提升过程也是至关重要的，因为它扫描您的BuildInfo JSON并试图提升那里的所有工件，当您排除工件时，它将失败，除非您标记此选项。
丢弃旧版本
要在管道作业中使用此功能，请参考触发构建保留的部分Artifactory Pipeline api文档页．
Jenkins项目配置允许您指定处理旧版本的策略。
您可以根据年龄或数量删除旧版本，如下所示:
维护构建的天数 |
在删除构建之前应保留的天数 |
要保留的最大构建数量 |
应该保留的构建的最大数量。创建新构建时，将删除最旧的构建 |
定义了这些参数之后，在Post-build行动section，您可以指定Artifactory也应该根据以下设置丢弃旧的构建:
丢弃Artifactory的旧构建 |
根据上面的Jenkins项目设置配置Artifactory以丢弃旧的构建 |
放弃构建构件 |
配置Artifactory以丢弃构建中的工件 |
使用变量配置存储库
本节仅与Free-Style和Maven作业相关。
您可以选择文本模式，在其中键入目标存储库。
在目标存储库名称中，可以使用将在构建时动态替换为值的变量。
变量应该用$符号前缀指定，并用花括号括起来。
例如:${deployRepository}、${resolveSnapshotRepository}、${repoPrefix}-${repoName}等。
变量由来自以下作业环境之一的值替换:
- 预定义Jenkins环境变量。
- Jenkins属性(阅读更多詹金斯维基）
- 在“此构建已参数化”部分的Jenkins配置中配置的参数——这些参数可以由来自UI的值或使用Jenkins REST API替换。
- 通过Jenkins的一个插件(例如“EnvInject”)注入变量。
动态禁用构件和Build-info的部署
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 Job DSL Plugin
Jenkins Job DSL插件允许使用DSL以编程方式创建作业。使用Jenkins Job DSL插件，您可以创建Jenkins作业来运行Artifactory操作。要了解Jenkins工作DSL，请参阅职业DSL教程．
要查看每种类型Jenkins作业的Seed作业示例和说明，请参见jenkins-job-dsl-examples．
观看录像
要看到詹金斯Artifactory集成的行动，您可以观看以下截屏。
