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

サービス化デプロイとアップグレード

clmBot をシステムサービスとして登録すると、clmBot サーバーは常駐稼働し、システム起動時に自動起動します。クラウドプッシュ方式を利用するサーバーに適しています。本ページでは、設定のホットリロード、稼働ログ、クライアントアップグレードについても説明します。

システムサービスとして登録​

前提:クイックスタートに従って login の接続が完了していること。

以下のコマンドを実行して、clmBot サーバーをシステムサービスとして登録します:

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

登録说明:

  • Linux上はsystemdサービスとして登録され、Windows上は同名のWindowsサービスとして登録され、いずれも起動時の自動起動に対応しています。
  • サービス名はssltrus-clm-bot-<节点ID>-<端口>、ノードIDは接続時に割り当てられたclmBot IDです。
  • サービスはインストール時に指定された設定ファイルとリスニングアドレスに従って動作し、作業ディレクトリは設定ファイルのあるディレクトリです。

現在のログインユーザー(システムレベルではなく)でサービスをインストールする場合は、--userパラメータを追加できます。

サービスの管理​

server --service <动作>でサービスを管理します:

./clm-bot-linux-amd64 server --service status    # 查看服务状态
./clm-bot-linux-amd64 server --service start # 启动服务
./clm-bot-linux-amd64 server --service stop # 停止服务
./clm-bot-linux-amd64 server --service restart # 重启服务
./clm-bot-linux-amd64 server --service uninstall # 卸载服务(卸载前自动停止)

設定のホットリロード​

clmBot サービスはデフォルトで設定のホットリロードを有効にしています(--watch、デフォルトで有効):config.yaml を変更すると自動的に設定が再読み込みされ、サービスの再起動は不要です。

ホットリロードを無効にするには、起動時に明示的に --watch=false を指定します。

実行ログの確認​

clmBot の実行ログは設定ファイルが配置されているディレクトリの logs/clm-bot.log にあり、コンソールに出力される内容も同ファイルに記録されます。

ログファイルは自動的にローテーションされます:

  • 単一ログファイルの最大サイズは 30MB です。
  • 直近 90 日間分を保持します。
  • 最大 10 個のバックアップファイルを保持します。

clmBot のアップグレード​

以下のコマンドを実行して最新バージョンを確認し、アップグレードします:

./clm-bot-linux-amd64 update

実行後、clmBot は公式リリースソースから現在のプラットフォームの最新バージョンを確認します:

  • すでに最新バージョンの場合、現在のバージョン番号を出力してスキップします。
  • 新しいバージョンがある場合、自動的にダウンロードしてファイルの整合性を検証し(SHA-256)、現在の実行可能ファイルを置き換えます。

現在のクライアントバージョンを確認:

./clm-bot-linux-amd64 --version
注意

アップグレード完了後、clmBot がシステムサービスとして実行されている場合は、server --service restart を実行して新しいバージョンを有効にしてください。

Windows 内蔵コマンドターミナル​

Windows サーバー上で、引数なしで clmBot 実行可能ファイルを直接実行すると、内蔵コマンドターミナルに入ります。このターミナルでは clmBot サブコマンドのみを実行でき、help でコマンドを表示し、exit で終了します。制限のある運用環境での使用に適しています。