更新时间:2024-10-16 GMT+08:00

新建私有依赖库

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

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

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

  1. 单击项目卡片进入项目(若没有项目,请新建项目)。
  2. 单击菜单栏制品仓库 > 私有依赖库,进入私有依赖库,用户可以单击页面左上方进行创建。
  3. 进入“新建制品仓库”页面。
  4. 参照表1配置仓库基本信息,单击“确定”

    表1 配置仓库基本信息参数说明

    配置项

    是否必填项

    说明

    仓库类型

    用户可以选择“本地仓库”“聚合仓库”

    • 本地仓库:托管在服务端的制品仓库,是实际物理仓库,保存制品数据实体。
    • 聚合仓库:聚合本地仓库、代理仓库,提供统一制品仓库入口,简化客户配置。

    仓库名称

    仅支持中文,英文,数字,下划线(_),连字符(-)和点(.),长度20字符以内。

    说明:

    私有依赖库创建完成后,仓库名称不支持修改。

    制品类型

    本地仓库支持Maven、npm、Go、PyPI、RPM、debian、Conan、NuGet、原生-Docker、CocoaPods制品仓库。

    聚合仓库支持Maven、npm、PyPI、原生-Docker制品仓库。

    选择不同格式的仓库,页面会展示对应的配置,请参照仓库配置说明完成进一步配置。

    说明:

    原生-Docker、CocoaPods类型仓库目前仅支持“亚太-新加坡”局点。

    归属项目

    为当前创建的仓库选择归属项目。设置完成后,所属项目无法更改。

    描述

    长度200字符以内。

  5. 页面左侧列表展示已创建的私有依赖库名称,单击仓库名称显示仓库详情,分为“概览”“资源统计”“操作日志”三个页签。

    • 概览:显示仓库的名称、仓库类型、仓库地址、相对路径、创建人、创建时间、修改人、修改时间、制品个数、制品总大小信息。
    • 资源统计:按照“文件数量趋势”和“存储容量趋势”,对仓库上传制品动态进行统计。

    • 操作日志:展示了在仓库中上传、删除、从回收站还原的操作历史。

仓库配置说明

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

表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、原生-Docker四种类型仓库进行代理设置。

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

  1. 登录软件开发生产线首页,单击页面右上角用户名,在下拉菜单中选择租户设置
  2. 在页面左侧导航栏选择镜像仓管理 > 镜像仓
  3. 选择“自定义代理源”页签,单击页面右上方“新增代理”
  4. 在弹框中,选择制品类型,输入镜像仓名称(必填)、镜像仓代理地址(必填)、PyPI索引代理地址(制品类型为PyPI时必填)、代理账号、代理密码。

    • 镜像仓代理地址请填写以“https://”、“http://”为开头的地址,否则会报“URL不合法”。
    • 不填写代理密码,默认使用上次设置的密码。

  5. 单击“确定”,完成自定义代理源添加。
  6. 对于已添加的自定义代理源,可以进行以下操作。

    操作

    说明

    编辑

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

    删除

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

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

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

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

    用户可以在“自定义源”中选择“第三方仓库”“华为本地仓库”两种代理类型。

    • 第三方仓库(设置第三方仓库或者由用户自行创建的仓库为代理源):

      用户选择第三方仓库后,单击“代理名称”的下拉列表,在下拉列表中选择自定义代理源。新建自定义代理源请参考自定义代理源

    • 华为本地仓库(设置华为本地仓库为代理源,用户只能选择自己作为仓库管理员的本地仓库)

      用户在镜像仓名称的下拉列表中,可以选择私有依赖库中的本地仓库。

  5. 单击“确定”,完成添加代理。

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

      用户无法编辑华为本地仓库的代理源。

      单击操作列中的,可以删除对应的代理。

获取私有依赖库地址

用户新建成功的私有依赖库都会生成一个对应的私有依赖库地址,配置本地开发环境对接私有依赖库时,会用到私有依赖库地址,通过以下操作可获取该地址。

  1. 进入私有依赖库,在左侧边栏中单击待获取地址的仓库名称。
  2. 页面中仓库的详细信息显示私有依赖库地址,单击,可以获取对应地址。

删除仓库

私有依赖库支持删除仓库,被删除的仓库将转移至回收站。

  1. 进入私有依赖库,在左侧边栏中单击要删除的仓库名称。
  2. 单击页面右侧“设置仓库”,显示仓库的基本信息。
  3. 单击页面右侧“删除仓库”。页面左侧仓库列表中将看不到已删除的仓库。