Woodpecker CI 3.18: загрузка логов, усиленная безопасность и улучшения Kubernetes
Разработчики Woodpecker CI выпустили версию 3.18 - очередное обновление легковесной самостоятельной платформы CI/CD, совместимой с GitHub, GitLab, Gitea и Forgejo. Новый релиз сосредоточен на работе с логами pipeline, безопасности плагинов, стабильности агентов и расширении возможностей Kubernetes-интеграции.
Перед обновлением администраторам необходимо учесть важную особенность: Woodpecker CI 3.18 выполняет миграцию базы данных, связанную с хранением логов. На крупных установках, где накопилось много строк журналов, процедура может занять заметное время. Поэтому рекомендуется заранее создать резервную копию и предусмотреть дополнительное окно простоя. Пользователям, которые планируют Woodpecker CI 3.18 скачать, стоит сначала проверить свободное место, состояние базы данных и совместимость действующей конфигурации.
Новые возможности работы с логами
Одним из главных изменений стал отдельный endpoint для скачивания логов pipeline. Теперь журналы можно получать более удобным способом, в том числе использовать их для последующего анализа, архивирования или передачи во внешние системы мониторинга. Порядок строк в логах шагов также исправлен: сообщения возвращаются в корректной последовательности, что упрощает поиск причины сбоя.
Изменилась и внутренняя структура хранения данных. Система теперь обеспечивает одну запись лога на строку и использует уникальный индекс. Такой подход повышает предсказуемость обработки журналов, однако именно он стал причиной обязательной миграции базы при переходе на новую версию. Подробные сведения о нововведениях и изменениях доступны в обзоре Woodpecker CI 3.18.
Повышение безопасности плагинов
Выпуск 3.18 ужесточает правила передачи переменных окружения плагинам. Дополнительные переменные и значения, связанные с matrix-конфигурациями, больше не внедряются автоматически. Это сокращает объём информации, который может стать доступен стороннему плагину во время выполнения задачи.
Нововведение особенно важно для команд, использующих плагины из внешних репозиториев. Даже если инструмент выглядит безопасным, ограничение окружения уменьшает потенциальные последствия ошибки или компрометации. Поэтому тема "Woodpecker CI плагины и безопасность" теперь напрямую связана не только с выбором расширений, но и с контролем переменных, секретов и прав доступа.
Изменения в Kubernetes и интеграциях
В Kubernetes-бэкенде появилась настройка, позволяющая отключить передачу имени runtime class. Это пригодится администраторам кластеров, где используются нестандартные политики запуска контейнеров либо требуется более строгий контроль над параметрами рабочих нагрузок. Кроме того, теперь можно указать домен кластера вручную, не полагаясь на значение по умолчанию.
Таким образом, Woodpecker CI Kubernetes интеграция становится гибче для корпоративных и многокластерных сред. Администраторы получают больше контроля над сетевой моделью и запуском pipeline, что особенно важно при использовании изолированных namespaces, собственных DNS-зон и специализированных runtime.
Изменения затронули и GitLab: в качестве идентификатора группы теперь применяется полный путь группы. Это корректнее обрабатывает вложенные пространства имён и снижает вероятность конфликтов в организациях со сложной иерархией проектов.
Pipeline, агенты и управление доступом
Ручной запуск pipeline теперь допускает передачу собственного сообщения. Благодаря этому в истории выполнения можно сохранить объяснение причины запуска - например, указать, что сборка выполняется после экстренного исправления или перед выпуском релиза. В DAG-процессах Woodpecker CI 3.18 дополнительно требует уникальных имён для шагов и сервисов, предотвращая неоднозначность при построении графа зависимостей.
Сервер также блокирует подключение агентов с несовместимой версией gRPC-протокола. Это позволяет раньше обнаруживать проблемы совместимости и не допускать нестабильных соединений. Одновременно агенты стали лучше переживать временные сбои: после ошибки DeadlineExceeded они повторяют попытку подключения, как это уже происходило для состояния Unavailable.
Для инсталляций, связанных сразу с несколькими forge-платформами, добавлена раздельная настройка списка организаций для каждого сервиса. Это позволяет точнее регулировать доступ и не применять единые ограничения ко всем Git-хостингам. Система также отклоняет некорректные состояния workflow, сортирует файлы workflow по имени и определяет предыдущий и последний pipeline по номеру pipeline, а не по внутреннему идентификатору записи в базе.
Исправления для Windows и техническое обслуживание
В локальном бэкенде Windows появился внутренний инструмент для декодирования данных Base64. Кроме того, исправлена проблема, из-за которой несколько команд PowerShell могли выполняться некорректно. Эти изменения делают использование Woodpecker CI в смешанных инфраструктурах более стабильным, особенно когда часть сборочных агентов работает не на Linux.
Разработчики также обновили ряд зависимостей. В список изменений вошли новые версии Git-плагина Woodpecker, клиента GitLab API, библиотеки Docker CLI, protobuf-компонентов и пакетов фронтенда. Хотя подобные обновления не всегда заметны пользователю, они важны для устранения уязвимостей, совместимости с современными сервисами и снижения технического долга.
Что проверить перед обновлением
Перед установкой релиза стоит сохранить конфигурацию сервера, сделать резервную копию базы и убедиться, что агенты смогут работать с новой версией протокола. Также желательно заранее оценить продолжительность миграции журналов на крупных экземплярах и предупредить разработчиков о возможном перерыве в запуске задач.
После обновления рекомендуется проверить скачивание логов, запуск ручного pipeline с пользовательским сообщением, работу секретов и переменных окружения в плагинах. В Kubernetes-среде следует отдельно протестировать runtime class, домен кластера и создание временных рабочих нагрузок.
Для тех, кто изучает Woodpecker CI документация, наиболее важными разделами станут настройки агентов, плагинов, Kubernetes-бэкенда и миграции базы данных. А пользователям, которым нужна Woodpecker CI настройка pipeline, следует обратить внимание на уникальность имён шагов и сервисов при использовании DAG. Дополнительное описание релиза и технических деталей опубликовано в материале о новых функциях Woodpecker CI 3.18.
