NuGet

NORA выступает в роли кеширующего прокси для NuGet v3 API. Файлы пакетов (.nupkg, .nuspec) кешируются иммутабельно; сервисный индекс и метаданные обновляются по TTL. Это реестр только для чтения — публикация пакетов не поддерживается.

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

Добавьте NORA в качестве источника NuGet:

dotnet nuget add source http://nora.example.com:4000/nuget/v3/index.json -n nora

Или в nuget.config:

<configuration>
  <packageSources>
    <add key="nora" value="http://nora.example.com:4000/nuget/v3/index.json" />
  </packageSources>
</configuration>

Затем восстанавливайте пакеты как обычно:

dotnet restore

Проксирование upstream

config.toml:

[nuget]
enabled = true
proxy = "https://api.nuget.org"
proxy_timeout = 30
metadata_ttl = 300  # seconds

Переменные окружения:

Переменная	Описание	По умолчанию
NORA_NUGET_ENABLED	Включить прокси NuGet	false
NORA_NUGET_PROXY	URL upstream NuGet API	https://api.nuget.org
NORA_NUGET_PROXY_AUTH	Аутентификация upstream (user:pass)	—
NORA_NUGET_PROXY_TIMEOUT	Таймаут upstream в секундах	30
NORA_NUGET_METADATA_TTL	TTL кеша метаданных в секундах	300

Возможности

Функция	Статус	Примечание
Сервисный индекс (/v3/index.json)	Полная	URL @id перезаписываются на NORA
Индекс регистрации	Полная	Кешируется по TTL
Список версий (flat container)	Полная	Кешируется по TTL
Скачивание .nupkg	Полная	Иммутабельный кеш
Скачивание .nuspec	Полная	Иммутабельный кеш
Публикация пакета	—	Только прокси (чтение)
Поиск	—	Не реализован

Известные ограничения

• Только прокси: dotnet nuget push не поддерживается. NORA кеширует пакеты, загруженные из upstream-реестра.
• Endpoint поиска не реализован.
• Отключён по умолчанию. Установите NORA_NUGET_ENABLED=true для активации.