什么是 Azure Artifacts 源?

Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022

重要

Azure DevOps中的公共项目已停用。 从 2027 年开始,现有公共项目转换为专用项目。 有关详细信息,请参阅 公共项目退休 和 将公共项目迁移到 GitHub。

Azure Artifacts 源是组织构造,可用于在控制访问权限的同时存储、管理和共享包。 单个源可以托管多种包类型,包括 npm、NuGet、Maven、Python、Cargo 和 Universal Packages 包。 Azure Artifacts 源还支持通过上游源保存来自公共注册表(如 nuget.org)的包,即使公共源暂时不可用,也能确保你对包的持续访问。

源类型

可将 Azure Artifacts 源的作用域限定到组织或项目。 如果某个源的作用域限定到现有的公共项目,则该源也可以是公共的:

项目范围的源:范围限定到项目的源。 它们仅在所在项目中可见。 只有托管在现有公共项目中的项目范围内的源才能作为公共源。

组织范围的订阅源:范围限定到组织的源。 可以从组织内的任何项目查看它们。 组织范围的源不能转换为项目范围的源。

专用源:既可以是项目范围的(专用项目),也可以是组织范围的。 专用源中的包仅对通过身份验证且至少具有源读取者权限的用户可用。

公共源:限定在现有 公共 项目中的源。 已通过身份验证的用户和匿名用户都可以访问公共源中的包,只要托管项目保持公开状态。 从 2027 年开始,现有公共项目将自动转换为专用项目,公共源将不再可公开访问。

请参阅 订阅源范围,以了解项目范围的订阅源与组织范围的订阅源之间的差异。

创建新订阅源

按照以下步骤选择适当的范围,以创建项目范围或组织范围的源:

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

  2. 选择“工件”,然后选择“创建源”。

  3. 为源提供 名称 ,定义其 可见性 (谁可以查看源中的包),并指定源 的范围 (项目范围或组织范围)。 若要启用上游源并包括来自公共源的包,请选中 “上游源 ”复选框。

  4. 完成操作后,选择“创建”。

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

  1. 登录到 Azure DevOps 集合,然后导航到项目。

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

  3. 为源提供 名称 ,定义其 可见性 (谁可以查看源中的包),并指定源 的范围 (项目范围或组织范围)。 若要启用上游源并包括来自公共源的包,请选中 “上游源 ”复选框。

  4. 完成操作后,选择“创建”。

    展示了如何在 Azure DevOps Server 2022 和 Server 2020 中创建新源的屏幕截图。

公共信息流

公共源允许你与 Internet 上的任何人公开共享包。 用户不需要是组织的成员,也不需要登录到 Azure DevOps 门户即可访问公共源中的包。

公共源是项目范围的,继承托管项目的可见性设置。 下面是一些重要要点:

  • 你只能在现有的公共项目中创建公共源。

  • 从 2027 年开始,Azure DevOps将自动将现有公共项目转换为专用项目。 发生此更改时,关联的公共源将不再可公开访问。

  • 公共源不应取代现有的公共注册表,例如 NuGet.org、npmjs.com 等。

  • 公共用户无法下载通用包,但公共访问支持所有其他包类型。

注意

在托管项目保持公开状态时,Internet 上的每个人都可以访问公共源中的所有源视图。 从 2027 年开始,Azure DevOps将自动将现有公共项目转换为专用项目,公共源将不再可公开访问。

创建公共信息流

重要

只有已启用 “允许公共项目策略 ”的组织才能创建项目或更改项目的可见性。 策略不再可供尚未使用它的组织使用。 Microsoft建议为所有公共项目需求使用 GitHub 。

公共源是现有公共项目中项目范围内的源。 请按照以下步骤创建新的公共源:

  1. 登录到Azure DevOps组织并转到现有公共项目。

  2. 选择“项目>创建源”。

  3. 为源提供一个名称,然后选择项目作为源的范围。

  4. 完成操作后,选择“创建”。

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

删除源

注意

要删除源,你必须是源所有者。

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

  2. 选择项目,然后从下拉菜单中选择源。

  3. 选择齿轮图标 齿轮图标 以导航到“源设置”。

  4. 选择“删除源”,然后再次选择“删除”以确认。

    删除源之前出现的警告消息截图。

还原已删除的源

如果意外删除了源,Azure Artifacts 提供了 30 天的窗口将其恢复到原始状态。 在此期限之后,该源将被永久删除。 在恢复时段:

  • 该源名称将继续被保留。

  • 包无法下载。

  • 写入访问已暂停。

要还原待永久删除的源:

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

  2. 选择 “项目”,打开源选取器下拉菜单,然后选择“ 已删除的源” 选项卡。

    显示如何访问等待被永久删除的订阅源的屏幕截图。

  3. 选择要还原的源,然后选择 “源设置”,然后在准备好还原源时选择 “还原源 ”。

    显示等待永久删除的源的源设置按钮的屏幕截图。

永久删除源

正在等待删除的数据源将继续占用存储空间。 你必须是源所有者才能永久删除源。 若要在 30 天期限结束之前删除源,请执行以下步骤:

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

  2. 选择 “项目”,打开源选取器下拉菜单,然后选择“ 已删除的源” 选项卡。

  3. 选择要删除的源,然后选择“ 源设置”。

  4. 选择永久删除源,然后选择删除以确认。

注意

源一旦被永久删除,用户将无法再查看或恢复其包。 源名称将在删除后约 15 分钟可供重复使用。