Alexander Kharitonov 2c08c8a1fc Change README.md.
2022-04-05 10:57:38 +03:00
2022-03-26 18:08:44 +03:00
2022-04-05 10:57:38 +03:00
2022-03-26 00:48:29 +03:00

Конфигурационные файлы для запуска зеркала пакетов pip

Конфигурационные файлы предназначены для развёртывания зеркала pypi для локального применения, например, на случай, если доступ к серверам pypi окажется заблокирован. Используется модуль devpi, который запускается используя docker-compose.

Пакеты при установке будут сохраняться в локальном репозитории, что позволит не скачивать повторно те же файлы через Интернет.

Полное зеркало pypi.org не создаётся, сохраняются только пакеты, которые вы будете скачивать через своё зеркало.

В данном примере используется протокол HTTP, если вам необходимо использовать защищённое соединение, то реализовать это можно, например, при помощи Apache или nginx в качестве обратного прокси-сервера, используя приложение certbot для получения бесплатного сертификата, в этом случае вам возможно потребуется ограничить работу сервера только на локальном интерфейсе, для чего можно создать в каталоге настроек файл .env (образец находится в файле .env.example), который будет содержать следующую строку:

SERVER_IP=127.0.0.1

Естественно после этого нужно пересобрать образ.

Установка

Клонируйте репозиторий

git clone https://github.com/askh/devpisrv.git

Укажите настройки зеркала

При необходимости изменить настройки создаваемого образа, скопируйте файл .env.example под именем .env и отредактируйте его. В первую очередь обратите внимание на переменную ROOT_PASSWORD, если её не установить, то по умолчанию пароль для пользователя root в devpi-server будет «root» (вряд ли это то, чего бы вы хотели).

Соберите образ и запустите сервис

cd devpisrv
docker-compose up -d

Использование

Чтобы при установке приложение pip подключалось к вашему зеркалу, нужно или передать ему его адрес через опции командной строки, либо создать конфигурационный файл, в котором будут указаны соответствующие значения.

Далее предполагается, что адрес вашго зеркала — http://mirror.example.com:3141, для примера будем устанавливать пакет virtualenv.

Использование опций командной строки

pip install -v --timeout 120 --trusted-host mirror.example.com -U -i http://mirror.example.com:3141/root/pypi/+simple/ virtualenv

Использовние конфигруационного файла

Создайте файл ~/.config/pip/pip.conf следующего содержания (замените адреес mirror.expample.com на адрес вашего зеркала):

[global]
index-url=http://mirror.example.com:3141/root/pypi/+simple/
trusted-host=mirror.example.com
timeout=120

После этого устанавливайте пакеты обычным образом, например:

pip install virtualenv
Description
No description provided
Readme MIT 52 KiB
Languages
Python 77.7%
Dockerfile 22.3%