新建私有依赖库2.0
首次使用私有依赖库时,需要新建仓库。私有依赖库分为“本地仓”、“聚合仓”。
本地仓:托管在服务端的制品仓库,是实际物理仓库,用户可以在本地仓上传不同类型制品。
聚合仓:用户在聚合仓中可以设置代理源与本地三方依赖仓库对接,也具备本地仓的功能,提供统一制品仓库入口,简化客户配置。
- 单击项目卡片进入项目(若没有项目,请新建项目)。
- 单击菜单栏 ,进入私有依赖库,用户可以单击页面左上方进行创建。
- 进入“新建制品仓库”页面。
- 参照表1配置仓库基本信息,单击“确定”。
表1 配置仓库基本信息参数说明 配置项
是否必填项
说明
仓库类型
是
用户可以选择“本地仓库”或“聚合仓库”。
- 本地仓库:托管在服务端的制品仓库,是实际物理仓库,保存制品数据实体。
- 聚合仓库:聚合本地仓库、代理仓库,提供统一制品仓库入口,简化客户配置。
仓库名称
是
仅支持中文,英文,数字,下划线(_),连字符(-)和点(.),长度20字符以内。
说明:私有依赖库创建完成后,仓库名称不支持修改。
制品类型
是
本地仓库支持Maven、npm、Go、PyPI、RPM、debian、Conan、NuGet、原生-Docker、CocoaPods制品仓库。
聚合仓库支持Maven、npm、PyPI、原生-Docker制品仓库。
选择不同格式的仓库,页面会展示对应的配置,请参照仓库配置说明完成进一步配置。
归属项目
是
为当前创建的仓库选择归属项目。设置完成后,所属项目无法更改。
描述
否
长度200字符以内。
- 页面左侧列表展示已创建的私有依赖库名称,单击仓库名称显示仓库详情,分为“概览”、“资源统计”、“操作日志”三个页签。
仓库配置说明
除了公共配置信息外,每种格式仓库对应了不同的配置项,详情如表2所示。
仓库格式 |
配置项 |
是否必填项 |
说明 |
---|---|---|---|
Maven |
版本策略 |
是 |
包括“Release”与“Snapshot”两个选项。 推荐全部选择,这样系统将生成“Release”和“Snapshot”两个仓库;也可以根据自己团队的需求至少选择一个,这样系统将生成一个“Release”或者是“Snapshot”仓库。 |
添加路径 |
否 |
输入需要添加的路径,单击“+”。 构建时,只允许以该路径开头的Maven文件上传到私有库。 |
|
npm |
添加路径 |
否 |
输入需要添加的路径,单击“+”。 构建时,只允许以该路径开头的npm文件上传到私有库。 |
Go |
添加路径 |
否 |
输入需要添加的路径,单击“+”。 构建时,只允许以该路径开头的go文件上传到私有库。 |
PyPI |
添加路径 |
否 |
输入需要添加的路径,单击“+”。 构建上传的PyPI依赖包时,确保其配置文件“setup.py”中的“name”值与添加的路径匹配。 |
RPM |
添加路径 |
否 |
输入需要添加的路径,单击“+”。 构建时,只允许以该路径开头的RPM二进制文件上传到私有库。 |
Conan |
添加路径 |
否 |
输入需要添加的路径,单击“+”。 只允许在本地客户端上传以该路径开头的Conan文件到私有库。 |
原生-Docker |
添加路径 |
否 |
输入需要添加的路径,单击“+”。 镜像推送时,只允许以该路径开头的镜像文件推送到私有库。 |
CocoaPods |
添加路径 |
否 |
输入需要添加的路径,单击“+”。 构建时,只允许以该路径开头的CocoaPods类型文件上传到私有库。 |
为私有依赖库聚合仓设置代理
CodeArts Artifact新增自定义代理仓功能,允许用户创建自定义代理仓库来代理开源社区仓库和三方依赖仓库。通过代理仓下载文件后,支持将对应文件缓存到制品仓库,解决三方依赖下载慢的用户痛点,下载三方依赖达到和本地仓库一样的极致下载体验。
私有依赖库支持Maven、npm、PyPI三种类型仓库进行代理设置。
在私有依赖库中,用户可以向Maven、npm、PyPI、原生-Docker虚仓中添加自定义镜像源。自定义镜像源配置方式如下:
- 登录软件开发生产线首页,单击页面右上角用户名,在下拉菜单中选择 。
- 在页面左侧导航栏选择 。
- 选择“自定义代理源”页签,单击页面右上方“新增代理”。
- 在弹框中,选择制品类型,输入镜像仓名称(必填)、镜像仓代理地址(必填)、PyPI索引代理地址(制品类型为PyPI时必填)、代理账号、代理密码。
- 镜像仓代理地址请填写以“https://”、“http://”为开头的地址,否则会报“URL不合法”。
- 不填写代理密码,默认使用上次设置的密码。
- 单击“确定”,完成自定义代理源添加。
- 对于已添加的自定义代理源,可以进行以下操作。
操作
说明
编辑
操作列中的,可以修改镜像仓名称、代理账号、代理密码。
删除
操作列中的,可以删除该自定义代理源。
若待删除的自定义代理源已关联了私有依赖库,需要在对应仓库的“代理设置”页面中移除该代理源后,返回本页面完成删除操作。
为私有依赖库聚合仓添加代理
- 已创建聚合仓,可参考新建私有依赖库。
- 进入私有依赖库,在左侧边栏中选择对应聚合仓的仓库名称。
- 单击页面右侧“代理设置”。
- 单击“添加代理”,选择“公开源”或“自定义源”。
用户可以在“自定义源”中选择“第三方仓库”或“华为本地仓库”两种代理类型。
- 第三方仓库(设置第三方仓库或者由用户自行创建的仓库为代理源):
用户选择第三方仓库后,单击“代理名称”的下拉列表,在下拉列表中选择自定义代理源。新建自定义代理源请参考自定义代理源。
- 华为本地仓库(设置华为本地仓库为代理源,用户只能选择自己作为仓库管理员的本地仓库)
- 第三方仓库(设置第三方仓库或者由用户自行创建的仓库为代理源):
- 单击“确定”,完成添加代理。
- 单击操作列中的,可以修改镜像仓名称、代理账号、代理密码。
用户无法编辑华为本地仓库的代理源。
单击操作列中的,可以删除对应的代理。
- 单击操作列中的,可以修改镜像仓名称、代理账号、代理密码。
获取私有依赖库地址
用户新建成功的私有依赖库都会生成一个对应的私有依赖库地址,配置本地开发环境对接私有依赖库时,会用到私有依赖库地址,通过以下操作可获取该地址。
- 进入私有依赖库,在左侧边栏中单击待获取地址的仓库名称。
- 页面中仓库的详细信息显示私有依赖库地址,单击,可以获取对应地址。
删除仓库
私有依赖库支持删除仓库,被删除的仓库将转移至回收站。
- 进入私有依赖库,在左侧边栏中单击要删除的仓库名称。
- 单击页面右侧“设置仓库”,显示仓库的基本信息。
- 单击页面右侧“删除仓库”。页面左侧仓库列表中将看不到已删除的仓库。