使用最新的JFrog产品?hth华体会最新官方网站
JFrog平台用户指南
JFrog发行x文档
要获取最新版本,请访问JFrog统一平台
创建发布包
JFrog分发支持创建和分发通过JFrog任务控制连接到的任何Artifactory服务的发布包。每个发布包可能只包含来自单个Artifactory服务的工件。
为了创建一个发布包,Distribution运行对Artifactory的查询,以检索所需的工件引用和属性。只有触发用户可以访问的那些工件才能收集到发布包中。
为了防止对发布包进行篡改,JFrog发行版使用GPG密钥.然后,Artifactory Edge使用相同的GPG密钥在接受发布包之前对其进行验证。
可以使用REST API或通过JFrog分发UI创建发布包。在任何一种情况下,您都可以通过一组您可以定义的查询来定义要包含在发布包中的工件。
创建一个发布包需要发布包写权限.
一个发布包版本可以包含多达3000个工件。这个数字在产品中没有限制,但非常不建议超过它。
使用REST API
控件创建发布包创建发布包版本REST API调用。
使用UI
创建一个新的发布包:
- 点击添加一个发布包从发布包页面。
- 点击创建.这将创建一个发布包草案可以编辑,签署,最后分发.
或者,您可以通过单击跳过草稿阶段创建和签名在没有草案阶段的情况下签署并完成程序。
请注意:签名的发布包不能编辑。
发布包页面分为三个面板:一般的细节,规范和发布说明.
一般的细节:
名字 |
发布包的名称。 |
版本 |
发布包版本。 |
描述 |
发布包描述。 |
规范:
此部分指定了用于组装发布包的Artifactory服务(请记住,一个发布包只能由单个Artifactory服务组装),以及将用于组装工件的不同查询。有关如何定义查询的详细信息,请参阅添加查询.
源Artifactory |
将从中收集工件的源Artifactory服务。 |
名字 |
查询名称。 |
查询 |
查询细节。 |
版本说明:
本节指定发布包的发布说明。
类型 |
发行说明格式。支持的类型包括:Markdown, Asciidoc和纯文本。 |
编辑|预览 |
使用这些链接以您选择的格式编辑发行说明,然后预览它们呈现后的外观。 |
添加查询
有两种方法可以构建查询:使用AQL和使用简单的查询构建器。
若要选择构建查询的方式,请将鼠标悬停在“创建查询”上方。
使用AQL
要添加AQL查询,请在Create query下选择添加AQL查询.
这将启动一个3步向导。
在查询详细信息步骤,为您的查询指定一个名称,并提供用于组装工件的AQL表达式。
使用查询生成器
查询生成器允许您通过填写一个简单的表单来构建查询。您输入的参数最终将转换为AQL查询,您可以通过设置显示AQL复选框。
要使用查询生成器,请在Create query下选择添加查询
这将启动一个3步向导。
在查询详细信息步骤,首先为查询指定一个名称。然后,您可以指定不同的搜索条件,包括:
- 库名称
- 构建名称和数字
- 具有特定值的属性
- 包含和排除模式
注意,您可以通过单击参数右侧的“+”按钮为每个参数指定多个值。
使用And | Or选项,您可以添加多个属性在一个单一的单击按钮。
预览工件
指定查询详细信息之后(无论是使用AQL查询还是使用查询构建器),您可以查看将包含在您的发布包中的工件预览工件选项卡。
屏蔽构件
注意,如果为发布包指定的源或目标Artifactory服务没有正确有效的许可证,Distribution将显示一个错误。
额外的细节
附加细节选项卡允许你为发布包指定两个参数:
额外的属性 |
指定一个属性列表,这些属性将在发布过程中附加到您的发布包中的所有工件上,除了那些它们已经拥有的。 |
路径映射 |
根据工件在源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-local postgres 11.1 manifest。sha256__060245e5c0563270b03cc4af67a284bdce3e7e9d60190861ebcb7 sha256__1e967d04951bfd1b483ae316c40058fed4b154a2e84efb54dfc91204e73f6667 sha256__2ad14c51497d15dcaf0e6fd47457de1aee3eab7a1170bda4610dc9cd89c34c8a…
的manifest.json
文件包含以下属性:
docker.manifest.digest=
sha256: acb7f2b2e9bd560a32c0ba01991870f56f89deeff5f3224bc50aac2a98b7f73e
所有其他的文件docker-local / postgres / 11.1
是组成这个特定图像的图层。
要包括图像中的所有工件(清单和层),只需指定匹配的查询条件即可manifest.json
的所需的Docker映像,例如:
物品。找到({”和“美元:[{”或“美元:[{“回购”:{" $ eq”:“docker-local " } } ] }, { "$ ”或“({:@docker.manifest。摘要":"sha256:acb7f2b2e9bd560a32c0ba01991870f56f89deeff5f3224bc50aac2a98b7f73e"}}]})
查看发布包
发布包模块允许您在一个地方查看由JFrog Distribution管理的所有发布包。
名字 |
发布包的名称。 |
最新版本 |
发布包的最新版本。 |
分配ID |
分发作业的序号。只显示最后3个分发作业。 |
状态 |
分发作业状态。 |
边缘节点 |
边节点分布进度百分比。 |
要查看单个发布包,请在release bundle模块中单击它。
发布包页面显示了三个信息面板:
版本:此发布包的版本列表。选择任意版本以查看其详细信息。
一般信息:屏幕顶部的面板显示一般信息,如版本、描述、创建日期、状态和发布包的大小
细节:该面板在一系列选项卡中显示有关所选发布包版本的详细信息:内容,发布说明,分布跟踪,规范.
它们描述如下:
内容选项卡
Content选项卡显示了组成发布包的构件、构建和元数据。
单击任何工件或构建,以在选项卡的右侧面板中查看有关它的详细信息。
按此直接进入
单击工件的源路径,将被重定向到相应Artifactory服务的树状浏览器中的正确位置。
如果工件已经被JFrog Xray阻止下载(在这种情况下,您将无法签署和分发发布包),这将在x光状态属性中所选工件的字段内容选项卡。
发行说明页签
Release Notes选项卡显示包的发布说明。这些可以写成标记、ascii或纯文本。
配送跟踪选项卡
Distribution Tracking选项卡提供了这个发布包版本的历史记录。
ID |
分发动作的ID。 具有相同ID的多行 您可能会在这个表中看到具有相同ID的多行,因为单个发布操作可能会将一个发布包分发到多个目标节点 |
行动 |
执行的操作 |
开始 |
动作开始的日期和时间 |
目的地 |
分销目标 按此直接进入 单击要直接重定向到其UI的分发目标名称 |
状态 |
动作的状态 |
进步 |
动作完成的百分比和完成时的尝试次数 |
细节 |
对行动的一些细节进行总结。 按此浏览详情 单击此字段以获取该操作的完整详细信息。在这里,您可以在发生错误时获得更多详细信息。 |
重新发布一个发布包
发布一个发布包可能会因为不同的原因而失败,比如网络问题或目标Artifactory服务的中断。一旦修复了阻止发布的问题,就可以将发布包重新发布到发布失败的服务。要重新发布发布包,首先选择它们。分布表示重新分配选定的每个发行版的图标。您现在可以单击该图标,将每个发布包单独重新分发到指定的目标服务,或者选择重新分配按钮,以将发布包重新分发到批处理过程中选择的所有目标服务。
过滤器
使用筛选器仅显示那些失败的发行版。
规范标签
Spec选项卡显示源Artifactory服务,该发布包的构件就是从这个源Artifactory服务中组装起来的,同时还显示了组装构件的查询列表。
单击Artifactory服务
单击Artifactory服务将在该服务的主屏幕上打开一个新选项卡
单击任何查询展开它,显示控制发布包构件组装的查询的详细信息。
你甚至可以检查AQL复选框,以查看用于组装构件的最终AQL查询。
编辑发布包
- 要编辑一个发布包,请选择编辑的版本从行动列表。状态设置为开放.
- 点击保存保存发布包的“草案”版本。继续保存每次在编辑模式下进行更改时。
点击保存并签名签字,定稿:签字并定稿
请注意:签名的发布包不能编辑。
签署发布包
签署一个发布包完成了创建一个发布包的过程。这将发布包的状态设置为签署并且发布包不能再被编辑。
此外,Distribution将触发源Artifactory将已签名的发布包的内容克隆到一个孤立的release-bundles存储库.
- 您可以从“编辑发布包”页面或“新发布包”页面对发布包进行签名。
点击标志.
屏蔽构件
如果发布包包含任何被JFrog Xray阻止下载的构件,那么您对发布包签名的尝试将失败,并且Distribution将显示一条错误消息。因此,您将无法发布此发布包。
- 继续分发您的发布包当准备好了。
克隆一个发布包
要克隆现有的发布包版本,请选择克隆版本从行动下拉菜单。
这将复制发布包规范,包括它的名称和查询,到一个新的发布包页面。然后可以相应地调整和保存页面上的详细信息。
属性
当创建一个发布包时,从Artifactory放到发布包中。在初始发布包版本创建期间,可以使用创建发布包REST API。这些属性作为分发过程的一部分被转移到边缘节点。
发布发布包
一旦您创建了您的发布包,您就可以将它分发到您所在的Artifactory Edge节点有权分发给.
信任圈
分发只能将发布包从Artifactory服务分发到Artifactory边缘节点,如果它们都在同一信任圈内。要了解如何建立信任圈,请参考Cross-Instance身份验证请参见JFrog接入用户指南。
分发负责触发从源工件到边缘节点的复制过程。首先,它将发布包信息复制到每个边缘节点,然后在源Artifactory中启动复制过程。
要分发您的发布包,请单击发布包模块,或使用发布发布包REST API。
分发从任务控制中获取可用的边缘节点,并根据特定的用户权限显示可用边缘节点的列表。
要分发旧版本的发布包,请在发布包模块中单击它,选择要分发的版本,然后单击“分发”。
删除发布包
您可以使用Distribution UI或删除发布包REST API调用。适用于发布包删除权限.
要删除现有的发布包版本,请选择删除从行动下拉菜单。
有两种类型的删除选项:
AQL搜索发布包
要在Artifactory Edge节点中搜索发布包,可以使用释放和release_artifact在Artifactory 6.0中引入AQL的领域。详情请参阅实体和字段.