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

Быстрый старт

Данная страница поможет вам завершить развёртывание clmBot в течение 15 минут и успешно выполнить полный цикл обновления сертификата.

Перед началом убедитесь, что:

  • Услуга sslTrus CaaS уже активирована, и вы можете войти в консоль администратора.
  • Целевой сервер имеет исходящий доступ к облачным сервисам.
  • У вас есть права администратора на сервере (необходимы для установки и инициализации clmBot).

Шаг 1. Создание AccessKey / AccessSecret​

Войдите в консоль администратора, перейдите в раздел «Услуга sslTrus CaaS» -> «Сведения о продукте» -> «Сведения о SSL-сертификате» и нажмите 生成AK/SK, чтобы получить AccessKey (AK) и AccessSecret (SK).

Внимание

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

Шаг 2. Загрузка clmBot и передача на сервер​

Загрузите программу для соответствующей версии системы со страницы выпусков clmBot:

Загрузить clmBot

Выберите версию, соответствующую операционной системе и архитектуре сервера (например, clm-bot-linux-amd64), и загрузите её на сервер. Рекомендуется создать для неё отдельный каталог установки, например /opt/clm-bot.

mkdir -p /opt/clm-bot && cd /opt/clm-bot
chmod 755 clm-bot-linux-amd64

Шаг 3: Вход и подключение​

В каталоге установки выполните команду login для завершения подключения:

./clm-bot-linux-amd64 login

Следуя подсказкам, сначала выберите номер адреса облака (или введите адрес облака напрямую), затем по очереди введите AccessKey и AccessSecret.

После успешного входа clmBot создаст в каталоге установки файл конфигурации config.yaml, в котором сохранит информацию о подключении.

Шаг 4: Активация узла в административной консоли​

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

Информация

Новый подключённый узел по умолчанию отключён. Только после активации в консоли clmBot сможет получать сертификаты из облака.

Шаг 5: Обнаружение сертификатов на сервере​

Выполните команду обнаружения сертификатов, чтобы автоматически просканировать уже развёрнутые на сервере сертификаты и пути их хранения:

./clm-bot-linux-amd64 discover-certificate

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

  • all: загрузить все
  • none: не загружать
  • 1,3-5: выбрать по порядковым номерам, поддерживается запись диапазонов

После успешной загрузки эти сертификаты появятся в панели управления как точки установки, а clmBot создаст соответствующую конфигурацию для каждой точки установки в файле config.yaml в текущем каталоге.

Информация

В автоматически созданной конфигурации каждая точка установки содержит поля before_script, after_script, где after_script — это скрипт перезагрузки, выполняемый после обновления сертификата; необходимо убедиться, что он работает в вашей среде. Описание полей см. в справочнике по конфигурации.

Шаг 6. Завершение первого обновления сертификата​

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

./clm-bot-linux-amd64 update-certificate

После выполнения clmBot проверит, есть ли в облаке более новый сертификат:

  • Локальный сертификат уже актуален: выводится сообщение, и шаг пропускается.
  • В облаке есть новый сертификат: предпринимается попытка создать резервную копию .bak, записать новый сертификат и в соответствии с конфигурацией выполнить after_script. Если создание резервной копии не удалось, ошибка будет зафиксирована, но обновление продолжится; завершена ли перезагрузка службы, следует определять по результату работы скрипта и состоянию промежуточного ПО.

Дальнейшие действия​