Поделиться через


Публикация и установка пакетов Python (CLI)

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Артефакты Azure позволяют разработчикам управлять их зависимостями из одного веб-канала. Вы можете публиковать и устанавливать пакеты Python в веб-канал и из нее с помощью командной строки. Вы узнаете, как выполнять следующие задачи:

  • Создайте веб-канал.
  • Публикация пакетов Python в веб-канале.
  • Установите пакеты Python из веб-канала.

Необходимые компоненты

Создание веб-канала

  1. Войдите в свою организацию Azure DevOps и откройте нужный проект.

  2. Выберите артефакты и нажмите кнопку "Создать веб-канал".

  3. Укажите имя веб-канала, выберите параметр "Видимость", определяющий, кто может просматривать свои пакеты, проверять включение пакетов из общих источников, если вы хотите включить пакеты из источников, таких как nuget.org или npmjs.com, и для области, определите, должен ли веб-канал быть ограничен вашим проектом или всей организацией.

  4. После завершения работы выберите Создать.

    Снимок экрана: выбор для создания веб-канала в Azure DevOps Services.

  1. Войдите на сервер Azure DevOps и перейдите в проект.

  2. Выберите артефакты и нажмите кнопку "Создать веб-канал".

  3. Укажите имя веб-канала, выберите параметр "Видимость", определяющий, кто может просматривать свои пакеты, проверять включение пакетов из общих источников, если вы хотите включить пакеты из источников, таких как nuget.org или npmjs.com, и для области, определите, должен ли веб-канал быть ограничен вашим проектом или всей организацией.

  1. После завершения работы выберите Создать.

    Снимок экрана: выбор для создания веб-канала в Azure DevOps 2022.

  1. После завершения работы выберите Создать.

    Снимок экрана: выбор для создания веб-канала в Azure DevOps 2020.

  1. Войдите на сервер Azure DevOps и перейдите в проект.

  2. Выберите артефакты и выберите новый веб-канал.

  3. В поле "Имя" введите описательное имя веб-канала.

    Для видимости выберите параметр, чтобы указать, кто может просматривать пакеты в веб-канале.

    Если вы хотите включить пакеты из общедоступных источников, выберите "Использовать пакеты" из общедоступных источников с помощью этого канала .

  4. После завершения работы выберите Создать.

    Снимок экрана: выбор для создания веб-канала в Azure DevOps 2019.

Примечание.

По умолчанию только что созданные веб-каналы имеют значение службы сборки проекта в качестве канала и средства чтения upstream (Сотрудник).

Публикация пакетов

  1. Войдите в организацию Azure DevOps и перейдите к проекту.

  2. Выберите артефакты и нажмите кнопку "Подключиться к каналу".

  3. Выберите двойник из области навигации слева. Если вы впервые используете Azure Artifacts с двойником, установите необходимые компоненты, выбрав "Получить средства " и выполнив указанные действия.

  4. Добавьте pypirc-файл в свой домашний каталог и вставьте в него предоставленный фрагмент кода. Файл должен выглядеть примерно так, как показано в следующем фрагменте кода. Если у вас уже есть pypirc , содержащий учетные данные для общедоступного индекса PyPI, рекомендуется удалить раздел [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/*
    

Внимание

Для использования артефактов-ключей необходимо использовать twine 1.13.0 или более поздней версии. Дополнительные сведения см. в разделе "Требования к использованию".

Установка пакетов

  1. Войдите в организацию Azure DevOps и перейдите к проекту.

  2. Выберите артефакты и нажмите кнопку "Подключиться к каналу".

  3. Выберите pip из левой области навигации. Если вы впервые используете Azure Artifacts с pip, установите необходимые компоненты, выбрав "Получить средства " и выполнив указанные ниже действия.

  4. Создание виртуальной среды.

  5. Добавьте в virtualenv файл pip.ini (Windows) или pip.conf (Mac/Linux) и вставьте в него предоставленный фрагмент кода. Файл должен выглядеть следующим фрагментом кода:

    [global]
    index-url=https://pkgs.dev.azure.com/ORGANIZATION_NAME/PROJECT_NAME/_packaging/FEED_NAME/pypi/simple/
    
  6. Выполните следующую команду в каталоге проекта, чтобы установить пакеты:

    pip install
    

Внимание

Для использования артефактов-ключей необходимо использовать pip 19.2 или более поздней версии. Дополнительные сведения см. в разделе "Требования к использованию".