Zum Hauptinhalt springen

Dienstbasierte Bereitstellung und Upgrade

Nachdem clmBot als Systemdienst registriert wurde, kann der clmBot-Server dauerhaft laufen und mit dem System automatisch starten. Dies eignet sich für Server, die die Methode Cloud-Push verwenden. Diese Seite beschreibt außerdem das Hot-Reloading der Konfiguration, die Betriebsprotokolle und Client-Upgrades.

Als Systemdienst registrieren​

Voraussetzung: Der Anschluss von login wurde gemäß Schnellstart abgeschlossen.

Führen Sie den folgenden Befehl aus, um den clmBot-Server als Systemdienst zu registrieren:

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

Registrierungshinweise:

  • Unter Linux wird der Dienst als systemd-Dienst registriert, unter Windows als gleichnamiger Windows-Dienst; beide unterstützen den automatischen Start beim Systemstart.
  • Der Dienstname lautet ssltrus-clm-bot-<节点ID>-<端口>, die Knoten-ID entspricht der bei der Einbindung zugewiesenen clmBot-ID.
  • Der Dienst wird gemäß der bei der Installation angegebenen Konfigurationsdatei und Überwachungsadresse ausgeführt; das Arbeitsverzeichnis ist das Verzeichnis der Konfigurationsdatei.

Falls der Dienst mit dem aktuell angemeldeten Benutzer (statt systemweit) installiert werden soll, kann der Parameter --user hinzugefügt werden.

Dienstverwaltung​

Verwalten Sie den Dienst über 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 # 卸载服务(卸载前自动停止)

Konfigurations-Hot-Reload​

Der clmBot-Server aktiviert standardmäßig das Hot-Reload der Konfiguration (--watch, standardmäßig aktiviert): Nach dem Ändern von config.yaml wird die Konfiguration automatisch neu geladen, ohne dass der Dienst neu gestartet werden muss.

Um das Hot-Reload zu deaktivieren, können Sie beim Start explizit --watch=false angeben.

Betriebsprotokolle anzeigen​

Die clmBot-Betriebsprotokolle befinden sich im Verzeichnis der Konfigurationsdatei unter logs/clm-bot.log. Die in der Konsole ausgegebenen Inhalte werden ebenfalls in dieser Datei aufgezeichnet.

Automatische Rotation der Protokolldateien:

  • Eine einzelne Protokolldatei ist maximal 30 MB groß.
  • Die letzten 90 Tage werden aufbewahrt.
  • Maximal 10 Sicherungsdateien werden aufbewahrt.

clmBot aktualisieren​

Führen Sie den folgenden Befehl aus, um die neueste Version zu prüfen und zu aktualisieren:

./clm-bot-linux-amd64 update

Nach der Ausführung prüft der clmBot von der offiziellen Veröffentlichungsquelle die neueste Version der aktuellen Plattform:

  • Ist bereits die neueste Version vorhanden, wird die aktuelle Versionsnummer ausgegeben und übersprungen.
  • Ist eine neue Version verfügbar, wird diese automatisch heruntergeladen und die Dateiintegrität (SHA-256) überprüft, dann die aktuelle ausführbare Datei ersetzt.

Aktuelle Client-Version anzeigen:

./clm-bot-linux-amd64 --version
Hinweis

Nach Abschluss des Upgrades: Wenn clmBot als Systemdienst ausgeführt wird, führen Sie bitte server --service restart aus, damit die neue Version wirksam wird.

Integriertes Befehlsterminal von Windows​

Auf einem Windows-Server gelangen Sie durch direktes Ausführen der ausführbaren clmBot-Datei ohne Parameter in das integrierte Befehlsterminal. Dieses Terminal kann ausschließlich clmBot-Unterbefehle ausführen. Geben Sie help ein, um Befehle anzuzeigen, und exit, um das Terminal zu beenden. Es eignet sich für eingeschränkte Betriebs- und Wartungsumgebungen.