#Миграция с архивного OSA Proxy

Этот раздел описывает перенос конфигурации с архивной Java/Spring-версии OSA Proxy на текущую реализацию OSA Proxy. Архивная конфигурация использовала файл application.yml; текущая версия использует osa-proxy.yml.

#Основные изменения

Поля codescoring.enable-status-line, codescoring.block-status-code, codescoring.block-on-codescoring-errors и codescoring.remove-blocked-versions сохраняют смысл, но должны быть перенесены в новую структуру osa-proxy.yml.

#Новые возможности

• Поддержка Composer и RubyGems.
• Переопределение режима работы для отдельного репозитория через repository[*].work-mode.
• Фильтрация типов файлов на уровне репозитория через repository[*].file-type-filter.
• Явная настройка HTTP-сервера и HTTP-клиента в http.server и http.client вместо Spring Boot / WebFlux properties.

#Пример миграции npm

Legacy-конфигурация:

codescoring:
  host: https://codescoring.example.com
  token: "<token>"
  work-mode: strict_wait
  proxy-manager-host: https://osa-proxy.example.com
  block-on-codescoring-errors: true
  remove-blocked-versions: true

npm:
  enabled: true
  repository:
    - name: internet-npm
      scan-package: true
      scan-manifest: true
      url-encoded-config: true
      registry: https://registry.npmjs.org

Конфигурация для текущего OSA Proxy:

codescoring:
  url: https://codescoring.example.com
  token: "<token>"
  work-mode: strict_wait
  osa-proxy-url: https://osa-proxy.example.com
  block-on-codescoring-errors: true
  remove-blocked-versions: true
  block-status-code: 403

npm:
  enabled: true
  repository:
    - name: internet-npm
      scan-package: true
      scan-manifest: true
      work-mode: strict_wait
      url-encoded-config: true
      registry: https://registry.npmjs.org

logging:
  level: info

После миграции npm-клиент использует тот же route name:

npm config set registry https://osa-proxy.example.com/internet-npm/
npm view lodash version

#Checklist миграции

1. Создайте новый файл osa-proxy.yml.
2. Перенесите URL платформы CodeScoring из codescoring.host в codescoring.url.
3. Перенесите токен в codescoring.token.
4. Перенесите внешний URL прокси из codescoring.proxy-manager-host в codescoring.osa-proxy-url.
5. Выберите глобальный codescoring.work-mode и при необходимости задайте repository[*].work-mode для отдельных репозиториев.
6. Перенесите секции пакетных менеджеров и проверьте name, registry, scan-manifest, scan-package, url-encoded-config.
7. Включайте cache.judge.enabled только если доступен Redis и нужно кэширование вердиктов.
8. Обновите конфигурацию package managers, чтобы они использовали URL текущего OSA Proxy.
9. Проверьте GET /healthz, GET /metrics и один тестовый запрос к каждому включенному типу репозитория.

#Что удалить из старой конфигурации

Spring Boot параметры, JVM options и actuator-настройки не являются частью osa-proxy.yml. В текущей версии не используются endpoints /actuator/metrics и /actuator/prometheus; метрики доступны напрямую по /metrics.