发布 Python 包 (CLI)

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

本文介绍如何使用 NuGet 命令行接口将 Python 包发布到 Azure Artifacts 源。

先决条件

产品 要求
Azure DevOps - An Azure DevOps 组织
- Azure DevOps 项目
- 下载并安装 Python

创建源

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

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

  3. 为源提供名称,选择定义谁可以查看包的可见性选项,如果想要包括来自源(如 nuget.orgnpmjs.com)的包,以及范围,请确定源是否应限定为项目或整个组织。

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

    显示用于在 Azure DevOps Services 中创建新源的选择的屏幕截图。

  1. 登录到 Azure DevOps 服务器,然后转到项目。

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

  3. 为源提供名称,选择定义谁可以查看包的可见性选项,如果想要包括来自源(如 nuget.orgnpmjs.com)的包,以及范围,请确定源是否应限定为项目或整个组织。

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

    显示用于在 Azure DevOps 2022 中创建新源的选择的屏幕截图。

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

    显示用于在 Azure DevOps 2020 中创建新源的选择的屏幕截图。

  1. 登录到 Azure DevOps 服务器,然后转到项目。

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

  3. 对于 “名称”,请输入源的描述性名称。

    对于 可见性,请选择一个选项来指示谁可以查看源中的包。

    如果要包含来自公共源的包,请通过此源选项从公共源中选择“使用包”。

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

    显示用于在 Azure DevOps 2019 中创建新源的选择的屏幕截图。

注意

默认情况下,新建的源的“生成服务”值设置为“源”和“上游读取者”(协作者)。

发布包

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

  2. 选择 “项目”,然后选择“ 连接到源”。

  3. 从左侧导航区域选择 孪生体 。 如果这是你第一次将 Azure Artifacts 与孪生配合使用,请确保通过选择“ 获取工具 ”并按照提供的步骤安装必备组件。

  4. pypirc 文件添加到主目录,并将提供的代码片段粘贴到其中。 文件应类似于以下代码片段。 如果您已经有一个包含公共 PyPI 索引凭据的 pypirc,建议您删除其中的 [pypi] 部分,以防止误将私有包发布到 PyPI。

    [distutils]
    Index-servers =
    FEED_NAME
    
    [FEED_NAME]
    Repository = https://pkgs.dev.azure.com/ORGANIZATION_NAME/PROJECT_NAME/_packaging/FEED_NAME/pypi/upload/
    
  5. 在项目目录中运行以下命令,创建源分发和滚轮分发版。

    python setup.py sdist bdist_wheel
    
  6. 运行以下命令以发布包。 使用 -r REPOSITORY_NAME 标志来确保不会意外将专用包发布到 PyPI。

    twine upload -r REPOSITORY_NAME dist/*
    

重要

必须具有孪生 1.13.0 或更高版本才能使用 artifacts-keyring。 有关更多详细信息,请参阅 使用情况要求