Node-Betriebssupport

Fehlerebene bestimmen, dann den nächsten Befehl ausführen

Hier finden Sie gebündelte Prüfpfade für Verbindung, Builds, Runner, Netzwerk und Speicher dedizierter physischer Apple-Silicon-Nodes. Jeder Schritt nennt das Prüfobjekt, den Befehl und das Ergebnis, anhand dessen Sie den nächsten Schritt bestimmen können.

Wenn Sie bereits einen Node haben, notieren Sie zuerst Node-ID und Zeitraum des Problems. Vor der Bestellung können Sie sich die drei verfügbaren Konfigurationen und vier wählbaren Nodes ansehen.

RUNBOOK / NODE CHECK L0—L4
L0
Node-Status Node-ID, Region und vom Control Panel gemeldeten Status prüfen
Zuerst bestätigen
L1
Verbindungsweg Adresse, Port, Schlüsselberechtigungen und Hostschlüssel-Fingerabdruck
SSH
L2
Toolchain Xcode, Signiermaterial, Schlüsselbund und Build-Logs
BUILD
L3
Aufgabenausführung Runner-Prozess, Arbeitsverzeichnis, Cache und parallele Aufgaben
CI
L4
Hardwarepfad Freier Speicher, externe SSD, Netzwerk und Thunderbolt 5
I/O
Mindestangaben für ein Ticket Node-ID + Zeitraum + Befehlsausgabe
Einstieg zur Fehlerbehebung wählen

Nach Ort des Fehlers weiterleiten

Ändern Sie nicht gleichzeitig Konfigurationen auf mehreren Ebenen. Wählen Sie zuerst die Kategorie, die am besten zum beobachteten Verhalten passt, führen Sie deren Basisprüfungen durch und gehen Sie anschließend mit den Ergebnissen zur nächsten Ebene.

Verbindungsprobleme

SSH oder grafischer Desktop nicht erreichbar

Beginnen Sie mit Adresse, Port, Schlüsselberechtigungen, Hostschlüssel-Fingerabdruck und Gültigkeit der Zugangsdaten. Wenn SSH funktioniert, die grafische Sitzung aber fehlerhaft ist, prüfen Sie anschließend Auflösung, Sperrstatus und Sitzungswiederherstellung.

Verbindungsprüfung öffnen
Build-Probleme

Xcode-, Signier- oder Pipeline-Fehler

Fixieren Sie zuerst die Xcode-Version und sichern Sie die Original-Logs. Prüfen Sie anschließend Signieridentität, Provisioning-Profil, Schlüsselbundberechtigungen, DerivedData und Arbeitsverzeichnis des Runners.

Build-Prüfung öffnen
Konto und Bestellung

Fragen zu Verlängerung, Abrechnung oder Node-Daten

Prüfen Sie im Control Panel Bestellnummer, Mietzeitraum, Node-ID und Zahlungsstatus. Senden Sie in Tickets weder private Schlüssel noch vollständige Zahlungsdaten.

Control Panel öffnen
Hardware und Netzwerk

Probleme mit Speicher, Bandbreite oder externen Geräten

Notieren Sie freien Speicher, Volume-Bezeichnung, Netzwerkqualität und den Thunderbolt-Gerätebaum. Formatieren Sie Datenträger oder erstellen Sie Volumes nicht ohne vorherige Sicherung neu.

Hardware-Prüfung öffnen
SSH-Schnelldiagnose

Mit lokalen Berechtigungen und dem Handshake beginnen

Ein Verbindungsfehler bedeutet nicht zwangsläufig, dass der Node offline ist. Unterscheiden Sie zunächst zwischen falscher Adresse, nicht erreichbarem Port, unzulässigen lokalen Schlüsselberechtigungen, geändertem Hostschlüssel-Fingerabdruck und einer serverseitig abgelehnten Authentifizierung.

Befehle zur Verbindungsprüfung SSH / VERBOSE
$ chmod 600 ~/.ssh/orbvps_node
$ ssh-keygen -F node-address
$ nc -vz node-address 22
$ ssh -vvv -p 22 \
  -i ~/.ssh/orbvps_node \
  node-user@node-address
Permission denied
Authentifizierungsdaten stimmen nicht überein

Bestätigen Sie, dass Benutzername und privater Schlüssel zum aktuellen Node gehören, und prüfen Sie, ob ein anderes IdentityFile in der lokalen SSH-Konfiguration den Schlüssel überschreibt.

Connection timed out
Verbindung nicht aufgebaut

Prüfen Sie die im Control Panel angezeigte Adresse und den Port, deaktivieren Sie testweise lokale Proxy-Regeln und wiederholen Sie den Test. Notieren Sie Zeitpunkt und verwendetes Netzwerk.

Connection refused
Ziel erreichbar, Port nimmt jedoch keine Verbindungen an

Bewahren Sie die vollständige verbose-Ausgabe auf und löschen Sie Hosteinträge nicht wiederholt. Prüfen Sie zunächst, ob der Port mit den Node-Übergabedaten übereinstimmt.

REMOTE HOST IDENTIFICATION
Hostschlüssel-Fingerabdruck weicht vom lokalen Eintrag ab

Ignorieren Sie die Warnung nicht direkt. Vergleichen Sie zuerst den angezeigten Fingerabdruck mit den Übergabedaten im Control Panel und aktualisieren Sie den lokalen Eintrag erst nach Bestätigung der Node-Daten.

01

Verbindungsparameter prüfen

Lesen Sie Adresse, Port und Benutzernamen erneut aus dem Control Panel aus. Verwenden Sie keine aus dem Verlauf alter Terminals abgeleiteten Adressen.

02

Schlüsselberechtigungen einschränken

Der private Schlüssel sollte für den aktuellen Benutzer les- und schreibbar sein. Auch SSH-Konfiguration und übergeordnete Verzeichnisse dürfen nicht von unbeteiligten Benutzern geändert werden können.

03

Handshake-Ausgabe speichern

Wiederholen Sie den Versuch im verbose-Modus, bewahren Sie die vollständige Ausgabe vom Verbindungsaufbau bis zur Fehlerstelle auf und anonymisieren Sie die Adresse.

Verbindung zum grafischen Desktop

In der Reihenfolge Zugangsdaten, Anzeige, Sperre und Wiederverbindung vorgehen

Grafische Sitzung und SSH sind getrennte Verbindungswege. Eine funktionierende SSH-Verbindung garantiert keine korrekte Konfiguration der grafischen Sitzung; dokumentieren Sie die beiden Fälle daher separat.

01

Zugehörigkeit der Zugangsdaten bestätigen

Verwenden Sie ausschließlich die für den aktuellen Node bereitgestellten Zugangsdaten für die grafische Sitzung. Nach einem Wechsel der Zugangsdaten sollten Sie gespeicherte alte Passwörter im Client löschen, damit keine wiederholten automatischen Anmeldeversuche erfolgen.

02

Auflösung für die erste Verbindung reduzieren

Bei schwarzem Bildschirm oder eingefrorener Anzeige verbinden Sie sich zunächst mit niedrigerer Auflösung und nur einem Monitor. Erhöhen Sie die Auflösung erst nach dem Öffnen des Desktops schrittweise, um einen Zusammenhang mit den Anzeigeparametern zu prüfen.

03

Sitzungssperre prüfen

Wenn der Sperrbildschirm sichtbar ist, Sie aber nicht fortfahren können, prüfen Sie zunächst Tastatureingabe und Fokus. Kontrollieren Sie anschließend per SSH Systemlast und freien Speicher.

04

Sitzung nach Trennung neu aufbauen

Schließen Sie die Clientverbindung aktiv, warten Sie, bis die Sitzung freigegeben wurde, und verbinden Sie sich anschließend erneut. Erstellen Sie nicht schnell hintereinander mehrere parallele grafische Sitzungen, da dies die aktive Desktop-Sitzung unübersichtlich macht.

Bei Supportbedarf zwei Ergebnissätze dokumentieren

Geben Sie an, ob SSH funktioniert, an welchem Schritt der grafische Client stoppt, welche Auflösung verwendet wurde, den originalen Clientfehler und den Zeitraum der letzten erfolgreichen Verbindung. Senden Sie keine vollständigen Zugangspasswörter.

Xcode und Signierung

Toolchain fixieren und den Signierfehler eingrenzen

Bestätigen Sie zuerst den tatsächlich verwendeten Xcode-Pfad und die Version. Prüfen Sie anschließend verfügbare Signieridentitäten, Provisioning-Profile, Schlüsselbundzugriff und Projektcache. Aktualisieren Sie Abhängigkeiten und wechseln Sie Signiermaterial nicht innerhalb derselben Prüfung gleichzeitig.

Toolchain

Xcode und Kommandozeilen-Tools bestätigen

  • Speichern Sie das vollständige Ergebnis von xcodebuild -version .
  • Prüfen Sie mit xcode-select -p das aktuelle Developer-Verzeichnis.
  • Bestätigen Sie, dass Pipeline und interaktives Terminal dieselben Umgebungsvariablen verwenden.
Signiermaterial

Identität und Provisioning-Profil getrennt prüfen

  • Listen Sie die aktuell für die Codesignierung verfügbaren Identitäten und deren Gültigkeitsstatus auf.
  • Prüfen Sie App-ID, Team und Gültigkeitsdauer des Provisioning-Profils.
  • Stellen Sie sicher, dass der Build-Prozess auf den entsprechenden Schlüsselbund zugreifen kann und dieser nicht nur für den aktuellen Desktop-Benutzer sichtbar ist.
Cache und Logs

Reproduzierbare saubere Ausgangsbasis schaffen

  • Speichern Sie zuerst die Fehler-Logs und löschen Sie anschließend die DerivedData des betreffenden Projekts.
  • Führen Sie den Build mit demselben Scheme, derselben Configuration und demselben Destination erneut aus.
  • Archivieren Sie das Original .xcresult und senden Sie nicht nur die letzten Terminalzeilen ein.
Signier- und Versionsprüfung XCODE / CODESIGN
$ xcode-select -p
$ xcodebuild -version
$ security find-identity \
  -v -p codesigning
$ profiles show \
  -type provisioning
$ xcodebuild \
  -workspace App.xcworkspace \
  -scheme App \
  -configuration Release \
  -resultBundlePath Build.xcresult \
  build
Log-Grenzen

Bewahren Sie Befehl, Scheme, Configuration, fehlgeschlagenes Ziel, den ersten Fehler und dessen Kontext auf. Entfernen Sie vor dem Einreichen Repository-Zugangsdaten, Tokens und Geschäftsdaten.

CI/CD-Runner

Feststellen, ob die Aufgabe am Prozess, Verzeichnis oder an Ressourcen hängen bleibt

Ein als online angezeigter selbst gehosteter Runner bedeutet nicht, dass die Aufgabenumgebung vollständig ist. Prüfen Sie Runner-Prozess, Berechtigungen des Arbeitsverzeichnisses, Cache-Auslastung, parallele Aufgaben und den Wiederherstellungspfad nach einem Neustart.

A

Prozessstatus

Bestätigen Sie, dass der Runner-Dienst unter dem erwarteten Benutzer läuft und die Startparameter auf die richtige Konfiguration verweisen. Wenn der Prozess wiederholt beendet wird, sichern Sie zuerst Exit-Code und aktuelle Logs.

ps aux | grep -i runner
B

Arbeitsverzeichnis

Prüfen Sie Eigentümer, freien Speicher und Sperrdateien alter Aufgaben. Löschen Sie kein Arbeitsverzeichnis, das noch von einer laufenden Aufgabe verwendet wird.

df -h && du -sh ./work
C

Cache-Strategie

Unterscheiden Sie Abhängigkeitscache, DerivedData und Build-Artefakte. Ermitteln Sie zuerst den fehlerhaften Cache-Schlüssel und bereinigen Sie nur das betreffende Projekt, statt alle wiederverwendbaren Inhalte zu löschen.

du -sh ~/Library/Developer/Xcode/DerivedData
D

Parallelität und Wiederherstellung

Prüfen Sie, ob mehrere Aufgaben denselben Schlüsselbund, Simulator oder dasselbe Arbeitsverzeichnis verwenden. Starten Sie nach einem Neustart zuerst eine kontrollierte Testaufgabe und setzen Sie erst danach die normale Warteschlange fort.

uptime && sysctl -n hw.memsize
Wiederherstellungsreihenfolge Neue Aufgaben pausieren → Logs speichern → fehlerhafte Prozesse beenden → Verzeichnis prüfen → Runner starten → einzelne Testaufgabe ausführen

Wenn die Testaufgabe erfolgreich ist, parallele Aufgaben jedoch fehlschlagen, geben Sie zusätzlich Parallelitätszahl, Aufgaben-Tags und eine Liste gemeinsam genutzter Ressourcen an.

Netzwerk und Speicher

Verbindungsqualität, Speicherkapazität und Geräteerkennung getrennt prüfen

Sinkender Durchsatz, langsamere Builds und ein verschwundenes externes Volume können ähnlich aussehen. Erfassen Sie zuerst die integrierten Diagnosedaten des Systems und bestimmen Sie anschließend, ob das Problem im Netzwerk, Dateisystem oder Pfad zum externen Gerät liegt.

Netzwerk

Grundlegende Verbindungsqualität prüfen

Verwenden Sie die integrierten Netzwerkqualitätstools, um Upstream, Downstream und Reaktionsfähigkeit zu dokumentieren, und notieren Sie den Testzeitraum. Ergebnisse über Regionen hinweg können durch lokale Anbieter und Routing beeinflusst werden.

networkQuality -v
route -n get default
ifconfig
Interner Speicher

Kapazität und Volume-Status prüfen

Prüfen Sie zunächst den freien Speicher auf System- und Datenvolume und ermitteln Sie anschließend die größten Arbeitsverzeichnisse. Bei Build-Fehlern sollten Sie insbesondere temporäre Verzeichnisse und DerivedData kontrollieren.

df -h
diskutil list
du -sh ~/Library/Developer/*
Externe Geräte

SSD- und Thunderbolt-5-Pfad bestätigen

Prüfen Sie Datenträgerliste und Thunderbolt-Gerätebaum getrennt. Wenn das Gerät sichtbar, das Volume aber nicht eingehängt ist, erfassen Sie zuerst den Status. Löschen oder partitionieren Sie den Datenträger nicht sofort neu.

diskutil list external
system_profiler SPThunderboltDataType
diskutil info /Volumes/VolumeName
Upgrades und Laufzeitänderungen

Zuerst eine Rückfallbasis sichern, dann den Neustart verifizieren

OrbVPS-Nodes laufen 365 Tage im Jahr kontinuierlich. System-Upgrades, Toolchain-Wechsel und erforderliche Neustarts plant der Benutzer passend zur Arbeitslast selbst; notwendige dringende Infrastrukturänderungen werden im Control Panel dokumentiert.

01

Änderungsliste erstellen

Dokumentieren Sie aktuelle macOS-, Xcode- und Runner-Versionen, wichtige Abhängigkeiten sowie rücksetzbare Build-Logs. Überschreiben Sie die Toolchain nicht ohne Ausgangsbasis.

02

Daten sichern

Sichern Sie Repository, Signiermaterial, Runner-Konfiguration, Cache-Strategie und erforderliche Build-Artefakte. Prüfen Sie an einem unabhängigen Speicherort, ob die Sicherung gelesen werden kann.

03

Neustartzeit auf Benutzerseite planen

Pausieren Sie neue Aufgaben, warten Sie das Ende laufender Aufgaben ab und starten Sie erst nach dem Speichern der Logs neu. Ändern Sie während des Neustarts nicht gleichzeitig Netzwerk-, Signier- und Build-Konfiguration.

04

Wiederherstellung verifizieren

Prüfen Sie nacheinander SSH, grafischen Desktop, Datenträger-Mounts, Xcode-Version und eine kontrollierte Build-Aufgabe. Stellen Sie erst danach die normale parallele Warteschlange wieder her.

Problem weiterhin nicht gefunden

Reproduzierbare Belege an das Support-Team übergeben

Geben Sie Node-ID, Zeitraum des Auftretens, betroffene Aufgaben, ausgeführte Befehle, Originalausgaben und bereinigte Screenshots an. Bei bestehender Bestellung erstellen Sie das Ticket im Control Panel. Fragen zu Konfiguration oder Region vor dem Kauf können Sie über die Kontaktseite an support@orbvps.com senden.