Zum Hauptinhalt springen
Diese Anleitung führt Sie durch das Update einer On-Premise-Installation von 2026.08.x auf 2026.10. Mit dem Update werden der lokale Code Interpreter und das virtuelle Dateisystem zum festen Bestandteil; dafür ergänzen Sie .env und docker-compose.yml von Hand. Außerdem bezieht VARIOS AI die Images ab 2026.10 aus der Container-Registry registry.varios-ai.com statt aus aibroker.azurecr.io. <ZIELVERSION> steht für 2026.10 oder einen späteren Patch-Stand 2026.10.x, den Ihnen das VARIOS AI-Team nennt. Als Installationsverzeichnis wird im Beispiel /docker/variosai verwendet.

A. Vorab (vor dem Wartungsfenster)

  1. Lassen Sie sich vom VARIOS AI-Team bestätigen, dass <ZIELVERSION> veröffentlicht ist.
  2. Prüfen Sie Plattenplatz und Arbeitsspeicher:
  3. Übertragen Sie die Anmeldung auf die neue Container-Registry. Die bisherigen Zugangsdaten gelten auch für registry.varios-ai.com. Der folgende Befehl liest die für aibroker.azurecr.io gespeicherte Anmeldung aus und meldet sich damit an registry.varios-ai.com an. Er benötigt python3. Führen Sie ihn mit sudo -H aus, denn der Update-Dienst varios-update.service läuft als root und verwendet die Anmeldung von root. Wenn Sie docker auch als eigener Benutzer ohne sudo aufrufen, führen Sie den Befehl zusätzlich ohne sudo -H aus:
    Die Ausgabe endet mit Login Succeeded. Bricht der Befehl ab, melden Sie sich mit den Zugangsdaten vom VARIOS AI-Team direkt an:

B. gVisor installieren (optional, empfohlen)

  1. Installieren Sie runsc nach der offiziellen Anleitung und registrieren Sie es als Docker-Runtime: Installation und Docker Quick Start.
  2. Führen Sie den dort beschriebenen Docker-Neustart erst im Wartungsfenster aus, da er alle Container neu startet.
  3. Prüfen Sie die Installation:

C. Sicherung

Legen Sie einen Snapshot der virtuellen Maschine an. Fahren Sie erst danach fort. Weitere Hinweise finden Sie unter Backup und Wiederherstellung.

D. .env anpassen

  1. Prüfen Sie die Tokens:
  2. Wird keine oder nur eine Zeile ausgegeben, legen Sie beide Tokens neu an. Der erste Befehl entfernt eine eventuell vorhandene einzelne Zeile:
  3. Wenn Sie gVisor installiert haben:
  4. Ändern Sie VERSION= nicht.

E. docker-compose.yml anpassen

Ergänzen Sie die bestehende docker-compose.yml von Hand, zum Beispiel mit Vim (vi docker-compose.yml) oder Nano (nano docker-compose.yml). 1. Dienst php → environment: nach MARKITDOWN_URL einfügen
2. Dienst php → depends_on: eine Zeile ergänzen
3. Drei neue Dienste auf Ebene von services: einfügen, zum Beispiel vor redis::
4. Abschnitt networks: am Dateiende ergänzen
5. Imagenamen auf die neue Registry umstellen: Der folgende Befehl ersetzt in der Datei die Domain aibroker.azurecr.io durch registry.varios-ai.com. Ältere Installationen verwenden zusätzlich noch den Pfad avency/botapi/; dieser wird zu variosai/.
In der Ausgabe darf aibroker.azurecr.io nicht mehr vorkommen. Der Code Interpreter startet seine Sandbox ausschließlich aus registry.varios-ai.com/variosai/code-interpreter-sandbox-python. Prüfen Sie die Datei:

F. Update ausführen

Wählen Sie eine der beiden Varianten. Wie der Update-Dienst arbeitet, beschreibt systemd-Dienst.
  1. Fortschritt verfolgen bis Update successfully completed:

G. Nach dem Update: virtuelles Dateisystem befüllen

Die Ausgabe muss No virtual filesystem containers exist yet. lauten, ohne rote Fehlerzeile. Andernfalls beheben Sie zuerst den Fehler (Abschnitt I) und fahren dann fort.

H. Prüfen

  1. In der Oberfläche zeigt System Informationen <ZIELVERSION>, und Dienstzustände enthält keine roten Einträge.
  2. Wenn Sie gVisor installiert haben: Ein Sandbox-Lauf dauert nur wenige Sekunden. Starten Sie deshalb vor dem Testchat den folgenden Befehl. Er wartet auf den nächsten Sandbox-Container und gibt dessen Runtime aus:
  3. Starten Sie einen Testchat mit Code Interpreter: „Berechne mit Python die ersten 20 Primzahlen und speichere sie als primzahlen.txt.“ Die Datei erscheint im Chat und im Panel Dateien. Bei gVisor gibt der Befehl aus Schritt 3 jetzt runtime=runsc aus und endet. Schlägt der Testchat fehl, beenden Sie den Befehl mit Strg+C.
  4. Stellen Sie einem Assistenten mit Dateien eine Frage, deren Antwort aus seinen Dateien stammen muss.

I. Wenn etwas fehlschlägt

Rollback: Spielen Sie den VM-Snapshot zurück. Führen Sie kein Downgrade über Version ändern aus.