Azure DevOps Services
本文介绍如何使用命令行界面从 Azure Artifacts 源下载通用包。
先决条件
| 产品 | 要求 |
|---|---|
| Azure DevOps | - An Azure DevOps 组织。 - Azure DevOps 项目。 - 安装 Azure CLI。 - 安装 Azure DevOps 扩展 版本 0.14.0 或更高版本。 |
安装 Azure DevOps 扩展
确保已安装 Azure CLI（版本 2.10.1 或更高版本）。 然后，按照以下步骤安装或更新 Azure DevOps 扩展，以便从命令行管理 Azure DevOps 资源。
运行以下命令以安装 Azure DevOps 扩展：
az extension add --name azure-devops如果已安装 Azure DevOps 扩展，并且想要将其更新到最新版本，请运行：
az extension update --name azure-devops
创建源
登录到 Azure DevOps 组织并导航到项目。
选择“项目”，然后选择“创建源”。
为您的源提供 名称，选择 可见性 选项来确定谁可以查看您的包。若要包括来自常见公共源（如 nuget.org 或 npmjs.com）的包，请勾选“包括公共源中的包”。关于 范围，请决定该源是否仅限于您的项目或整个组织。
完成后，选择 创建。
下载通用包
确保已设置身份验证，然后运行以下命令，使用 Azure CLI 从你的源下载特定的通用包：
项目作用域的源：
az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION_NAME> --project <PROJECT_NAME> --scope project --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <DOWNLOAD_PATH>组织作用域的源：
az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION_NAME> --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <DOWNLOAD_PATH>
注意
Azure Artifacts 不支持通过直接 API 接口下载通用包。 必须使用 Azure CLI 下载包。
下载特定文件
若要仅下载特定文件，请使用 --file-filter 参数仅提取指定的文件子集。 有关详细信息，请参阅 文件匹配模式参考。
项目作用域的源：
az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION_NAME> --project <PROJECT_NAME> --scope project --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <DOWNLOAD_PATH> --file-filter <MATCH_PATTERN>组织作用域的源：
az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION_NAME> --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <DOWNLOAD_PATH> --file-filter <MATCH_PATTERN>
会将 --file-filter logs/.log 目录中的所有文件与 logs 扩展名匹配。
下载最新版本
使用通配符 * 下载最新版本的通用包。
示例：
--version '*'：下载最新版本。--version '1.*': 下载最新版本，主版本号为1。--version '1.2.*': 下载最新发布的补丁，包括主要版本 1 和次要版本 2。
注意
预发布版本（版本号中带有破折号的软件包）不支持通配符模式。