从 Azure Artifacts 源发布通用包

Azure DevOps Services

通用包使开发人员能够将各种包类型存储在传统格式(如 NuGet、npm、Python 包等)之外。使用 Azure CLI,可以直接从命令行发布通用包。 这些包的大小可以高达 4 TiB,但它们必须始终包含名称和版本号。 本文指导您如何将通用包发布到您的 Azure Artifacts 供稿。

先决条件

产品 要求
Azure DevOps - 一个 Azure DevOps 组织
- Azure DevOps 项目
- 安装 Azure CLI
- 安装 Azure DevOps 扩展 版本 0.14.0 或更高版本。

安装 Azure DevOps 扩展

确保已安装 Azure CLI(版本 2.10.1 或更高版本)。 然后,按照以下步骤安装或更新 Azure DevOps 扩展,以便从命令行管理 Azure DevOps 服务。

  1. 运行以下命令以安装 Azure DevOps 扩展:

    az extension add --name azure-devops
    
  2. 如果已安装 Azure DevOps 扩展,并且想要将其更新到最新版本,请运行:

    az extension update --name azure-devops
    

创建源

  1. 登录到 Azure DevOps 组织,并导航到你的项目。

  2. 选择“项目”,然后选择“创建源”

  3. 为您的源提供 名称,选择 可见性 选项来确定谁可以查看您的包。若要包括来自常见公共源(如 nuget.orgnpmjs.com)的包,请勾选“包括公共源中的包”。关于 范围,请决定该源是否仅限于您的项目或整个组织。

  4. 完成后,选择 创建

    显示如何在 Azure DevOps Services 中创建新源的屏幕截图。

发布通用包

若要将通用包发布到数据流,需要提供包名称和版本号。 包名称必须采用小写形式、以字母或数字开头和结尾,并且只能包含字母、数字和非连续短划线 -、下划线 _或句点 .。 同样,包版本也必须采用小写形式,并且不应包含生成元数据(由 + 后缀指示)。 有关详细信息,请参阅 语义版本控制

  1. 运行以下命令,将通用包发布到你的仓库:

    • 项目作用域的源

      az artifacts universal publish --organization https://dev.azure.com/<YOUR_ORGANIZATION> --project <PROJECT_NAME> --scope project --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <PACKAGE_DIRECTORY> --description <PACKAGE_DESCRIPTION>
      
    • 组织作用域的源

      az artifacts universal publish --organization https://dev.azure.com/<YOUR_ORGANIZATION> --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <PACKAGE_DIRECTORY> --description <PACKAGE_DESCRIPTION>
      

注意

包含大量文件(100K+)的通用包可能无法发布。 在这种情况下,我们建议将文件捆绑到 ZIPTAR 存档,以减少文件计数。

查看已发布的包

  1. 登录到 Azure DevOps 组织,然后导航到项目。

  2. 选择“ 项目”,然后从下拉菜单中选择源。 成功完成发布过程后,你的包应该在信息流中可用。

    显示新发布的通用包的屏幕截图。