Краткое руководство. Публикация и использование пакетов Python с помощью артефактов Azure с помощью командной строки (CLI)

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

Из этого краткого руководства вы узнаете, как создать веб-канал Azure Artifacts и использовать веб-канал для публикации и использования пакетов Python из командной строки в локальной среде разработки. По завершении у вас будет пакет Python, опубликованный в веб-канале и установленный из веб-канала в локальную среду разработки.

Сведения о публикации и использовании пакетов в Azure Pipelines см. в статье "Публикация пакетов Python с помощью Azure Pipelines".

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

Чтобы выполнить следующие действия, необходимо выполнить следующие действия:

• Организация Azure DevOps. Создайте ее бесплатно.
• Личный маркер доступа (PAT) с область чтения упаковки>. Сведения о создании см. в разделе "Создание PAT".
• Проект Azure DevOps. Если у вас его нет, создайте проект.
• Python 3.8 или более поздней версии, установленный на локальном компьютере. Скачайте Python здесь.
• pip 19.2 и twine 1.13.0 или более поздней версии.
• Пакет Python для публикации с локального компьютера на веб-канале.
• При использовании примера пакета Python:
  • Учетная запись GitHub. Создайте бесплатную учетную запись GitHub, если еще не сделали этого.
  • git, установленный на локальном компьютере.

Создание локального пакета Python

Вам нужен пакет Python для публикации в веб-канале. Если у вас нет пакета для публикации, можно клонировать пример пакета Python из GitHub.

Клонирование примера пакета Python

Выполните следующие действия, чтобы использовать пример пакета Python из GitHub.

1. Перейдите к следующему репозиторию GitHub:

   https://github.com/microsoft/python-package-template
   

2. Репозиторий, скопированный в учетную запись GitHub.

3. Перейдите в вилку репозитория и выберите "Код".

4. Скопируйте URL-адрес вилированного репозитория.

5. На локальном компьютере клонируйте репозиторий с помощью следующей команды с помощью URL-адреса, скопированного из вилированного репозитория:

   git clone <REPOSITORY_URL>
   

6. Измените каталог на клонированного репозитория.

   cd python-package-template
   

Создание пакета

Чтобы создать колесо и исходное распределение, выполните следующие команды в каталоге проекта:

pip install --upgrade build
python -m build

Если в проекте Python есть setup.py файл, можно использовать следующую команду для сборки пакета:

python setup.py sdist bdist_wheel

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

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

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

   

3. Введите следующие сведения для веб-канала:

   1. Введите описательное имя веб-канала.
   2. Определите ее видимость (показывающий, кто может просматривать пакеты в веб-канале).
   3. Выберите, следует ли использовать пакеты из общедоступных источников, таких как pypi.org.
   4. Укажите область веб-канала.

4. Нажмите кнопку создания.

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

Используйте twine для отправки пакета в веб-канал Артефактов Azure.

1. Перейдите в проект Azure DevOps и выберите артефакты.

2. Выберите веб-канал и выберите Подключение для веб-канала.

   

3. Выберите twine в разделе Python .

   

4. На компьютере разработки убедитесь, что двойник установлен.

   pip install --upgrade twine
   

5. Следуйте инструкциям в разделе "Настройка проекта", чтобы настроить .pypirc файл.

   

6. Чтобы избежать необходимости вводить личный маркер доступа при каждом публикации пакета, вы можете добавить учетные данные в .pypirc файл. Убедитесь, что вы не проверка личный маркер доступа в общедоступный репозиторий.

   .pypirc Пример файла с учетными данными:

   [distutils]
   Index-servers =
       <FEED_NAME>
   
   [<FEED_NAME>]
   Repository = <FEED_URL>
   username = <FEED_NAME>
   password = <YOUR_PERSONAL_ACCESS_TOKEN>
   

7. Чтобы отправить пакет, выполните следующую команду в каталоге проекта, заменив <FEED_NAME> именем веб-канала. В Windows может потребоваться указать .pypirc расположение файла с аргументом --config-file .

   twine upload --repository <FEED_NAME> dist/*
   

Установка пакета из веб-канала

1. Перейдите в проект Azure DevOps и выберите артефакты.

2. Выберите веб-канал и выберите Подключение для веб-канала.

   

3. Выберите pip в разделе Python .

   

4. Подготовьте локальную среду Python.

   Windows

   1. Убедитесь, что pip установлен и обновлен:

      python -m pip install --upgrade pip
      

   2. Создайте и активируйте виртуальную среду Python:

      python -m venv myenv
      myenv/Scripts/activate
      

   Linux и macOS

   1. Убедитесь, что pip установлен и обновлен:

      python3 -m pip install --upgrade pip
      

   2. Чтобы создать и активировать виртуальную среду Python, выполните следующие действия.

      python3 -m venv myenv
      source myenv/bin/activate
      

5. Добавьте файл pip.ini (Windows) или pip.conf (Mac/Linux) в корневой каталог виртуальной среды. Скопируйте содержимое из раздела установки проекта Подключение в диалоговое окно канала и добавьте его в файл pip.ini или pip.conf.

   

6. Чтобы избежать необходимости вводить личный маркер доступа при каждом установке пакета из веб-канала, вы можете добавить свои учетные данные в файл pip.ini или pip.conf . Убедитесь, что вы не проверка личный маркер доступа в общедоступный репозиторий.

   Пример файла pip.ini или pip.conf с учетными данными:

   [global]
   extra-index-url=https://<FEED_NAME>:<YOUR_PERSONAL_ACCESS_TOKEN>@<FEED_URL>
   

7. Чтобы установить пакет, выполните следующую команду, заменив <PACKAGE_NAME> именем пакета из веб-канала.

   pip install <PACKAGE_NAME>
   

Очистка ресурсов

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

Удаление проекта:

1. Выберите Параметры проекта.
2. На странице сведений о проекте выберите "Удалить" в нижней части страницы.
3. Введите имя проекта для подтверждения и нажмите кнопку "Удалить".

Если вы хотите удалить веб-канал, выполните следующие действия.

1. Выберите артефакты и выберите веб-канал в раскрывающемся меню.
2. Нажмите кнопку "Параметры".
3. На вкладке "Параметры веб-канала" выберите "Удалить канал".
4. Выберите Удалить, чтобы подтвердить.

Чтобы очистить локальную среду разработки, выполните приведенные далее действия.

1. Чтобы отключить виртуальную среду, выполните следующую команду:

   deactivate
   

2. Чтобы удалить виртуальную среду, удалите каталог, в котором он был создан.

3. .pypirc Удалите файл из домашнего каталога.

Если вы клонировали пример пакета Python, вы можете удалить репозиторий с локального компьютера и учетной записи GitHub.

Следующие шаги

• Использование представлений веб-каналов для общего доступа к пакетам

• Публикация пакетов Python с помощью Azure Pipelines

• Создание приложений Python

Связанные статьи

• Ключ артефактов

• Виртуальная среда Python