С помощью этого руководства вы создадите кеширующий реестр и настроите его для работы с пакетами PyPI.
Вы будете использовать следующие инструменты:
Artifact Registry для хранения, совместного использования и управления Docker-образами, Deb-пакетами, RPM-пакетами, Helm-чартами и файлами любого типа (generic).
Pip — система управления пакетами в языке программирования Python.
Шаги:
Зарегистрируйтесь в личном кабинете Cloud.ru.
Если вы уже зарегистрированы, войдите под своей учетной записью.
Подключите сервис Secret Management и укажите в нем данные для авторизации в стороннем хранилище.
Данные нужно указать, если в стороннем хранилище есть приватные артефакты, которые доступны только при вводе имени пользователя и токена или пароля.
На верхней панели слева нажмите и выберите Контейнеры → Artifact Registry.
Нажмите Создать реестр.
Выберите формат реестра PyPI.
Укажите название реестра.
Название реестра станет частью URI реестра, который будет использоваться для аутентификации и работы с образами.
Выберите Публичный или Приватный тип доступа к реестру.
Выберите тип реестра Кеширующий.
В поле Источник выберите каталог пресетов или укажите адрес удаленного хранилища.
Например, pypi.org.
(Опционально) В полях Логин и Пароль выберите авторизационные данные для доступа к стороннему хранилищу.
Данные нужно указать, если в стороннем хранилище есть приватные артефакты, которые доступны только при вводе имени пользователя и токена или пароля.
Нажмите Создать.
Если на предыдущем шаге вы создали приватный реестр, получите персональные ключи доступа, если планируете работать с репозиторием самостоятельно. Или создайте сервисный аккаунт и получите ключи доступа к нему, если планируете организовать командную работу.
Настройте работу системы управления пакетами, чтобы запрашиваемый артефакт проходил через кеширующий реестр Artifact Registry. Это можно сделать несколькими способами:
через разовый запрос определенного артефакта;
изменение файла pip;
переменные окружения.
Чтобы запросить артефакт через кеширующий реестр, выполните команду:
pip install \--index-url https://<key_id>:<key_secret>@<registry_name>-pypi.ar.cloud.ru/simple/ \<package_name>
Где:
<registry_name> — название реестра в Artifact Registry;
<key_id> — логин ключа доступа к приватному реестру;
<key_secret> — пароль ключа доступа к приватному реестру;
<package_name> — название запрашиваемого артефакта.
Если хотите, чтобы пакеты, которых еще нет в кеше или которые публично не проксируются, загружались напрямую с pypi.org, используйте дополнительно команду --extra-index-url:
pip install \--index-url https://<key_id>:<key_secret>@<registry_name>-pypi.ar.cloud.ru/simple/ \--extra-index-url https://pypi.org/simple \<package_name>
Где:
<registry_name> — название реестра в Artifact Registry;
<key_id> — логин ключа доступа к приватному реестру;
<key_secret> — пароль ключа доступа к приватному реестру;
<package_name> — название запрашиваемого артефакта.
Вы можете задать настройку глобально, изменив файл. Тогда все запрашиваемые артефакты будут загружаться через кеширующий реестр.
Выполните команду:
pip config set global.index-url "https://<key_id>:<key_secret>@<registry_name>-pypi.ar.cloud.ru/simple/"
Где:
<registry_name> — название реестра в Artifact Registry;
<key_id> — логин ключа доступа к приватному реестру;
<key_secret> — пароль ключа доступа к приватному реестру.
Также можно отредактировать файл вручную:
Откройте файл pip.
Если у вас ОС Windows, файл pip.ini находится в директории %APPDATA%\pip\.
Если у вас ОС Linux или MacOS файл pip.conf находится в директории ~/.config/pip.
Добавьте строки:
[global]index-url = https://<key_id>:<key_secret>@<registry_name>-pypi.ar.cloud.ru/simple/
Где:
<registry_name> — название реестра в Artifact Registry;
<key_id> — логин ключа доступа к приватному реестру;
<key_secret> — пароль ключа доступа к приватному реестру.
Выполните команды последовательно:
export PIP_INDEX_URL="https://<key_id>:<key_secret>@<registry_name>-pypi.ar.cloud.ru/simple/"pip install <package_name>
Где:
<registry_name> — название реестра в Artifact Registry;
<key_id> — логин ключа доступа к приватному реестру;
<key_secret> — пароль ключа доступа к приватному реестру;
<package_name> — название запрашиваемого артефакта.
Запросите список артефактов через кеширующий реестр, выполнив запрос:
curl https://<key_id>:<key_secret>@<registry_name>-pypi.ar.cloud.ru/simple/
Где:
<registry_name> — название реестра в Artifact Registry;
<key_id> — логин ключа доступа к приватному реестру;
<key_secret> — пароль ключа доступа к приватному реестру.
Если список загрузился, кеширующий реестр работает.
Вы научились:
создавать кеширующий реестр Artifact Registry;
настраивать кеширующий реестр для работы с PyPI-пакетами.