Перейти к основному содержимому

Способы обновления сертификатов

clmBot поддерживает два способа обновления сертификатов — их можно выбирать в зависимости от сетевого окружения сервера:

Способ обновленияРежим работыТребования к портамПодходящие сценарии
Отправка из облакаОбновление инициируется из панели управления, серверная часть clmBot принимает и применяет егоТребуется открыть входящий порт 8862/tcpКогда сетевая политика это разрешает и обновление должно применяться немедленно
Получение по расписаниюclmBot периодически запускается через crontab или планировщик задач Windows и проверяет наличие обновленийОткрывать входящий порт не требуетсяСерверы, на которых нельзя открыть входящий порт (рекомендуемый способ по умолчанию)

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

Способ 1: отправка из облака​

Запуск серверной части clmBot на сервере​

./clm-bot-linux-amd64 server -a="0.0.0.0:8862"

Параметр -a задаёт адрес и порт прослушивания; по умолчанию используется 0.0.0.0:8862. После запуска clmBot постоянно работает в серверном режиме и ожидает отправки данных из облака.

Внимание
  • Необходимо открыть входящий порт 8862/tcp в межсетевом экране сервера и облачной группе безопасности.
  • Серверная часть clmBot использует взаимную аутентификацию TLS для соединений отправки из облака и принимает сертификаты только для узлов, подключение и активация которых завершены.

Если вы не хотите открывать входящий порт, используйте способ 2: получение по расписанию。

Информация

Для приёма обновлений серверная часть clmBot должна постоянно работать. В рабочей среде рекомендуется зарегистрировать её как системную службу и настроить автоматический запуск при загрузке; см. Развёртывание в качестве службы и обновление。

Отправка сертификата из панели управления​

Войдите в панель управления, откройте список точек установки, найдите нужную точку и нажмите 推送证书. После подтверждения система отправит на сервер последний сертификат и автоматически завершит обновление.

Способ 2: получение по расписанию​

Получение по расписанию не требует открытия входящих портов и рекомендуется как способ по умолчанию. В clmBot нет встроенного планировщика: команду обновления необходимо периодически запускать через crontab, планировщик заданий Windows или имеющуюся систему планирования.

Linux: настройка crontab​

Добавьте команду обновления clmBot в crontab:

crontab -e

Добавьте строку (запуск проверки обновления сертификата каждый день в 3 часа ночи):

0 3 * * * cd /opt/clm-bot && ./clm-bot-linux-amd64 update-certificate >> update.log 2>&1
Внимание
  • Перед выполнением команды необходимо сначала перейти cd в каталог установки clmBot, так как clmBot по умолчанию читает config.yaml из текущего каталога.
  • Также можно не переключать каталог, а указать путь к файлу конфигурации с помощью параметра -c: ./clm-bot-linux-amd64 -c /opt/clm-bot/config.yaml update-certificate.
  • Пожалуйста, замените путь на фактический каталог установки.

Результат выполнения будет добавлен в update.log, при этом clmBot будет записывать журнал выполнения в logs/clm-bot.log в каталоге, где находится файл конфигурации.

Windows: настройка задания по расписанию​

Создайте задание по расписанию на сервере Windows для запуска по таймеру:

cd /d C:\clm-bot && clm-bot-windows-amd64.exe update-certificate >> update.log 2>&1

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

Автоматическое перевыпуск и обновление сертификатов​

Сертификаты, обновляемые clmBot, поступают из автоматического перевыпуска в облаке. Войдите в административную панель, перейдите на страницу сведений о SSL-сертификате, в настройках автоматического перевыпуска выберите или введите период перевыпуска (например, 30 дней) и сохраните.

Общий эффект после настройки:

  1. До истечения срока действия сертификата облако автоматически завершает перевыпуск в соответствии с заданным периодом и создаёт новый сертификат.
  2. clmBot получает новый сертификат настроенным способом (push или периодическое получение).
  3. clmBot выполняет обновление локального сертификата:
  • Если локальный сертификат совпадает с последним сертификатом в облаке, обновление пропускается.
  • В противном случае предпринимается попытка создать резервную копию с меткой времени .bak, после чего последовательно выполняются before_script, запись нового сертификата и выполнение after_script. Если создание резервной копии не удалось, ошибка будет записана, но обновление продолжится; завершение перезагрузки службы следует оценивать по результату выполнения сценария и состоянию промежуточного ПО.
Подсказка

Если необходимо принудительно однократно выполнить after_script без обновления сертификата (например, для отладки сценария перезагрузки), можно использовать параметр --force-after.