新建私有依赖库

更新时间：2024-12-26 GMT+08:00

查看PDF

首次使用私有依赖库时，需要新建仓库。私有依赖库分为“本地仓库”、“聚合仓库”。

本地仓库：托管在服务端的制品仓库，是实际物理仓库，用户可以在本地仓上传不同类型制品。

聚合仓库：用户在聚合仓中可以设置代理源与本地三方依赖仓库对接，也具备本地仓的功能，提供统一制品仓库入口，简化客户配置。

单击项目卡片进入项目（若没有项目，请新建项目）。
单击菜单栏“制品仓库 > 私有依赖库”，进入私有依赖库，用户可以单击页面左上方进行创建。
进入“新建制品仓库”页面。

参照表1配置仓库基本信息，单击“确定”。

表1 配置仓库基本信息参数说明
配置项	是否必填项	说明
仓库类型	是	用户可以选择“本地仓库”或“聚合仓库”。本地仓库：托管在服务端的制品仓库，是实际物理仓库，保存制品数据实体。聚合仓库：聚合本地仓库、代理仓库，提供统一制品仓库入口，简化客户配置。
仓库名称	是	仅支持中文，英文，数字，下划线(_)，连字符(-)和点(.)，长度20字符以内。说明：私有依赖库创建完成后，仓库名称不支持修改。
制品类型	是	本地仓库支持Maven、NPM、RPM、PyPI、Go、Debian、Conan、NuGet、CocoaPods、Generic、OHPM、原生-Docker制品仓库。聚合仓库支持Maven、NPM、PyPI、Conan、OHPM、原生-Docker制品仓库。选择不同格式的仓库，页面会展示对应的配置，请参照表2完成进一步配置。说明：原生-Docker、CocoaPods类型仓库目前仅支持“亚太-新加坡”局点。
归属项目	是	为当前创建的仓库选择归属项目。设置完成后，所属项目无法更改。
描述	否	长度200字符以内。

页面左侧列表展示已创建的私有依赖库名称，单击仓库名称显示仓库详情，分为“概览”、“资源统计”、“操作日志”三个页签。
- 概览：显示仓库的名称、仓库类型、仓库地址、相对路径、创建人、创建时间、修改人、修改时间、制品个数、制品总大小信息。
- 资源统计：按照“文件数量趋势”和“存储容量趋势”，对仓库上传制品动态进行统计。
- 操作日志：展示了在仓库中上传、删除、从回收站还原的操作历史。

不同格式的本地仓库其他参数说明

除了公共配置信息外，每种格式仓库对应了不同的配置项，详情如表2所示。

表2 不同格式仓库其他参数说明
仓库格式	参数名	是否必填项	说明
Maven	关联项目	是	在下拉列表选择需要关联的项目名称。
	路径包含规则	否	输入需要添加的路径，单击“+”可添加多条。例如添加demo，即demo/*/，从demo的二级目录开始算且不含demo。使用时，只有匹配了路径包含规则的制品允许上传。默认所有制品路径都被允许。构建时，只允许以该路径开头的Maven文件上传到私有库。
	路径排除规则	否	输入需要添加的路径，单击“+”可添加多条。例如添加demo，即demo/*/，从demo的二级目录开始算且不含demo。构建时，不允许以该路径开头的Maven文件上传到私有库。
	版本策略	是	包括“Release”与“Snapshot”两个选项。系统提供“Release”和“Snapshot”两个仓库，默认勾选“Release”仓库；也可以根据自己团队的需求，勾选生成一个“Snapshot”仓库。
NPM	路径包含规则	否	输入需要添加的路径，单击“+”可添加多条。例如添加demo，即demo/*/，从demo的二级目录开始算且不含demo。构建时，只允许以该路径开头的NPM文件上传到私有库。
NPM	路径排除规则	否	输入需要添加的路径，单击“+”可添加多条。构建时，不允许以该路径开头的npm文件上传到私有库。
RPM	路径包含规则	否	输入需要添加的路径，单击“+”可添加多条。例如添加demo，即demo/*/，从demo的二级目录开始算且不含demo。构建时，只允许以该路径开头的RPM二进制文件上传到私有库。
RPM	路径排除规则	否	输入需要添加的路径，单击“+”可添加多条。构建时，不允许以该路径开头的RPM二进制文件上传到私有库。
PyPI	路径包含规则	否	输入需要添加的路径，单击“+”可添加多条。例如添加demo，即demo/*/，从demo的二级目录开始算且不含demo。构建时，只允许在“setup.py”文件中的“name”值与添加的路径匹配的PyPI依赖包上传到私有库。
PyPI	路径排除规则	否	输入需要添加的路径，单击“+”可添加多条。构建时，不允许在“setup.py”文件中的“name”值与添加的路径匹配的PyPI依赖包上传到私有库。
Go	路径包含规则	否	输入需要添加的路径，单击“+”可添加多条。例如添加demo，即demo/*/，从demo的二级目录开始算且不含demo。构建时，只允许以该路径开头的go文件上传到私有库。
Go	路径排除规则	否	输入需要添加的路径，单击“+”可添加多条。构建时，不允许以该路径开头的go文件上传到私有库。
Conan	路径包含规则	否	输入需要添加的路径，单击“+”可添加多条。例如添加demo，即demo/*/，从demo的二级目录开始算且不含demo。构建时，只允许以该路径开头的Conan类型文件上传到私有库。
Conan	路径排除规则	否	输入需要添加的路径，单击“+”可添加多条。不允许在本地客户端上传以该路径开头的Conan文件到私有库。
NuGet	路径包含规则	否	输入需要添加的路径，单击“+”可添加多条。例如添加demo，即demo/*/，从demo的二级目录开始算且不含demo。构建时，只允许以该路径开头的NuGet类型文件上传到私有库。
NuGet	路径排除规则	否	输入需要添加的路径，单击“+”可添加多条。不允许在本地客户端上传以该路径开头的NuGet文件到私有库。
CocoaPods	路径包含规则	否	输入需要添加的路径，单击“+”可添加多条。例如添加demo，即demo/*/，从demo的二级目录开始算且不含demo。构建时，只允许以该路径开头的CocoaPods类型文件上传到私有库。
CocoaPods	路径排除规则	否	输入需要添加的路径，单击“+”可添加多条。构建时，不允许以该路径开头的cocoapods文件上传到私有库。
Generic	路径包含规则	否	输入需要添加的路径，单击“+”可添加多条。例如添加demo，即demo/*/，从demo的二级目录开始算且不含demo。构建时，只允许以该路径开头的Generic文件推送到私有库。
Generic	路径排除规则	否	输入需要添加的路径，单击“+”可添加多条。构建时，不允许以该Generic文件的文件推送到私有库。
OHPM	路径包含规则	否	输入需要添加的路径，单击“+”可添加多条。例如添加demo，即demo/*/，从demo的二级目录开始算且不含demo。构建时，只允许以该路径开头的OHPM文件推送到私有库。
OHPM	路径排除规则	否	输入需要添加的路径，单击“+”可添加多条。构建时，不允许以该OHPM文件的文件推送到私有库。
原生-Docker	路径包含规则	否	输入需要添加的路径，单击“+”可添加多条。例如添加demo，即demo/*/，从demo的二级目录开始算且不含demo。构建时，只允许以该路径开头的镜像文件推送到私有库。
原生-Docker	路径排除规则	否	输入需要添加的路径，单击“+”可添加多条。镜像推送时，不允许以该路径开头的镜像文件推送到私有库。

为私有依赖库聚合仓设置代理

CodeArts Artifact新增自定义代理仓功能，允许用户创建自定义代理仓库来代理开源社区仓库和三方依赖仓库。通过代理仓下载文件后，支持将对应文件缓存到制品仓库，解决三方依赖下载慢的用户痛点，下载三方依赖达到和本地仓库一样的极致下载体验。

说明：

私有依赖库支持Maven、npm、PyPI、原生-Docker四种类型仓库进行代理设置。

在私有依赖库中，用户可以向Maven、npm、PyPI、原生-Docker虚仓中添加自定义镜像源。自定义镜像源配置方式如下：

登录软件开发生产线首页，单击页面右上角用户名，在下拉菜单中选择“租户设置”。
在页面左侧导航栏选择“镜像仓管理 > 镜像仓”。
选择“自定义代理源”页签，单击页面右上方“新增代理”。
在弹框中，选择制品类型，输入镜像仓名称（必填）、镜像仓代理地址（必填）、PyPI索引代理地址（制品类型为PyPI时必填）、代理账号、代理密码。
说明：
- 镜像仓代理地址请填写以“https://”、“http://”为开头的地址，否则会报“URL不合法”。
- 不填写代理密码，默认使用上次设置的密码。
单击“确定”，完成自定义代理源添加。

对于已添加的自定义代理源，可以进行以下操作。

操作	说明
编辑	操作列中的，可以修改镜像仓名称、代理账号、代理密码。
删除	操作列中的，可以删除该自定义代理源。若待删除的自定义代理源已关联了私有依赖库，需要在对应仓库的“代理设置”页面中移除该代理源后，返回本页面完成删除操作。

操作

说明

编辑

操作列中的，可以修改镜像仓名称、代理账号、代理密码。

删除

操作列中的，可以删除该自定义代理源。

若待删除的自定义代理源已关联了私有依赖库，需要在对应仓库的“代理设置”页面中移除该代理源后，返回本页面完成删除操作。

为私有依赖库聚合仓添加代理

已创建聚合仓，可参考新建私有依赖库。
进入私有依赖库，在左侧边栏中选择对应聚合仓的仓库名称。
单击页面右侧“代理设置”。
单击“添加代理”，选择“公开源”或“自定义源”。

用户可以在“自定义源”中选择“第三方仓库”或“华为本地仓库”两种代理类型。
- 第三方仓库（设置第三方仓库或者由用户自行创建的仓库为代理源）：
  用户选择第三方仓库后，单击“代理名称”的下拉列表，在下拉列表中选择自定义代理源。新建自定义代理源请参考自定义代理源。
- 华为本地仓库（设置华为本地仓库为代理源，用户只能选择自己作为仓库管理员的本地仓库）
  用户在镜像仓名称的下拉列表中，可以选择私有依赖库中的本地仓库。
单击“确定”，完成添加代理。
- 单击操作列中的，可以修改镜像仓名称、代理账号、代理密码。
  说明：
  
  用户无法编辑华为本地仓库的代理源。
  
  单击操作列中的，可以删除对应的代理。