Обязательно к прочтению
1
5 минут
Начни с изучения основ
2
15 минут
Установи werf и изучи его возможности, развернув демо-приложение
3
15 минут
Изучи основы применения werf в любых системах CI/CD
4
несколько часов
Найди руководство подходящиее твоему проекту
Раздел содержит массу информации о настройке выката для приложений. Здесь можно найти руководство, подходящее для вашего проекта (по языку программирования, фреймворку, системе CI/CD и т.п.) и развернуть первое настоящее приложение в кластер Kubernetes с помощью werf.
Справочник
1
Найди структурированную информацию о конфигурировании werf и его командах
  • Чтобы использовать werf, конфигурацию приложения необходимо описать в файле werf.yaml.
  • werf также использует аннотации в определениях ресурсов для изменения поведения механизма оотслеживания ресурсов в процессе выката.
  • Интерфейс командной строки содержит полный список команд werf с описанием.
Дополнительная миля
1
Получи глубокие знания, которые понадобятся по мере использования werf
  • Конфигурация рассказывает и принципах шаблонизации конфигов werf и генерации связанных с развертыванием имен (таких как пространства имен Kubernetes или названия релизов).
  • Helm** повествует об основах деплоя: как настраивать werf, что такое helm-чарт и релиз. Здесь можно узнать об основах шаблонизации Kubernetes-ресурсов и способах использования собранных образов, описанных в файле werf.yaml, во время деплоя. Также уделяется внимание работе с секретами и приводится различная полезная информация. Этот раздел рекомендуется к прочтению тем, кто желает больше узнать об организации процесса деплоя с помощью werf.
  • Очистка - в этом разделе рассказвается о концепции процесса очистки в werf и приводятся основные команды для выполнения очистки.
  • CI/CD — описываются ключевые аспекты организации рабочих процессов в рамках CI/CD с помощью werf. Здесь вы узнаете об использовании werf в GitLab CI/CD, GitHub Actions и других CI/CD системах.
  • Сборка образов с помощью Stapel рассказывает о кастомном сборщике introduces werf под названием Stapel. Интегрированный в него алгоритм распределенной сборки позволяет организовывать пайплайны сборки, отличающиеся чрезвычайно высокой скоростью работы, с применением распределенного кэширования и инкрементными ре-билдами, базирующимися на Git-истории вашего приложения.
  • Разработка и отладка повествует об отладке процессов сборки и развертывания приложения в случае, когда что-то пошло не так. Здесь же приводятся инструкции о настройке локальной среду разработки.
  • Поддерживаемые реализации container registry — приводятся общие сведения о поддерживаемых реализациях container registry и рассказывается об авторизации.
2
Узнай как werf работает внутри

Для полноценного применения werf ознакомление с этим разделом не требуется, однако он будет полезен тем, что хочет больше узнать об устройстве и принципах работы инструмента.

  • Сборка образов — рассказзывается о том, что такое сборщик образов и стадии, как работает хранилище стадий, что такое сервер синхронизации, а также приводится другая информация, связанная с процессом сборки.
  • Как работает интеграция с CI/CD.
  • Преобразование имен в werf — описывается алгоритм, который werf использует для автоматического преобразования имен и замены недопустимых символов (например, в namespace’ах Kubernetes или именах Helm-релизов).
  • Интеграция с SSH-агентом — показано, как интегрировать SSH-агент в процесс сборки в werf.
  • Для разработчиков — этот раздел для разработчиков содержит руководства по обслуживанию/поддержке и другую документацию, написанную разработчиками werf для разработчиков werf. Здесь можно узнать, как работают определенные подсистемы werf, как поддерживать субсистему в актуальном состоянии, как писать и собирать новый код для werf, и т.п.