Обязательно к прочтению
4
несколько часов
Найди руководство подходящее твоему проекту
Раздел содержит массу информации о настройке выката для приложений. Здесь можно найти руководство, подходящее для вашего проекта (по языку программирования, фреймворку, системе CI/CD и т.п.) и развернуть первое настоящее приложение в кластер Kubernetes с помощью werf.
Справочник
Найди структурированную информацию о конфигурировании werf и его командах
- Чтобы использовать werf, конфигурацию приложения необходимо описать в файле
werf.yaml. - werf также использует аннотации в определениях ресурсов для изменения поведения механизма отслеживания ресурсов в процессе выката.
- Интерфейс командной строки содержит полный список команд werf с описанием.
Дополнительная миля
Получи глубокие знания, которые понадобятся по мере использования werf
- Гитерминизм рассказывает о том как реализован детерминизм с гит, какие он вводит ограничения и почему.
- 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 registries содержит информацию об особенностях использования различных container registries.
Узнай, как werf работает внутри
Для полноценного применения werf ознакомление с этим разделом не требуется, однако он будет полезен тем, что хочет больше узнать об устройстве и принципах работы инструмента.
- Сборка образов — рассказывается о том, что такое сборщик образов и стадии, как работает хранилище стадий, что такое сервер синхронизации, а также приводится другая информация, связанная с процессом сборки.
- Как работает интеграция с CI/CD.
- Преобразование имен в werf — описывается алгоритм, который werf использует для автоматического преобразования имен и замены недопустимых символов (например, в namespace Kubernetes или именах Helm-релизов).
- Интеграция с SSH-агентом — показано, как интегрировать SSH-агент в процесс сборки в werf.
- Для разработчиков — этот раздел для разработчиков содержит руководства по обслуживанию/поддержке и другую документацию, написанную разработчиками werf для разработчиков werf. Здесь можно узнать, как работают определенные подсистемы werf, как поддерживать субсистему в актуальном состоянии, как писать и собирать новый код для werf, и т.п.