• Русский

    • Работа с PyPI

    Proxy-репозиторий

    curl -X POST https://save.example.com/api/v1/repos \
  -H "Content-Type: application/json" \
  -u "<username>:<password>" \
  -d '{
    "project": "backend",
    "name": "pypi-proxy",
    "format": "pypi",
    "repository_type": "proxy",
    "remote_url": "https://pypi.org/",
    "cache_ttl": 3600
  }'

    Hosted-репозиторий

    curl -X POST https://save.example.com/api/v1/repos \
  -H "Content-Type: application/json" \
  -u "<username>:<password>" \
  -d '{
    "project": "backend",
    "name": "pypi-hosted",
    "format": "pypi",
    "repository_type": "hosted"
  }'

    После создания репозиторий доступен по URL https://save.example.com/pypi/<project>/<repository>/. Simple-индекс — по /simple/, загрузка пакета (twine-совместимый POST) — на корень репозитория.

    Настройка клиента

    pip

    # Разовая установка через флаг --index-url
pip install --index-url https://save.example.com/pypi/<project>/pypi-proxy/simple/ <package>

# Постоянная конфигурация через pip.conf
cat > ~/.config/pip/pip.conf << EOF
[global]
index-url = https://USER:PASS@save.example.com/pypi/<project>/pypi-proxy/simple/
trusted-host = save.example.com
EOF
    Расположение pip.conf
    • Linux/macOS: ~/.config/pip/pip.conf или ~/.pip/pip.conf
    • Windows: %APPDATA%\pip\pip.ini
    • В virtualenv: $VIRTUAL_ENV/pip.conf
    Robot-аккаунты в CI

    Для CI/CD используйте robot-аккаунт: username = sa$<robot-name>, password = <api-key>. Конфиг pip.conf не меняется — отличается только значение username. Подробнее — в общем разделе Аутентификация.

    poetry

    В pyproject.toml:

    [[tool.poetry.source]]
name = "codescoring"
url = "https://save.example.com/pypi/<project>/pypi-proxy/simple/"
priority = "primary"

    Credentials передаются через poetry config:

    poetry config http-basic.codescoring <username> <password>

    pipenv

    В Pipfile:

    [[source]]
url = "https://USER:PASS@save.example.com/pypi/<project>/pypi-proxy/simple/"
verify_ssl = true
name = "codescoring"

    uv

    uv pip install --index-url https://save.example.com/pypi/<project>/pypi-proxy/simple/ <package>

    Или в pyproject.toml:

    [[tool.uv.index]]
name = "codescoring"
url = "https://save.example.com/pypi/<project>/pypi-proxy/simple/"
default = true

    Публикация (twine, hosted)

    Загрузка пакетов в hosted-репозиторий — стандартным twine upload. URL-адрес публикации — корень репозитория (без /simple/).

    # ~/.pypirc
[distutils]
index-servers = codescoring

[codescoring]
repository = https://save.example.com/pypi/<project>/pypi-hosted/
username = <username>
password = <password>
    python -m build               # сгенерировать .whl и sdist в dist/
twine upload -r codescoring dist/*

    Миграция URL репозитория

    Сценарий использования: миграция репозитория PyPI с Nexus / Artifactory на CodeScoring.Save.

    ИсточникURL в pip.conf до миграцииURL в pip.conf после миграции
    Nexushttps://nexus.host.ru/repository/pypi-proxy/simplehttps://save.example.com/pypi/<project>/pypi-proxy/simple/
    Artifactoryhttps://jfrog.host.ru/artifactory/api/pypi/pypi-remote/simplehttps://save.example.com/pypi/<project>/pypi-proxy/simple/
    Официальный репозиторийhttps://pypi.org/simplehttps://save.example.com/pypi/<project>/pypi-proxy/simple/

    Параметры аутентификации (имя пользователя / пароль) и формат pip.conf сохраняются без изменений.

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

    Проверка простого индекса

    curl -u "<username>:<password>" \
  https://save.example.com/pypi/<project>/pypi-proxy/simple/<package>/

    Ответ — HTML-страница со списком ссылок на файлы пакета. Если страница пустая или возвращается 404 — пакет не закэширован и upstream его не вернул.

    Состояние сервиса

    curl https://save.example.com/health

    Аудит по репозиторию

    curl -u "<username>:<password>" \
  "https://save.example.com/api/v1/admin/audit?resource_type=repository&q=pypi-proxy&limit=50"
    Страница была полезна?