← Cloudflare Fundamentals / fundamentals / reference
Политика поддержки экосистемы SDK
Жизненный цикл
Если иное не указано в репозитории кода, Cloudflare оказывает активную поддержку только для последней основной версии библиотеки или инструмента. Исключение составляют критические исправления безопасности: каждый такой случай рассматривается индивидуально с учётом уязвимости, её последствий и необходимых мер по устранению.
Мы выделяем три основных этапа разработки: ранний доступ, активная поддержка и завершение поддержки.
Ранний доступ
На этом этапе Cloudflare предоставляет доступ к изменениям SDK, по которым собирается обратная связь перед выпуском для широкого использования. Ранний доступ часто сопровождается предупреждениями или оговорками о функциональности, которая может измениться без предварительного уведомления. Как правило, SDK с ранним доступом не подходят для промышленных систем, если не указано иное.
Активная поддержка
На этапе активной поддержки для библиотеки или инструмента предлагаются запланированные изменения и поддержка.
Окончание жизненного цикла
На этапе завершения жизненного цикла выходит новая мажорная версия библиотеки или инструмента, и Cloudflare помечает предыдущую мажорную версию как более не получающую улучшений и исправлений ошибок. Если вы продолжаете использовать версии с завершённым жизненным циклом, поддержка будет крайне ограниченной.
Предыдущие версии или версии с истёкшим сроком поддержки
Хотя Cloudflare не может обеспечивать поддержку всех старых версий наших библиотек и инструментов, мы не удаляем эти версии, поэтому их можно продолжать использовать без прямой поддержки.
Версионирование
Экосистема SDK следует принципам семантического версионирования, которое определяет версии следующим образом:
- Номер MAJOR увеличивается при внесении обратно несовместимых изменений.
- Номер MINOR увеличивается при добавлении функциональности с сохранением обратной совместимости.
- PATCH-версия для обратно совместимых исправлений ошибок (без каких-либо улучшений).
В зависимости от ваших потребностей убедитесь, что версионирование пакетного менеджера вашего приложения настроено правильно. Как минимум ограничьте установку текущей мажорной версией используемой библиотеки или инструмента, чтобы избежать автоматического обновления до новой мажорной версии.
Переход
По возможности Cloudflare предлагает автоматизированный способ обновления до новых основных версий с помощью codemods, чтобы свести к минимуму сбои. Порядок использования этих инструментов миграции см. в примечаниях к выпуску конкретной библиотеки или инструмента.
Помимо автоматической миграции, мы также предоставляем документацию об произошедших изменениях на случай, если вам потребуется внести их вручную.