Окружение

На странице Окружение перечислены все свойства, которые сервис Spring Boot определяет во время выполнения, сгруппированные по источникам свойств. Для каждого свойства указано значение, отмечен источник, который в данный момент определяет свойство, а там, где Spring связывает свойство с бином, — ссылка на @ConfigurationProperties и на точки инъекции, которые его считывают.

главная страница окружения Окружение в интерфейсе Axelix

Если в сервисе есть активные профили Spring или профили по умолчанию, они отображаются в верхней части страницы под Профили: — чипы объединяют spring.profiles.default и spring.profiles.active. Блок скрыт, если профиль не задан.

Под профилями расположен прокручиваемый список всех свойств, сгруппированный по источникам свойств. Каждый источник — раскрывающаяся секция (по умолчанию развёрнутая), над списком есть поле поиска, фильтрующее источники свойств и записи, а также счётчик вида <соответствует> / <всего>.

  • Имя источника: имя источника свойств.
  • Описание: наведите курсор на иконку иконка info рядом с названием источника, чтобы увидеть пользовательское описание этого источника свойств, если оно есть.
  • Свойства: список свойств в источнике.

Подробности свойства

страница подробностей свойства Выпадающий блок свойства в интерфейсе Axelix

В каждой строке свойств отображается название свойства, кнопка копирования в буфер обмена, разрешенное значение и маркер основного источника. При раскрытии строки открывается панель с подробной информацией:

  • Имя: имя свойства.
  • Значение: значение, полученное из этого источника свойств.
  • Актуальное значение: помечено иконкой короны иконка короны в столбце значений. Корона означает, что это значение является приоритетным при разрешении — если один и тот же ключ присутствует в нескольких источниках свойств, то основным будет считаться только тот источник, к которому среда Spring обратилась первой.
  • Устаревшее: устаревшие свойства выделены красным фоном в заголовке строки, а на панели сведений отображается сообщение об устаревании.
  • Описание: описание из spring-configuration-metadata.json, если доступно.
  • Configuration Properties: @ConfigurationPropertiesкомпонент, который привязывает это свойство, если таковой имеется. Имя компонента — это ссылка ссылка перехода, которая ведет на страницу «Свойства конфигурации» с привязкой к этому компоненту.
  • Инжектируется в: бины, которые потребляют это свойство через @Value или аналогичные механизмы. Каждый элемент — это ссылка ссылка перехода, которая ведёт на страницу Beans с привязкой к этому компоненту.

По умолчанию все значения маскируются как ****** для пользователей, не обладающих полномочиями ENV_VALUES_READ. О том, как выбрать, какие ключи будут замаскированы, а какие останутся открытыми, см. в разделе Маскирование значений.

Маскирование значений

Axelix никогда не полагается на переключатель Spring Boot management.endpoint.env.show-values — он всегда просит Spring Boot вернуть сырые значения (Show.ALWAYS) и поверх применяет собственное маскирование на основе проверки полномочий.

Кто видит исходные значения. Вызывающие с полномочием ENV_VALUES_READ предоставляемыми встроенными ролями ADMIN и SUPER_ADMIN — получают исходные значения. Остальные получают значения, заменённые на ******. Полную матрицу ролей и полномочий см. в разделе Роли и полномочия.

Какие ключи маскируются. Одно свойство стартера — axelix.sbs.endpoints.config.sanitized-properties — управляет этим набором, и оно применяется и к axelix-env (эта страница), и к axelix-configprops (страница Configuration Properties):

  • Пустой список (по умолчанию) — все значения маскируются для пользователей без соответствующих полномочий.
  • Непустой список — маскируются только указанные ключи, остальные возвращаются без изменений.
axelix.sbs.endpoints.config.sanitized-properties[0]=database.password
axelix.sbs.endpoints.config.sanitized-properties[1]=spring.datasource.password
axelix.sbs.endpoints.config.sanitized-properties[2]=jwt.signing-key

См. Маскирование чувствительных значений свойств в руководстве по настройке Spring Boot Starter — то же свойство описано рядом с остальными настройками стартера.

Стандартные свойства Spring Boot Actuator для маскирования — management.endpoint.env.show-values, management.endpoint.env.keys-to-sanitize и их эквиваленты для configprops — не учитываются. Вместо них используйте axelix.sbs.endpoints.config.sanitized-properties.

MCP-инструменты

Полное окружение управляемого сервиса — свойства приложения, системные свойства и переменные окружения ОС — также доступно ИИ-агентам через MCP. См. Каталог MCP-инструментов.

Включите Нужный Actuator Ендпоинт

Если вы используете Axelix 1.2.0 или новее, ничего из этого не требуется: стартер сам регистрирует свои actuator-эндпоинты, а эндпоинты health/info Axelix больше не требуются — он отлично работает и без них. Никакая настройка здесь не нужна.

Страница работает поверх actuator-эндпоинта axelix-env, который добавляет Axelix Spring Boot Starter. Она доступна через стандартные свойства Spring Boot Actuator. Полный список конечных точек Axelix и сопутствующих настроек см. в разделе Настройка Spring Boot Starter:

management.endpoints.web.exposure.include=axelix-env

См. также

На этой странице