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

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

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 にあり、コンソールに出力される内容も同様にこのファイルに記録されます。

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

  • 1 つのログファイルの最大サイズは 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 と入力して終了します。制限された運用保守環境での使用に適しています。

に最終更新