CLI - simplecloud

Was ist die CLI?

Die SimpleCloud CLI ist dein primäres Werkzeug zur Verwaltung deiner Cloud-Infrastruktur. Sie bietet Befehle für Authentifizierung, Setup, Komponenten-Management und Server-Operationen.

Installation

Installiere die CLI mit dem offiziellen Install-Script:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/simplecloudapp/simplecloud-manifest/HEAD/install.sh)"

Befehlsstruktur

sc <befehl> [unterbefehl] [argumente] [optionen]

Globale Optionen

Option	Beschreibung
`-c, --context`	Aktiven Context überschreiben
`-h, --help`	Hilfe anzeigen
`-v, --version`	Versionsnummer anzeigen

Authentifizierung

Bei SimpleCloud authentifizieren.

sc login

Option	Beschreibung
`--no-browser`	Browser nicht automatisch öffnen
`--code`	Vorab genehmigten Code vom Dashboard verwenden

Logout

Von SimpleCloud abmelden.

sc logout

Who Am I

Aktuelle Benutzerinformationen anzeigen.

sc whoami

Setup & Installation

Setup

SimpleCloud einrichten: Context konfigurieren, Dependencies installieren und Serverhost herunterladen.

sc setup

Option	Beschreibung
`-o, --org`	Organisations-ID oder Slug (überspringt interaktive Auswahl)
`--code`	Vorab genehmigten Code vom Dashboard verwenden

Komponenten installieren

Komponenten aus der Component Registry installieren.

sc install [komponenten..]

Komponenten aktualisieren

Installierte Komponenten auf neueste Version aktualisieren.

sc update [komponenten..]

CLI upgraden

Die CLI auf die neueste Version upgraden.

sc upgrade

Komponenten-Lifecycle

Start

SimpleCloud-Komponenten starten.

sc start [komponenten..]

Option	Beschreibung
`--runner`	Runner-Typ überschreiben (`screen`, `docker`, `native`)
`--configure`	Standard-Runner konfigurieren
`--skip-version-check`	Versionsprüfung vor dem Start überspringen
`--update`	Veraltete Komponenten automatisch aktualisieren

Stop

SimpleCloud-Komponenten stoppen.

sc stop [komponenten..]

Restart

SimpleCloud-Komponenten neu starten (Stop dann Start).

sc restart [komponenten..]

Status

Status von SimpleCloud-Komponenten prüfen.

sc status [komponenten..]

Logs

Logs einer Komponente anzeigen.

sc logs <komponente>

Option	Beschreibung
`-n, --lines`	Anzahl der anzuzeigenden Zeilen (Standard: 100)

Attach

An eine laufende Komponenten-Konsole anhängen.

sc attach <komponente>

Context-Verwaltung

Verbindungs-Contexts verwalten. Aliase: contexts, ctx

Contexts auflisten

sc context list

Context verwenden

Zu einem Context wechseln.

sc context use <name>

Context hinzufügen

Neuen Context hinzufügen.

sc context add [name]

Context entfernen

Context entfernen.

sc context remove <name>

Aktueller Context

Aktuellen Context anzeigen.

sc context current

Gruppen-Verwaltung

Server-Gruppen verwalten. Alias: groups

Gruppen auflisten

sc group list

Gruppe erstellen

Neue Gruppe mit interaktivem Wizard erstellen.

sc group create

Option	Beschreibung
`-y, --auto-retry`	Automatisch mit vorherigen Antworten wiederholen

Gruppen-Info

Gruppeninformationen anzeigen.

sc group info <gruppe>

Server in Gruppe starten

Server in der Gruppe starten.

sc group start <gruppe>

Gruppe aktualisieren

Gruppeneinstellungen aktualisieren.

sc group update <gruppe>

Option	Beschreibung
`--name`	Neuer Gruppenname
`--type`	Gruppentyp (`SERVER`, `PROXY`, `LOBBY`)
`--active`	Aktiv-Status setzen
`--max-memory`	Maximaler Speicher in MB
`--min-memory`	Minimaler Speicher in MB
`--max-players`	Maximale Spieler
`--scaling-min`	Minimale Server für Skalierung
`--scaling-max`	Maximale Server für Skalierung

Gruppe löschen

Gruppe löschen.

sc group delete <gruppe>

Gruppen-Plugins

Plugins für eine Gruppe verwalten.

# Plugins zu einer Gruppe hinzufügen
sc group plugin add <gruppe> [suche]

# Plugins einer Gruppe auflisten
sc group plugin list <gruppe>

# Plugin von einer Gruppe entfernen
sc group plugin remove <gruppe> <plugin>

Server-Verwaltung

Laufende Server verwalten. Alias: servers

Server auflisten

sc server list

Server-Info

Serverinformationen anzeigen.

sc server info <server> [numerische-id]

Server stoppen

Server stoppen.

sc server stop <server> [numerische-id]

Server-Logs

Server-Logs anzeigen.

sc server logs <server> [numerische-id]

Blueprint-Verwaltung

Server-Blueprints verwalten. Aliase: blueprints, bp, bps

Blueprints auflisten

sc blueprint list

Blueprint-Info

Blueprint-Informationen anzeigen.

sc blueprint info <blueprint>

Blueprint aktualisieren

Blueprint-Einstellungen aktualisieren.

sc blueprint update <blueprint>

Blueprint löschen

Blueprint löschen.

sc blueprint delete <blueprint>

Persistent-Server-Verwaltung

Persistente Server verwalten. Aliase: pserver, pservers

Persistente Server auflisten

sc persistent-server list

Persistenten Server erstellen

Neuen persistenten Server mit interaktivem Wizard erstellen.

sc persistent-server create

Persistent-Server-Info

Informationen zum persistenten Server anzeigen.

sc persistent-server info <server>

Persistenten Server aktualisieren

Einstellungen des persistenten Servers aktualisieren.

sc persistent-server update <server>

Persistenten Server löschen

Persistenten Server löschen.

sc persistent-server delete <server>

Persistent-Server-Plugins

Plugins für einen persistenten Server verwalten.

# Plugins hinzufügen
sc persistent-server plugin add <server> [suche]

# Plugins auflisten
sc persistent-server plugin list <server>

# Plugin entfernen
sc persistent-server plugin remove <server> <plugin>

Netzwerk-Verwaltung

Netzwerkkonfiguration verwalten. Aliase: networks, net

Netzwerk registrieren

Neues Netzwerk registrieren.

sc network register

Netzwerk verifizieren

Netzwerk-Credentials verifizieren.

sc network verify

Serverhost-Verwaltung

Server-Hosts verwalten. Aliase: serverhosts, host, hosts

Serverhost hinzufügen

Neuen Serverhost mit interaktivem Wizard hinzufügen.

sc serverhost add

Serverhost registrieren

Neuen Serverhost registrieren.

sc serverhost register

Serverhost verifizieren

Serverhost verifizieren.

sc serverhost verify <id>

Shell-Completion

Shell-Completion-Scripts generieren.

sc completion

Kurzreferenz

Aufgabe	Befehl
SimpleCloud einrichten	`sc setup`
Alle Komponenten starten	`sc start`
Status prüfen	`sc status`
Logs anzeigen	`sc logs <komponente>`
Gruppe erstellen	`sc group create`
Gruppen auflisten	`sc group list`
Server starten	`sc group start <gruppe>`
Server auflisten	`sc server list`
Server stoppen	`sc server stop <name> [id]`
An Konsole anhängen	`sc attach <komponente>`
Context wechseln	`sc context use <name>`

Core Concepts

Server Host

​Was ist die CLI?

​Installation

​Befehlsstruktur

​Globale Optionen

​Authentifizierung

​Login

​Logout

​Who Am I

​Setup & Installation

​Setup

​Komponenten installieren

​Komponenten aktualisieren

​CLI upgraden

​Komponenten-Lifecycle

​Start

​Stop

​Restart

​Status

​Logs

​Attach

​Context-Verwaltung

​Contexts auflisten

​Context verwenden

​Context hinzufügen

​Context entfernen

​Aktueller Context

​Gruppen-Verwaltung

​Gruppen auflisten

​Gruppe erstellen

​Gruppen-Info

​Server in Gruppe starten

​Gruppe aktualisieren

​Gruppe löschen

​Gruppen-Plugins

​Server-Verwaltung

​Server auflisten

​Server-Info

​Server stoppen

​Server-Logs

​Blueprint-Verwaltung

​Blueprints auflisten

​Blueprint-Info

​Blueprint aktualisieren

​Blueprint löschen

​Persistent-Server-Verwaltung

​Persistente Server auflisten

​Persistenten Server erstellen

​Persistent-Server-Info

​Persistenten Server aktualisieren

​Persistenten Server löschen

​Persistent-Server-Plugins

​Netzwerk-Verwaltung

​Netzwerk registrieren

​Netzwerk verifizieren

​Serverhost-Verwaltung

​Serverhost hinzufügen

​Serverhost registrieren

​Serverhost verifizieren

​Shell-Completion

​Kurzreferenz