使用最新的JFrog产品?hth华体会最新官方网站
JFrog平台用户指南


跳到元数据的末尾
转到元数据开始

概述

JFrog Distribution允许从一组Artifactory文件创建发布包,这些文件被分发到Artifactory边缘节点位于偏远地区的。

发布包将作为发布的一部分的内容组合在一起,为软件发布提供了材料清单。例如,您可以将不同的构建构件(如Docker映像)组合在一起,这些构件组成了您的软件发布,然后可以将其推送到您的销售点设备。

Release Bundle是安全且不可变的,确保未经授权的用户无法进行任何操作。

页面内容


创建一个发布包

JFrog Distribution支持从任何Artifactory服务创建和分发发布包,它通过JFrog任务控制连接到这些服务。每个发布包可能只包含来自单个Artifactory服务的工件。

为了创建一个发布包,Distribution会对Artifactory运行查询,以检索所需的工件引用和属性。只有触发用户能够访问的那些工件才能被收集到发布包中。

为了防止篡改发布包,JFrog发行版使用GPG密钥.然后,Artifactory Edge使用相同的GPG密钥来验证发布包,然后它才被接受。

发布包可以使用REST API或通过JFrog Distribution UI创建。在任何一种情况下,您都可以通过一组您可以定义的查询来定义要包含在发布包中的工件。

创建一个发布包需要发布Bundle写权限

一个发布包版本可以包含多达3,000个工件。这个数字在产品中没有限制,但是超过这个数字是非常不推荐的。


使用REST API

方法可以创建发布包创建发布包版本REST API调用。

使用UI

要创建一个新的发布包:

  1. 点击添加一个发布包从发布包页面。
  2. 点击创建.这将创建一个草案发布包可以进行编辑签署,最后是分布式的

    或者,您可以通过单击跳过草稿阶段创建并签名在没有草稿阶段的情况下签署并完成程序。
    请注意:无法编辑已签名的发布包。

Release Bundle页面分为三个面板:一般的细节规范而且发布说明

一般的细节:

的名字
发布包名称。
版本
发布包版本。
描述
发布包描述。

规范:

此部分指定将从其中组装发布包的Artifactory服务(记住,一个发布包只能从单个Artifactory服务组装),以及将用于组装工件的不同查询。有关如何定义查询的详细信息,请参阅添加查询

源Artifactory
将从中收集工件的源Artifactory服务。
的名字
查询名称。
查询
查询详细信息。

版本说明:

这个部分指定发行包的发行说明。

类型
发布说明格式。支持的类型包括:Markdown, Asciidoc和纯文本。
编辑|预览
使用这些链接以您选择的格式编辑发行说明,然后预览它们呈现后的外观。

添加查询

有两种方法可以构建查询:使用AQL和使用简单的查询构建器。

若要选择构建查询的方式,请将鼠标悬停在“创建查询”上方。

创建查询

使用AQL

要添加AQL查询,在“创建查询”下,选择添加AQL查询

这将启动一个3步向导。

查询详细信息步骤,为您的查询提供一个名称,并提供用于组装工件的AQL表达式。

添加AQL查询

使用查询生成器

查询生成器允许您通过填写一个简单的表单来构建查询。您输入的参数最终会转换为一个AQL查询,您可以通过设置显示AQL复选框在表单的末尾。

要使用查询构建器,请在Create query下选择添加查询

这将启动一个3步向导。

查询详细信息步骤,首先为查询指定一个名称。你可以指定不同的搜寻条件,包括:

  • 库名称
  • 建立名称和编号
  • 具有特定值的属性
  • 包括和排除模式

注意,您可以通过单击参数右侧的“+”按钮为每个参数指定多个值。
使用|或者选项您可以添加多个属性,只需单击一个按钮。

预览工件

在指定您的查询细节之后(无论是使用AQL查询还是查询构建器),您可以查看将包含在您的发布包中的构件预览工件选项卡。

预览工件

屏蔽构件

为了防止有问题或漏洞的工件被交付到它们的目标Artifactory服务,发布包含JFrog Xray阻止下载的工件的包安全规则或者一个许可规则,不能签名,因此不能分发。如果您用来为发布包选择工件的查询拉入了一个阻塞的工件,那么该工件将包含在发布包中,而x光状态列将指示它已被阻塞。尝试签名此发布包将失败,分发版将显示错误消息。

如果工件停止阻止下载,您需要再次运行将工件拉入发布包的查询,这样它被阻止的指示就会被删除。一旦“Blocked”指示被移除,发布包就可以被签名和分发了。

请注意,如果为发布包指定的源或目标Artifactory服务没有正确有效的许可证,分发将显示错误。

许可错误

额外的细节

附加细节选项卡允许你为你的发布包指定另外两个参数:

额外的细节

额外的属性
指定一个属性列表,这些属性将在发布过程中附加到您的发布包中的所有工件上,除了那些它们已经拥有的。
路径映射
指定一个映射列表,以根据工件在源Artifactory服务中的位置来管理将工件放置在目标Artifactory服务中的位置。你可以使用任何路径映射模板提供,或设置您自己的自定义映射。
路径映射模板

为了方便起见,JFrog Distribution提供了一组常用的模板,您可以用来设置路径映射。只需选择Use Template下面列出的一个模板,然后修改占位符以符合您的设置。

提供的模板是:

改变库
源Artifactory服务上的特定存储库中的所有文件都映射到目标上的不同存储库。
改变文件夹
所有文件都被移动到目标中的特定文件夹中。
重命名文件夹
源Artifactory服务上特定文件夹中的所有文件都映射到目标上的不同文件夹。

路径映射模板

在发布包中包含Docker映像

简化的Docker映像查询

从发行版1.8.0开始,作为创建新的发布包的一部分,指定与清单匹配的查询条件就足够了。所需的docker映像的Json。分发将包括与清单相关联的Docker映像的所有Docker层。json文件。

例如,我们在Docker存储库中有一个PostgreSql版本11.1的Docker映像docker-local
存储库的内容具有以下层次结构:

docker本地postgres 11.1清单。Json sha256__060245e5c0563270b03cc4af67a284bdce3f5893be3e71eb9d60190861ebcb7 sha256__1e967d04951bfd1b483ae316c40058fed4b154a2e84efb54dfc91204e73f6667 sha256__2ad14c51497d15dcaf0e6fd47457de1aee3eab7a1170bda4610dc9cd89c34c8a…

manifest.json文件包含以下属性:

docker.manifest.digestsha256: acb7f2b2e9bd560a32c0ba01991870f56f89deeff5f3224bc50aac2a98b7f73e

所有其他的文件docker-local / postgres / 11.1是构成这张特定图像的图层。

要在映像中包括所有构件(清单和层),指定一个将匹配的查询条件就足够了manifest.json所需的Docker映像,例如:

物品。找到({”和“美元:[{”或“美元:[{“回购”:{" $ eq”:“docker-local " } } ] }, { "$ ”或“({:@docker.manifest。摘要":"sha256:acb7f2b2e9bd560a32c0ba01991870f56f89deeff5f3224bc50aac2a98b7f73e"}]}]})



查看发布包

发布包模块允许你在一个地方查看由JFrog Distribution管理的所有发布包。

的名字
发布包名称。
最新版本
发布包的最新版本。
分配ID
分发作业的顺序编号。只显示最后3个分发作业。
状态
分发作业状态。
边缘节点
边缘节点分布进度百分比。

要查看单个发布包,请从release bundle模块中单击它。

Release Bundle页面显示了三个信息面板:

版本:此发布包的版本列表。选择任意版本查看其详细信息。

一般信息:屏幕顶部的面板显示了版本、描述、创建日期、状态和发布包的大小等一般信息

细节:该面板通过一系列选项卡显示所选发布包版本的详细信息:内容发布说明分布跟踪,规范

具体说明如下:

内容选项卡

Content选项卡显示了组成发布包的构件、构建和元数据。

单击任何工件或构建,在选项卡的右边面板中查看关于它的详细信息。

点击直接访问

单击工件的源路径,将被重定向到相应Artifactory服务的树浏览器中的正确位置。


如果JFrog Xray阻止了该工件的下载(在这种情况下,您将无法签署和分发发布包),这将在x光状态中所选工件的字段内容选项卡。


版本说明标签

Release Notes选项卡显示bundle的发行说明。这些可以用记帐、ascii或纯文本书写。

分布跟踪选项卡

Distribution Tracking选项卡提供了此发布包版本的历史记录。

销售跟踪

ID

分发操作的ID。

具有相同ID的多行

您可能会在该表中看到具有相同ID的多行,因为单个分发操作可能会将发布包分发到多个目标节点

行动
执行的操作
开始
行动开始的日期和时间
目的地

销售目标

点击直接访问

单击要直接重定向到其UI的分发目标名称

状态

操作的状态

进步
操作完成的百分比和完成时尝试的次数
细节

关于行动的一些细节的总结。

点击查看详情

单击此字段可获得操作的全部详细信息。在这里,您可以在出现错误时获得更多详细信息。

重新分发一个发布包

发布版本包可能会因为不同的原因而失败,比如网络问题或目标Artifactory服务的中断。一旦解决了阻止发布的问题,就可以将发布包重新发布到发布失败的服务。要重新分发发布包,首先要选择它们。分布呈现出重新分配所选每个分发版的图标。您现在可以单击该图标将每个发布包单独重新分发到指定的目标服务,或者选择重新分配按钮,将发布包重新分发到批处理过程中选择的所有目标服务。

过滤器

使用筛选器只显示那些失败的发行版。

规范标签

Spec选项卡显示源Artifactory服务,这个发布包的构件就是从这个源Artifactory服务组装的,以及组装构件的查询列表。


单击Artifactory服务

单击Artifactory服务将在该服务的主屏幕上打开一个新选项卡

单击任意一个查询展开它,显示管理发布包工件组装的查询的详细信息。

你甚至可以检查AQL复选框查看用于组装工件的最终AQL查询。


编辑发布包

  1. 要编辑发布包,请选择编辑的版本行动列表。状态设置为开放
  2. 点击保存保存发布包的“草稿”版本。继续保存每次在编辑模式下进行更改时。

    点击保存并签署签署并完成流程。
    请注意
    :无法编辑已签名的发布包。



签署发布包

签署一个发布包将完成创建一个发布包的过程。这将版本包的状态设置为签署并且发布包不能再被编辑。

此外,Distribution将触发源Artifactory将已签名的发布包的内容克隆到孤立的release-bundles存储库

  1. 您可以从编辑发布包页面或从新发布包页面签署发布包。
  2. 点击标志

    屏蔽构件

    如果发布包包含任何被JFrog Xray阻止下载的工件,那么您对发布包的签名尝试将失败,分发版将显示一条错误消息。因此,您将无法分发此发布包。

  3. 继续分发发布包当准备好了。

克隆发布包

要克隆现有的发布包版本,请选择克隆版本行动下拉菜单。

这将复制发布包规范,包括它的名称和查询,到一个新的发布包页面中。然后可以相应地调整和保存页面上的详细信息。



属性

在创建发布包时,会从中获取工件属性Artifactory到发布包中。方法在初始发布包版本创建过程中可以添加其他自定义属性创建发布包REST API。这些属性作为分发过程的一部分被转移到边缘节点。


发布发布包

一旦您创建了您的发布包,您就可以将它分发到您所在的Artifactory Edge节点有权分发给

信任圈

如果发布包与Artifactory边缘节点处于同一信任圈内,那么发布包只能从Artifactory服务分发到Artifactory边缘节点。要了解如何建立信任圈,请参考Cross-Instance身份验证在JFrog访问用户指南中。

分布负责触发从源Artifactory到边缘节点的复制过程。首先,它将发布包信息复制到每个边缘节点,然后在源Artifactory中启动复制过程。

要分发您的发布包,请从发布包模块,或使用分发发布包REST API。

分发从任务控制中心获取可用的边缘节点,并根据特定的用户权限显示可用的边缘节点列表。

要发布发布包的旧版本,请从发布包模块中单击它,选择您想要发布的版本,然后单击“发布”。


删除发布包

您可以使用分发UI或删除发布包REST API调用。适用于具有发布Bundle删除权限

要删除现有的发布包版本,请选择删除行动下拉菜单。

删除发布包

有两种类型的删除选项:

删除发布包


AQL搜索发布包

要在Artifactory Edge节点中搜索发布包,您可以使用释放而且release_artifact在Artifactory 6.0中引入AQL的域。详情请参阅实体和字段

  • 没有标签