Перейти к основному содержимому
Версия: v2 (текущая)

Релизы и обновления on-prem

TL;DR. PanDev Metrics регулярно выпускает новые сборки. Обновление on-prem — это смена image tag в docker-compose.yml (или values.yaml для Helm) и рестарт. Полный changelog по релизам со ссылками на сборки — в разделе Релизы → Текущий релиз.

Как узнать текущую версию​

Знание текущей версии — первый шаг перед любым разговором про апгрейд.

Версия отдаётся через actuator-эндпоинт бэкенда:

terminal
curl -s http://<ваш-сервер>:9090/actuator/info | jq .build.version

Версию также видно в футере веб-интерфейса после входа под админом.

Где смотреть release notes​

Подробные release notes лежат в отдельном разделе документации, не на этой странице.

Подробный changelog по каждому релизу со всеми версиями компонентов и ссылками на сборки плагинов лежит в отдельном разделе документации:

Каждая запись о релизе содержит:

  • Версия бэкенда (pandev-metrics) и Docker tag
  • Версии плагинов JetBrains, VS Code, Xcode, Visual Studio
  • Версии CLI и браузерных расширений
  • Bug fixes и новые фичи

Как обновиться (Docker Compose)​

Стандартный апгрейд Docker Compose — это четыре шага: бэкап, смена тэга, pull, рестарт.

Обновления не разрушают данные — PostgreSQL переживает смену версий. Перед апгрейдом всё равно сделайте бэкап.

  1. Прочитайте release notes для целевой версии.
  2. Сделайте бэкап PostgreSQL через pg_dump (см. бэкапы).
  3. Обновите image tag в docker-compose.yml:
docker-compose.yml
services:
  pandev-metrics:
    image: pandevofficial/pandev-metrics:<НОВАЯ_ВЕРСИЯ>
    ports:
      - "8080:8080"
      - "9090:9090"
  1. Подтяните образ и перезапустите:
terminal
docker compose pull pandev-metrics
docker compose up -d pandev-metrics
  1. Проверьте, что /actuator/health возвращает {"status":"UP"} и что версия в /actuator/info совпадает с целевой.

Миграции БД выполняются автоматически при старте.

Как обновиться (Kubernetes / Helm)​

Для Helm-деплоев — поменяйте image tag в values.yaml и выполните helm upgrade.

  1. Сделайте бэкап PostgreSQL.
  2. Обновите image tag в values.yaml:
values.yaml
image:
  tag: <НОВАЯ_ВЕРСИЯ>
  1. Примените:
terminal
helm upgrade pandev-metrics ./pandev-metrics -f values.yaml
  1. Дождитесь раскатки:
terminal
kubectl rollout status deployment/pandev-metrics

Совместимость версий​

Мы поддерживаем только forward-обновление: ставите новую сборку, схема мигрирует на месте, и всё работает. Downgrade после применения миграций не поддерживается — если нужно откатиться, восстанавливайте бэкап. Плагины (IDE, browser, CLI) совместимы в пределах мажорной версии — обновляйте их в удобном темпе.

FAQ​

Частые вопросы про релизы и обновления on-prem.

Как часто выходят релизы on-prem?​

PanDev Metrics регулярно выпускает обновления бэкенда и плагинов. Жёсткой каденции нет — minor-версии выходят раз в несколько недель, патчи по мере необходимости. Темп лучше смотреть в Архиве релизов.

Нужно ли обновлять плагины вместе с бэкендом?​

Не всегда. Плагины совместимы по версиям — старые плагины продолжают работать с более новым бэкендом в рамках одного мажора. Чтобы получить новые фичи (например, учёт AI-активности в CLI), обновите плагин до версии, указанной в release notes.

Можно ли пропускать версии при обновлении?​

Да. Миграции выстраиваются в цепочку, поэтому при переходе с 4.5.x сразу на 4.7.2 отработают все промежуточные миграции по порядку. Сделайте бэкап и прочитайте notes по всем пропущенным версиям, чтобы не пропустить breaking changes.

Как откатить неудачный апгрейд?​

Остановите новый контейнер, восстановите PostgreSQL из дампа, который сделали перед обновлением, и запустите предыдущий image tag. In-place downgrade не поддерживается — миграции схемы идут только вперёд.

Где скачать сборки плагинов?​

Прямые ссылки на JetBrains, VS Code и Xcode-сборки публикуются в каждой записи релиза — см. Текущий релиз. Если рабочие станции разработчиков ходят через ограниченный egress и не могут достучаться до cdn.pandev.io, разместите артефакты на внутреннем зеркале.

Сопутствующее чтение для админов on-prem.