Настройка транспорта и TLS

Для доступа к разделу у пользователя должна быть роль Администратор

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

Настройки транспорта

Адрес и соединение

Общие настройки транспорта сохраняются в базе данных и входят в одну ревизию: публичный URL, режим работы сервиса, список CORS-источников и сертификат TLS. Эти значения не переопределяются ENV.

Поле Назначение и формат Когда применяется
Публичный URL Внешний адрес приложения для ссылок и настроек безопасности браузера. Укажите http:// или https://, имя узла и при необходимости порт, например https://salary.example.test. Не указывайте имя пользователя, пароль, запрос или путь; завершающий / допустим. Поле должно быть обязательно заполнено. Сохраняется в общей ревизии транспорта. Чтобы узлы использовали новое значение, запустите команду Перезапустить сервис.
Режим работы сервиса Выберите HTTP или HTTPS для входящих соединений самого приложения. Это не режим восстановления узла. Если HTTPS завершается на доверенном обратном прокси, приложение может принимать соединения по HTTP. Сохраняется в общей ревизии и применяется при перезапуске узла.
CORS origins (по одному на строку) Список веб-адресов, с которых открытые в браузере страницы отправляют запросы к приложению и читают ответы. Для каждого укажите схему и имя узла, а при необходимости порт: например https://salary.example.test или http://localhost:5173. Не указывайте путь, завершающий /, шаблон *, запрос, фрагмент или учётные данные. Разрешено укахывать до 32 источников, пустые строки игнорируются. Оставьте список пустым, если страницы и приложение открыты с одного источника. Добавьте точные адреса размещения страниц, если они загружаются с другого источника. Сервис не разрешает другие источники автоматически. Изменение применяется после перезапуска узлов.

Поле Режим работы сервиса задаёт, на каком соединении приложение принимает запросы. Оно не определяет Режим работы узла в карточке узла. На этой странице режим и способ доступа к восстановлению показываются, когда узел находится в соответствующем состоянии.

Параметры контроллера

Контроллер следит за узлами и координирует команды перезапуска через общую базу данных. Длительность должна указываться с единицей измерения: s — секунды, m — минуты, h — часы. Например, 5s, 30s, 2m или 1m30s. Значение без единицы, например 30, не допускаются.

Интервалы связи с узлами

Поле Назначение и допустимое значение Когда применяется
Интервал опроса Как часто узел проверяет команды из очереди и отправляет подтверждение о своем состояния. По умолчанию 5s; значение должно быть больше нуля. Сохранённое значение начнёт действовать на узле после явного перезапуска.
Порог устаревшего узла Период после которого состояние узла становится неизвестным (устаревшим). По умолчанию 30s; значение должно быть больше нуля. Неизвестное состояние не доказывает, что приложение остановлено. Сохранённое значение начнёт действовать на узле после явного перезапуска.

Команды перезапуска

Поле Назначение и допустимое значение Когда применяется
Срок начала команды Сколько времени даётся узлу, чтобы начать выполнение принятой команды на перезапуск. По умолчанию 2m0s; значение должно быть больше нуля. При принятии команды срок её начала фиксируется из действующего тогда значения. Новое сохранённое значение действует для команд после перезапуска узла. Подробнее — срок начала команды.
Ожидание остановки Сколько времени отводится на ожидание штатной остановки процессов узла перед перезапуском. По умолчанию 30s; значение должно быть больше нуля. Если остановка не завершилась, новый запуск ждёт фактического завершения прежней работы. Истечение этого срока само по себе не завершает процесс. Новое сохранённое значение действует после перезапуска узла. Подробнее — ход перезапуска.
Ожидание готовности кандидата Сколько времени отводится на подготовку приложения на этом узле во время перезапуска: загрузку сохранённых настроек, создание необходимых компонентов, открытие HTTP- или HTTPS-службы и проверку её готовности. После успешной проверки приложение начинает принимать обычные запросы. По умолчанию 1m0s (допустимо от 5s до 10m). При следующем явном перезапуске это значение задаёт время подготовки приложения. После успешного перезапуска оно становится действующим на узле. Подробнее — ход перезапуска.

Предупреждение TLS

Поле Назначение и допустимое значение Когда применяется
Срок предупреждения TLS, дней За сколько дней до окончания срока сертификата показывать предупреждение. По умолчанию 30; допустимо целое число от 1 до 365. Это только срок предупреждения: значение не продлевает сертификат. При сохранении это значение сразу используется для статуса ожидающего сертификата. После успешного явного перезапуска оно задаёт предупреждения для сертификатов работающих узлов.

Сохранённые и действующие значения

Общие правила описаны в разделе Источники настроек и сохранение. Эти подписи относятся к параметрам контроллера, а не к общей ревизии транспорта. Поля контроллера при открытии формы показывают Сохранено:

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

Для параметров контроллера значения из ENV и .env нельзя изменить в этой форме. Если источник — YAML, сохранение значения заменит его. Подпись источника показывается для ENV, .env и YAML; база данных и значение по умолчанию отдельной подписью не отмечаются. Строка со сравнением появляется, только когда введённое значение отличается от действующего.

Загрузить сертификат TLS

TLS — защищённое соединение HTTPS. Сертификат и закрытый ключ нужны, если приложение переключено в режим работы по HTTPS. Если HTTPS завершается на доверенном прокси, загрузка сертификата в приложение может быть не нужна.

Поле или статус Назначение и формат
Выбрать цепочку сертификатов PEM Выберите файл .pem, .crt или .cer с цепочкой сертификатов. Размер — не более 262 144 байт (примерно 262 Кб) и не более 16 сертификатов. Сертификаты должны действовать сейчас и образовывать корректную цепочку.
Выбрать закрытый ключ PEM Выберите соответствующий незашифрованный парольной фразой ключ в файле .pem или .key. Поддерживаются форматы PKCS#1, PKCS#8 и SEC1. Размер — не более 65 536 байт (примерно 66 Кб). Ключ должен соответствовать сертификату.
Я понимаю риск передачи закрытого ключа по HTTP Подтверждение требуется, когда страница панели открыта по HTTP. Оно зависит от адреса страницы, а не от выбранного режима работы сервиса. Передача ключа по HTTP не защищена от перехвата; используйте HTTPS, особенно в публичной сети.
Сертификат ожидающей конфигурации Показывает состояние сертификата в ожидающих настройках (которые будут применены после перезагрузки): Сертификат действует, Срок сертификата скоро истекает или Сертификат истёк, а также владельца и поле Действует до. Дата показана в часовом поясе браузера. Порог предупреждения берётся из параметра настроек Срок предупреждения TLS, дней. Это сведения для ожидающей к загрузке конфигурации, оно не отностится к сертификату, который используется узлом в данный момент.

До выбора файла рядом с каждым полем отображается Файл не выбран. После выбора цепочки отображается её имя. Для закрытого ключа интерфейс показывает только Закрытый ключ выбран — имя и содержимое ключа не показывает.

Размер всей загрузки, включая оба файла, не может превышать 1 048 576 байт (примерно 1 Мб).

  1. Сначала сохраните нужные Публичный URL, Режим работы сервиса и CORS origins (по одному на строку) кнопкой Сохранить настройки.
  2. Выберите цепочку сертификатов и закрытый ключ. Если страница открыта по HTTP, подтвердите риск передачи ключа.
  3. Нажмите Загрузить TLS и дождитесь окончания загрузки. Во время отправки кнопка показывает Загрузка….

Загрузка сертификата сама сохраняет ожидающую конфигурацию TLS, но не включает HTTPS и не переключает узлы. Для загрузки сервис берёт URL, режим и CORS из уже сохранённых настроек; несохранённые изменения формы перечитываются и теряются. После завершения любой попытки загрузки выбор файлов и подтверждение HTTP сбрасываются.

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

Сохранение транспорта и контроллера

Общие правила описаны в разделе Источники настроек и сохранение. Для транспорта действуют следующие особенности:

  1. Нажмите Сохранить настройки. Пока запрос выполняется, кнопка показывает Сохранение…. Она сохраняет общую ревизию транспорта и параметры контроллера, но не перезапускает узлы.
  2. Чтобы начать применение сохранённых настроек, используйте команду Перезапустить сервис над вкладками страницы Настройки. Она описана в инструкции перезапуска. Успешный явный перезапуск применяет новые настройки транспорта и следующие параметры контроллера на каждом перезапущенном узле.
  3. Если форма устарела после изменений другого администратора, появится сообщение Настройки были изменены. Обновите данные и повторите действие. Кнопки сохранения, отмены и загрузки TLS останутся недоступны, пока вы успешно не перечитаете настройки. Сохраните свои правки отдельно. Нажмите Перечитать настройки, затем внесите их заново.

Кнопка Перечитать настройки заменяет несохранённые изменения данными с сервера без дополнительного подтверждения. Общие правила перечитывания и применения внешних источников приведены в разделе Источники настроек и сохранение.

Отмена ожидающих изменений

Кнопка Отменить ожидающие изменения удаляет только отдельную ожидающую ревизию для настроек транспорта: URL, режим работы, CORS и TLS. Она не откатывает фактическую конфигурацию узлов и не меняет параметры контроллера. Если ревизия уже выбрана для применения командой перезапуска, отменить её нельзя.

Кнопка отображается, только если есть отдельная ожидающая ревизия транспорта с изменениями URL, режима работы, CORS или TLS, которая ещё не выбрана для применения. Если изменены только параметры контроллера, кнопка не отображается: введите прежние значения вручную и сохраните настройки. Если новые значения уже применены к узлам, для их замены также потребуется явный перезапуск.

Состояние восстановления узлов

В нижней части Настройки → Транспорт могут появляться справочные сообщения по отдельным узлам. Они показывают последнее полученное состояние восстановления и ошибки доступа; изменить их в этой форме нельзя. Набор полей зависит от состояния узла: часть сведений появляется только при обслуживании или ошибке.

Не путайте поле формы Режим работы сервиса, которое задаёт HTTP или HTTPS, и Режим работы узла, которое показывает состояние запущенного сервиса.

Поле Как читать
Режим работы узла Показывает состояние обычного сервиса: Обычный сервис запущен, Только восстановление узла, Запуск, Перезапуск или Ошибка. Если состояние нельзя определить, рядом указывается причина: Нет актуального ответа от узла, Запись узла удалена, Полученные сведения не позволяют определить режим работы узла или Нет сведений об этом узле.
Способ доступа к восстановлению Показывает, где узел открыл страницу восстановления: Прежние настройки соединения, Локальный аварийный вход или Прежние настройки соединения и локальный аварийный вход. При неизвестном способе отображается пояснение; остальные значения описаны в разделе режимы восстановления.
Причина восстановления Показывает, какая проблема стала причиной перехода узла в режим восстановления, например неудачное применение настроек или истёкший сертификат TLS.
Ошибка открытия доступа к восстановлению Поясняет, что помешало запустить режим восстановления для конкретного вызова. Эта ошибка сама по себе не означает, что недоступны все способы входа на всех узлах.

Примеры сочетаний:

  • Только восстановление узла и Прежние настройки соединения: обычные функции не запущены, а узел доступен только через страницу восстановления с прежними настройками HTTP/HTTPS-соединения. Порядок входа описан в разделе режим восстановления.
  • Только восстановление узла и Локальный аварийный вход: обычные функции не запущены, страница восстановления доступна через локальный адрес (127.0.0.1 или localhost) на хосте где запущен экземпляр узла. Это не localhost компьютера администратора. Точное значение адреса зависит от конкретной установки, например, от порта и сети контейнера.
  • Обычный сервис запущен и Локальный аварийный вход: такое сочетание возможно, например, если истёк сертификат работающего HTTPS-сервиса. Обычный сервис продолжает принимать HTTPS-соединения, но браузер может блокировать доступ панели управления. Локальный доступ к странице восстановления нужен для замены сертификата. Нет актуального ответа от узла означает, что система не получила свежего подтверждения состояния от узла (keep-alive не получен вовремя). Это не означает, что процесс узла остановлен. Проверьте в карточке узла время последнего сигнала с обновлением и связь, а причины и адреса восстановления — в разделе режимы восстановления.