管理管道来源
只有用户管理员特权可以管理管道源.
需求
要成功添加管道源,需要确保以下几点:
- 在源代码控制集成中使用的凭据应该具有对指定的源代码控制存储库的管理访问权。管理员权限用于添加一个webhook,该webhook允许将存储库中的更改通知给pipeline。
- 存储库路径有效。要知道要指定的确切路径,请在源代码控制系统中检查该存储库的git克隆URL并复制该值。
下面是一些例子:- GitHub / GitHub Enterprise:https://github.com/myuser/basic-pipeline.git——使用myuser / basic-pipeline
- 比特桶服务器(私有存储库):https://git.mycompany.com/scm/project-id/repo-name.git——使用项目号/ repo-name
- 比特桶服务器(单个存储库):https://git.mycompany.com/scm/~myuser/myfirstrepo.git——使用~ myuser / myfirstrepo
- Bitbucket都:https://username@bitbucket.org/teamspace/test-repo.git——使用) / test-repo
- GitLab:https://gitlab.com/user1/repo1.git——使用user1 / repo1
- 分支名称是有效的,在Git集成中用于管道源的凭据可以访问分支。
添加一个集成对于您的管道文件存储库所在(或将所在)的源代码控制系统。集成可以是以下版本控制系统提供程序之一:
添加管道源
要添加一个源代码控制库作为管道源:
- 去管理|管道|管道源.
- 在生成的管道来源显示,点击添加管道来源.
- 请按下列任何一个:
- 从YAML
- 在生成的添加YAML管道源页,单击下列之一:
- 单分支
- 多分支
- 单击以选择同步管道源时用于克隆存储库的协议类型:
- SSH
- HTTPS
- 完成单/多分支形式:
- 的名字:输入唯一的管道源名称。
- SCM供应商整合:单击SCM供应商整合字段并选择您的源代码控制集成从下拉列表中。下拉列表中只包括与用作Pipeline Source兼容的集成。
- 库的全名:根据您为所选集成提供的信息,例如API令牌,所有相关的存储库都列在库的全名字段。选择存储管道文件的存储库的路径。如果没有自动获取存储库的名称,请输入存储管道文件的存储库的全名。
- 分行(只适用于单一分行)B:根据您提供的SCM提供者和存储库全名,a所有可用的分支将自动获取(例如,
主要
).选择所需的分支。如果不自动获取分支的名称,则输入分支的名称。 - 排除分支机构(仅限多分支机构):指定排除分支模式作为要排除的匹配分支名称的正则表达式。
- 包含(仅适用于多分支):指定包括分支模式作为要包含的匹配分支名称的正则表达式。
- 管道配置文件过滤器:输入正则表达式管道配置文件过滤器.任何与该表达式匹配的文件名都将被加载。
例子:- 如果您计划在一个名为2022世界杯阿根廷预选赛赛程
pipelines.2022世界杯阿根廷预选赛赛程resources.yml
你的管道pipelines.workflows.yml
,那么你就可以进去了管道。* .yml
. 如果您有多个yaml配置文件,那么输入
. * yml
.- 除了
pipelines.yml
,如果您正在使用values.yml
,确保两个文件都添加到筛选器,使用(管道|值).yml
.
- 如果您计划在一个名为2022世界杯阿根廷预选赛赛程
- 在生成的添加YAML管道源页,单击下列之一:
- 从模板
- 完整的结果模板属性形式:
- 单击选择模板名称空间字段并选择名称空间。
- 单击选择模板名称字段并选择模板。
单击选择模板版本字段并选择模板的版本。
- 点击下一个.
在生成的指定值文件页中,单击以下之一读取YAML值下拉:
- 源代码控制存储库:当你想获取值时使用它。来自SCM提供程序的yml文件。
- 手动输入:当您想手动定义管道源的值时,使用此选项。
- 源代码控制存储库
请按下列任何一个:
- 单分支
- 多分支
- 单击以选择同步管道源时用于克隆存储库的协议类型:
- SSH
- HTTPS
- 完成单/多分支形式:
- 的名字:输入唯一的管道源名称。
- SCM供应商整合:单击SCM供应商整合字段并选择您的源代码控制集成从下拉列表中。下拉列表中只包括与用作Pipeline Source兼容的集成。
- 库的全名:根据您为所选集成提供的信息,例如API令牌,所有相关的存储库都列在库的全名字段。选择存储管道文件的存储库的路径。如果没有自动获取存储库的名称,请输入存储管道文件的存储库的全名。
- 分行(只适用于单一分行)B:根据您提供的SCM提供者和存储库全名,a所有可用的分支将自动获取(例如,
主要
).选择所需的分支。如果不自动获取分支的名称,则输入分支的名称。 - 排除分支机构(仅限多分支机构):指定排除分支模式作为要排除的匹配分支名称的正则表达式。
- 包含(仅适用于多分支):指定包括分支模式作为要包含的匹配分支名称的正则表达式。
- 值文件路径:输入目录的路径
.values.yml
文件,其中包含模板的值。
- 手动输入
- 的名字:输入唯一的名称以标识从模板创建的管道源定义。
- Values.yml:手动输入或粘贴“值”定义。
- 完整的结果模板属性形式:
- 点击创建源以完成管道源的添加。
如果JFrog pipes成功地与存储库同步,则状态字段显示“成功”。否则,显示“Failed”。
提交到存储库的所有管道配置文件将自动加载到JFrog pipeline中,来自该源的所有已定义的管道都列在管道列表中。
验证YAML
在添加管道源之前,您可以选择验证YAML,然后将其提交给SCM。这使您能够获得关于管道同步错误的即时反馈。YAML验证器将对您的YAML进行语义和语法错误验证。
要验证你的YAML:
- 点击验证YAML.
- 输入YAML并将YAML内容粘贴到pipeline和Resources字段中。2022世界杯阿根廷预选赛赛程有关pipeline DSL的更多信息,请参见定义一个管道.
在输入YAML内容时,将对其进行验证,如果有语法错误,则显示语法错误。 - 修复所有语法错误后,单击验证验证YAML的语义错误。
查看管道来源
要查看已添加到“管道”中的管道源列表,请转到管理|管道|管道源或应用|管道|管道源.
该页显示管道源的列表可根据JFrog平台中定义的权限目标使用。您的用户帐户必须是授予权限的管道源,以便显示它。
管道源列表的每一行都包含以下内容:
的名字 |
|
Git存储库 |
管道源的源存储库路径 |
项目 |
管道源所属的项目 |
最新状态 |
上一次同步的成功/失败状态 |
配置文件过滤器 |
管道配置文件的过滤器字符串 |
最后一次同步 |
最后一次同步的时间和日期 |
改变了 |
最后一次更新管道源的用户的名称 |
上下文 |
触发最后一次同步的提交SHA |
日志 |
单击日志链接以查看上一次同步的日志。使用它来诊断同步管道源的失败。 |
如果管道源是一个多分支源,该行将显示所有分支的聚合信息,并且可以展开/折叠以显示每个分支的同步状态。
同步管道源
当任何管道配置文件发生更改时,您将需要同步管道源来重新加载:
- 去管理|管道|管道源和c舔的行动位于最右边的按钮。
- 点击同步.
查看同步日志
查询所有同步配置文件的日志。
- 去管理|管道|管道源和c舔的行动位于最右边的按钮。
- 点击日志.
管道源同步恢复
pipes提供了一个选项,用于为不同步的管道源启用自动同步。有关更多信息,请参见管道源同步恢复.
删除管道源
当删除一个管道源时,它将删除与该源关联的所有管道。
删除一个管道源。
- 去管理|管道|管道源和c舔的行动位于最右边的按钮。
- 点击删除.
- 点击确认在出现的确认窗口上。
如果管道源的任何关联管道仍在运行,则不能删除管道源。您可以取消运行,也可以等待运行完成,然后删除管道源。
获取分支
当为一个多分支管道源创建一个或多个分支时,webhook可能不会被正确处理,导致那些分支没有被添加到管道源中。
管道可以基于所选的SCM集成和存储库的全名,自动获取和同步多分支管道源中缺失的分支。
要做到这一点:
- 单击行动按钮为多分支管道,然后单击获取分支.
的获取分支窗口出现。 - 在分支字段,您可以:
- 输入要获取和同步的分支的名称。
或 - 单击获取分支按钮,尝试基于配置的SCM集成和存储库自动获取所有分支。
如果找到一个或多个分支,它们将在下拉菜单中列出。
- 输入要获取和同步的分支的名称。
- 单击,选择相应的分支。
- 点击确认同步管道源。
新发现的分支现在列在Pipeline Sources页面上。