メインコンテンツまでスキップ

クイックスタート

本ページでは、15分以内にclmBotのデプロイを完了し、証明書更新の一連のフローを1回実行する方法を説明します。

開始前の確認事項：

  • 锐安信 CaaS サービスが开通されており、管理后台にログインできること。
  • 対象サーバーからクラウドサービスへの外向きアクセスが可能であること。
  • サーバーの管理者権限を保有していること（clmBotのインストールと初期化に必要）。

第1步：AccessKey / AccessSecret の生成​

管理后台にログインし、锐安信 CaaS サービス -> 产品详情 -> SSL 证书详情 に移動し、生成AK/SK をクリックして AccessKey（AK）と AccessSecret（SK）を取得します。

注意

AccessKey と AccessSecret は適切に保管してください。AccessSecret を Git リポジトリにコミットしたり、公開スクリプトに記載したり、信頼できない第三者システムに送信したりしないでください。漏洩が疑われる場合は、管理后台で再生成してください。

第2步：clmBot をダウンロードしてサーバーにアップロード​

clmBot のリリースページから、対応するOSバージョンのプログラムをダウンロードします：

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 ノードが 1 件追加されているのが確認できます。ノードの右側にある 接続を許可 スイッチをクリックして、このノードをアクティブ化します。

情報

新しく接続したノードはデフォルトで無効状態です。コンソールでアクティブ化した後でのみ、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 を実行します。バックアップが失敗した場合はエラーを記録しますが、更新を続行します。サービスのリロードが完了したかどうかは、スクリプトの結果とミドルウェアの状態に基づいて判断する必要があります。

次のステップ​

に最終更新