Быстрый старт
Данная страница поможет вам завершить развёртывание clmBot в течение 15 минут и успешно выполнить полный цикл обновления сертификата.
Перед началом убедитесь, что:
- Услуга sslTrus CaaS уже активирована, и вы можете войти в консоль администратора.
- Целевой сервер имеет исходящий доступ к облачным сервисам.
- У вас есть права администратора на сервере (необходимы для установки и инициализации clmBot).
Шаг 1. Создание AccessKey / AccessSecret
Войдите в консоль администратора, перейдите в раздел «Услуга sslTrus CaaS» -> «Сведения о продукте» -> «Сведения о SSL-сертификате» и нажмите 生成AK/SK, чтобы получить AccessKey (AK) и AccessSecret (SK).
Надёжно сохраните AccessKey и AccessSecret. Не помещайте AccessSecret в репозитории Git, не записывайте его в общедоступные скрипты и не отправляйте в недоверенные сторонние системы. Если есть подозрение на утечку, повторно создайте его в консоли администратора.
Шаг 2. Загрузка 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. Если создание резервной копии не удалось, ошибка будет зафиксирована, но обновление продолжится; завершена ли перезагрузка службы, следует определять по результату работы скрипта и состоянию промежуточного ПО.
Дальнейшие действия
- Выберите способ обновления сертификата (push из облака или периодическое получение).
- В производственной среде рекомендуется ограничить права запуска clmBot, см. Требования к правам запуска.
- Зарегистрируйте clmBot как системную службу для автоматического запуска при загрузке, см. Развёртывание и обновление в виде службы.