Конфигурация стенда

Конфигурация — это набор настроек, с которыми работают приложения на стенде: версия каждого приложения, адреса внешних систем, включённые и выключенные возможности, лимиты и прочие параметры. Всё это живёт на вкладке Сервисы страницы стенда.

Здесь же выполняется самая частая задача в PDM — поставить на стенд нужную версию приложения.

Откуда берутся значения

У каждой настройки есть два «этажа».

• Значение по умолчанию — общее для всех стендов. Оно задаётся один раз для платформы в целом и меняется только через релиз.
• Переопределение — значение именно для этого стенда. Если оно задано, работает именно оно, а общее значение игнорируется.

Правило простое: есть переопределение — работает оно; нет — работает значение по умолчанию.

Такая схема нужна, чтобы не описывать каждый стенд с нуля: почти всё берётся из общих настроек, а на конкретном окружении отличается только то, что действительно должно отличаться — например, версия одного приложения, которое сейчас тестируют.

Как понять, откуда пришло значение

Смотрите на цвет плашек — и в строке приложения (колонка Развёрнутая версия), и рядом с названием каждого параметра внутри раскрытой карточки.

Плашка	Значение
Синяя	Значение по умолчанию, общее для всех стендов
Оранжевая, подсказка «Переопределено»	Значение этого стенда — именно оно и работает
Зелёная, подсказка «Изменено»	Ваша несохранённая правка, на стенде её ещё нет

Если у параметра видны только синяя плашка и поле ввода — переопределения нет, стенд работает на общем значении. Если рядом появилась оранжевая — стенд «отвязан» от общего значения по этому параметру.

Рядом с названием параметра мелким моноширинным шрифтом показано его техническое имя — то самое имя переменной окружения, под которым настройка доходит до приложения. Это удобно, когда нужно сопоставить настройку в PDM с тем, что вы видите в логах или в документации приложения.

Действие Сбросить к базовому значению убирает переопределение и возвращает стенд к общему значению, а если правка ещё не сохранена — просто отменяет её.

Как изменить настройку

Параметры приложения лежат в его карточке на вкладке Сервисы, сгруппированные по смыслу; параметры без группы попадают в раздел Other. Вид редактора зависит от типа параметра: переключатель «да/нет», текстовое поле, целое или дробное число, номер версии по сегментам, выпадающий список или выбор действия приложения (см. ниже).

Изменения не применяются сразу — они накапливаются как черновик.

Панель несохранённых изменений

Все накопленные правки собираются в панель «Ожидают применения: N» в виде «приложение — параметр: было → стало». Отменить можно как отдельную правку, так и все разом (Отменить все).

Применяет правки кнопка Развернуть изменения — она видна, только если у вас есть право менять конфигурацию этого стенда. Пока вы её не нажали, на стенде ничего не меняется. Обе кнопки сначала спрашивают подтверждение — Отменить все изменения? и Развернуть изменения?.

Версия как результат сборки

Особый вид параметра — действие приложения. Вместо того чтобы вписать версию руками, можно выбрать действие: например, собрать образ из ветки кода или из номера версии. Тогда значением параметра станет результат сборки — тег собранного образа.

У выбранного действия заполняются свои поля — ветка, тег или номер версии; блок Дополнительная информация показывает справочные значения, например текущую версию.

Практический смысл: «выложить на стенд свежесобранную ветку» делается одним действием — сборка и установка версии происходят в рамках одной операции, без ручного переноса номера сборки.

Что происходит после сохранения

Нажатие Развернуть изменения запускает обработку — длительную операцию, разложенную на шаги. Она идёт в фоне, и за ней можно наблюдать.

По шагам происходит следующее:

1. В работу берутся только реально изменённые параметры; нетронутые не трогаются вовсе.
2. Если значение параметра задано действием приложения, сначала выполняется сборка, и её результат становится значением параметра.
3. Когда все значения готовы, финальный шаг записывает их в конфигурацию стенда и применяет к работающему окружению.
4. После успешного применения PDM обновляет у себя сохранённые значения — их видно на вкладке Сервисы при следующем открытии.

Сколько это занимает

Если вы меняли только готовые значения, применение занимает секунды. Если среди изменений есть сборка, операция длится столько, сколько идёт сборка — обычно минуты, иногда дольше. Шаг сборки всё это время остаётся в состоянии «выполняется», это нормально.

Как понять, что применилось

Ход операции виден в разделе Обработки — ищите обработку с названием вида «[имя стенда] Update config». В подробностях каждого шага есть его логи, а у шагов сборки — прямая ссылка на пайплайн.

Признаки того, что всё прошло:

• статус обработки — Завершено, все шаги отмечены как выполненные;
• на вкладке Сервисы стенда после её повторного открытия новые значения показаны как действующие, а панель несохранённых изменений пуста.

Если что-то пошло не так, обработка получает статус Ошибка, и по списку шагов сразу видно, на каком именно месте она остановилась; в подробностях шага будет текст ошибки.

Изменения доходят до реального окружения

Применение конфигурации — не «черновик в PDM». Значения записываются в конфигурацию стенда и применяются к работающему окружению: приложения перечитывают настройки и могут перезапуститься, а смена версии означает выкладку другого образа. На стенде, которым кто-то пользуется прямо сейчас, это заметят все.

Перед нажатием Развернуть изменения:

• проверьте, тот ли стенд открыт — имена стендов повторяются в разных кластерах, ориентируйтесь на кластер и метку проекта в шапке;
• прочитайте список изменений в панели целиком: туда попадает всё, что вы правили, в том числе в других приложениях;
• убедитесь, что на стенде сейчас не идёт чужая работа — тестирование или демонстрация.

Отмены у применённой операции нет. Вернуть прежнее состояние можно только новым изменением конфигурации.

Если что-то не работает

• Не видно кнопки «Развернуть изменения». У вас нет права менять конфигурацию этого стенда. Право выдаётся на конкретную область — возможно, на соседнем стенде кнопка есть, а здесь нет. См. Права доступа.
• Операция падает с ошибкой о токене GitLab. Применение конфигурации выполняется от вашего имени, и для этого в профиле должен быть указан личный токен GitLab. Заполните поле Токен GitLab в настройках аккаунта и повторите операцию.
• Стенд ни разу не синхронизировался. PDM должен знать, куда записывать конфигурацию этого стенда; эти сведения появляются при синхронизации с инфраструктурой. Если стенд появился только что, дождитесь очередной синхронизации.

Что дальше

• Страница стенда — где находится вкладка «Сервисы» и что показывают её колонки.
• Релизы — как изменить настройку сразу на многих стендах.
• Обработки — как читать шаги длительной операции и её логи.