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