Kommandozeile: rechenhalle

Installieren

Unter macOS und Linux:

curl -fsSL https://rechenhalle.de/cli/rechenhalle.mjs -o /usr/local/bin/rechenhalle
chmod +x /usr/local/bin/rechenhalle
rechenhalle hilfe

Ohne Schreibrechte in /usr/local/bin geht auch ~/.local/bin. Unter Windows startest du die Datei mit node rechenhalle.mjs.

Anmelden

Lege in der Console unter Team → Zugriffsschlüssel einen Schlüssel an. Seine Rolle bestimmt, was die Kommandozeile darf: Mit Leser kann sie nur ansehen, mit Entwickler auch deployen.

rechenhalle anmelden
API-Schlüssel: ••••••••
✔ Angemeldet – 3 App(s) im Team.

Der Zugang liegt danach in ~/.config/rechenhalle/zugang.json, lesbar nur für dich.

Die wichtigsten Befehle

rechenhalle apps                                 # alle Apps des Teams
rechenhalle anlegen shop https://github.com/ich/shop.git
rechenhalle deploy shop                          # bauen, ausrollen, Log live
rechenhalle status shop                          # Zustand und letzte Deployments
rechenhalle logs shop -f                         # Logs fortlaufend
rechenhalle variablen setzen shop API_KEY=abc
rechenhalle skalieren shop 3
rechenhalle groesse shop m
rechenhalle zurueck shop 41                      # auf Deployment #41 zurück
rechenhalle alarme anlegen shop fehlerquote 5 --minuten 5
rechenhalle kosten

Mit --json liefern apps, status, variablen, alarme und kosten maschinenlesbare Ausgaben für eigene Skripte. rechenhalle hilfe zeigt alle Befehle.

In CI, zum Beispiel GitHub Actions

In Pipelines meldest du dich nicht an, sondern setzt den Schlüssel als Umgebungsvariable RECHENHALLE_TOKEN. Schlägt das Deployment fehl, endet der Befehl mit Code 1 und die Pipeline wird rot – die vorige Version läuft dabei weiter.

- name: Auf Rechenhalle deployen
  run: |
    curl -fsSL https://rechenhalle.de/cli/rechenhalle.mjs -o rechenhalle
    node rechenhalle deploy shop
  env:
    RECHENHALLE_TOKEN: ${{ secrets.RECHENHALLE_TOKEN }}

Weiterlesen

• Alarme einrichten
• Umgebungsvariablen setzen