Cloud-Mac-Hilfezentrum und Leitfaden zur Fehlerbehebung

Nach Problemtyp starten

Erst den Bereich wählen, dann den kürzesten Prüfpfad ausführen

Die fünf Einstiege decken unterschiedliche Phasen des Bestellzyklus ab. Beim Wechsel der Kategorie werden die zuerst zu prüfenden Informationen, häufige Ursachen und die nächsten Schritte angezeigt.

Bestellzyklus

Bestellung und Bereitstellung

Geeignet für ungeklärte Zahlungsergebnisse, noch nicht angezeigte Knotendaten, die Prüfung von Region oder Modell sowie die Bestätigung der Daten für die erste Verbindung.

Prüfen Sie, ob Bestellnummer, Modell, Mietdauer und Region in der Konsole mit den Angaben Ihrer Bestellung übereinstimmen.
Nach der Zahlungsbestätigung führt das System nacheinander Knotenzuweisung, Zustandsprüfung und Erstellung der Verbindungsdaten aus. Der typische Ablauf dauert etwa 4 Minuten.
Wenn nach der typischen Zeit noch keine Verbindungsdaten vorliegen, erstellen Sie keine weitere Bestellung. Notieren Sie die Bestellnummer und senden Sie ein Ticket.

Schnelldiagnose

Erste Prüfung der fünf häufigsten Fehler

Jede Karte folgt der Reihenfolge „Status bestätigen, Variablen eingrenzen, Belege sichern“. Ändern Sie immer nur eine Variable, damit erkennbar bleibt, welcher Schritt den Dienst wiederhergestellt hat.

Verbindung zum Knoten nicht möglich

Bestätigen Sie in der Konsole, dass der Knoten ordnungsgemäß läuft.
Prüfen Sie Adresse, Port, Benutzernamen und Verbindungsprotokoll einzeln.
Testen Sie denselben Port aus einem anderen Netzwerk, um lokale Ausgangs- oder Firewall-Beschränkungen auszuschließen.
Notieren Sie den genauen Clientfehler und den Zeitpunkt. Probieren Sie nicht fortlaufend zahlreiche Passwörter aus.

Leitfaden für den Fernzugriff

Build schlägt plötzlich fehl

Notieren Sie fehlgeschlagenen Lauf, Build-Befehl, Exit-Code und den ersten aussagekräftigen Fehler.
Führen Sie xcodebuild -version aus, um die aktuelle Toolchain zu bestätigen.
Prüfen Sie, ob sich Lock-Dateien, Umgebungsvariablen oder Signierungsressourcen geändert haben.
Löschen Sie einen Cache nur nach bestätigter Cache-Anomalie und vermeiden Sie es, zunächst alle Belege zu entfernen.

Xcode-Prüfung öffnen

Nicht genügend Speicherplatz

Verwenden Sie df -h um die Volume-Kapazität zu prüfen, statt nur ein einzelnes Verzeichnis anzusehen.
Prüfen Sie DerivedData, Archive, Simulator-Daten und Caches der Paketmanager.
Löschen Sie zuerst wiederherstellbare Inhalte und kümmern Sie sich danach um Build-Artefakte und Projektdateien.
Verzeichnisse mit stetigem Wachstum sollten in die Bereinigungsregeln der Pipeline aufgenommen und überwacht werden.

Sichere Reihenfolge beim Bereinigen

Zugangsdaten ungültig

Unterscheiden Sie zwischen ungültigem System-Login, SSH-Schlüssel, Repository-Token und Signierungsberechtigung.
Prüfen Sie Gültigkeitsdauer, Dateiberechtigungen und die Identität des Benutzers, der die Zugangsdaten verwendet.
Aktualisieren Sie nach dem Wechsel der Zugangsdaten die Pipeline-Variablen und widerrufen Sie die alten Werte.
Fügen Sie vollständige Zugangsdaten weder in Befehlsverläufe noch in Screenshots oder Tickettexte ein.

Sicherheit und Berechtigungen anzeigen

Netzwerkverzögerung oder Jitter

Notieren Sie lokale Stadt, Provider, Knotenregion und Zeitpunkt des Problems.
Testen Sie mehrfach und verwenden Sie den Median; ziehen Sie keine Schlussfolgerung aus einem einzelnen Spitzenwert.
Prüfen Sie interaktive Latenz, Paketverlust und Durchsatz bei der Übertragung großer Dateien getrennt.
Deaktivieren Sie nicht benötigte Audio-/Videofunktionen und hohe Farbqualität und vergleichen Sie anschließend das VNC-Erlebnis.

Verbindungsoptimierung anzeigen

Zentrale Begriffe

Knoten-, Verbindungs- und Build-Kontext verstehen

Die folgenden Definitionen entsprechen der tatsächlichen Bedeutung in diesem Dienst. Verwenden Sie in Tickets einheitliche Begriffe, um wiederholte Rückfragen zum Problemumfang zu vermeiden.

Physischer Knoten: Ein eigenständiges Mac-mini-Gerät, auf dem die Workloads tatsächlich ausgeführt werden. Es verfügt über einen bestimmten Chip, Arbeitsspeicher, Speicher und Standort und ist keine gemeinsam genutzte Recheninstanz.
Exklusiv: Während der Mietdauer sind die Rechenressourcen dieses Knotens der aktuellen Bestellung zugeordnet. Workloads anderer Kunden werden nicht gemeinsam eingeplant; Leistungs- und Umgebungsgrenzen bleiben klar.
VNC: Protokoll für den Fernzugriff auf die grafische macOS-Oberfläche. Geeignet für Desktop-Aktionen, die Xcode-Oberfläche oder Systemeinstellungen.
SSH: Protokoll für verschlüsselte Verbindungen über die Kommandozeile. Geeignet für Skripte, Dateiübertragung, Runner-Verwaltung und die Fehlersuche ohne grafische Oberfläche.
self-hosted runner: Ein von Ihrem Team verwalteter Runner, der an eine Code-Hosting-Pipeline angebunden ist. Aufgaben laufen auf dem festgelegten Cloud-Mac; Toolchain, Cache und Parallelisierung steuert Ihr Team.
Codesignierung: Prozess zur Bestätigung von Herkunft und Berechtigungsumfang einer App mithilfe von Zertifikaten, privaten Schlüsseln und Provisioning-Profilen. Beschränken Sie den Zugriff auf diese Ressourcen, wechseln Sie sie regelmäßig und speichern Sie sie nicht im Repository.
Build-Cache: Daten zur Wiederverwendung von Abhängigkeiten, Zwischenresultaten der Kompilierung oder heruntergeladenen Tools. Sie verkürzen Builds, können bei Fehlern oder Überalterung jedoch Inkonsistenzen verursachen.
Knotenregion: Region des Rechenzentrums, in dem sich der Mac mini befindet. Das aktuelle Angebot umfasst 6 Regionen: Singapur, Japan (Tokio), Südkorea (Seoul), Hongkong, US-Ostküste und US-Westküste.

Bereitstellung und Zugangsdaten

Von der Bestellbestätigung bis zur ersten sicheren Anmeldung

Die typische Bereitstellung dauert etwa 4 Minuten und besteht aus vier aufeinanderfolgenden Schritten. Verfügbarkeit und Verbindungsdaten richten sich nach der Echtzeitanzeige in der Konsole.

01

Bestell- und Zahlungsbestätigung
etwa 1 Minute

Prüfen Sie Modell, Mietdauer, Knotenregion und Zusatzoptionen. Nach Bestätigung der Zahlung wird die Bestellung zugewiesen. Versuchen Sie nicht, den Vorgang durch wiederholte Zahlungen zu beschleunigen.
Zu speichern: Bestellnummer, Zahlungsstatus-ID und Einreichungszeitpunkt.
02

Knotenzuweisung
etwa 1 Minute

Das System weist gemäß Bestellkatalog einen eigenständigen physischen Mac-mini-Knoten zu. Beide Modelle sind in Singapur, Japan (Tokio), Südkorea (Seoul), Hongkong, an der US-Ostküste und an der US-Westküste verfügbar.
Zu prüfen: Knoten-ID, Modell und Region.
03

Knotenzustandsprüfung
etwa 1 Minute

Vor der Bereitstellung werden Systemstart, Netzwerkkonnektivität und Fernzugriffsdienst geprüft. Alle Knoten laufen 365 Tage im Jahr kontinuierlich.
Warten Sie, bis der Konsolenstatus „Verbindung möglich“ anzeigt.
04

Übermittlung der Verbindungsdaten
etwa 1 Minute

Die Konsole stellt Adresse, Port, Benutzernamen und temporäre Zugangsdaten bereit. Aktualisieren Sie das temporäre Passwort sofort nach der ersten Anmeldung, richten Sie einen eigenen SSH-Schlüssel ein und speichern Sie die Zugangsdaten in einem kontrollierten Schlüsselverwaltungs-Tool.
Abzuschließen: erste Anmeldung, Passwortaktualisierung und Prüfung des SSH-Schlüssels.

Umgang mit Zugangsdaten

Übermitteln Sie keine privaten Schlüssel, vollständigen Passwörter oder vollständigen Zugriffstoken in Screenshots, Repositories, Build-Logs oder Tickets. Wenn der Zugangsdaten-Typ erläutert werden muss, nennen Sie nur Zweck, Erstellungszeitpunkt und wenige Zeichen am Ende.

Xcode-Prüfpfad

Von der Versionsbasis zu reproduzierbaren Logs

Löschen Sie nicht sofort alle Caches und installieren Sie die Toolchain nicht neu. Bestätigen Sie zuerst Version und Pfad, prüfen Sie danach die Signierungsressourcen und führen Sie zuletzt eine gezielte Bereinigung durch.

01

Xcode- und macOS-Version bestätigen

Notieren Sie die in der grafischen Oberfläche angezeigte Version und führen Sie die Befehle zusätzlich unter dem Pipeline-Benutzer aus. Wenn der interaktive lokale Build erfolgreich ist, der Runner jedoch scheitert, vergleichen Sie außerdem Benutzer und Umgebungsvariablen.

xcodebuild -version
sw_vers
whoami

02

Auswahl der Kommandozeilentools bestätigen

Verwenden Sie xcode-select -p um das aktuelle Entwicklerverzeichnis zu prüfen. Wenn Ihr Team mehrere Versionen parallel verwaltet, wählen Sie den Pfad beim Start der Pipeline ausdrücklich, damit sich der Systemstandard nicht unerwartet ändert.

xcode-select -p
xcrun --find xcodebuild
xcrun xcodebuild -version

03

Zertifikate und Provisioning-Profile prüfen

Bestätigen Sie, dass das Signierungszertifikat gültig ist, der Build-Benutzer auf den privaten Schlüssel zugreifen kann und das Provisioning-Profil zur Bundle-ID passt. Bei fehlgeschlagener automatischer Signierung bewahren Sie zuerst den Originalfehler auf und prüfen danach Schlüsselbundberechtigungen und Pipeline-Variablen.

security find-identity -v -p codesigning
ls -la ~/Library/MobileDevice/Provisioning\ Profiles

04

DerivedData gezielt bereinigen

Löschen Sie bevorzugt das Verzeichnis des aktuellen Projekts, statt alle Projekt-Caches zu leeren. Notieren Sie vor der Bereinigung Speicherbelegung und Fehler-Logs, um beurteilen zu können, ob der Cache tatsächlich die Ursache war.

du -sh ~/Library/Developer/Xcode/DerivedData
find ~/Library/Developer/Xcode/DerivedData -maxdepth 1 -type d

05

xcodebuild-Logs sammeln

Bewahren Sie vollständigen Befehl, Exit-Code und ersten aussagekräftigen Fehler auf. Entfernen Sie vor dem Einreichen Repository-Token, Signierungsgeheimnisse, Benutzerpfade und interne Adressen, aber nicht einfach alle Zeilen bis auf die letzte.

set -o pipefail
xcodebuild test 2>&1 | tee build.log
printf "exit=%s\n" "$?"

Richtlinien für Supportanfragen

Support-Engineering direkt reproduzieren lassen

Eine vollständige Anfrage bedeutet nicht, alle Daten hochzuladen. Ziel sind eine klare Zeitachse, der betroffene Umfang und bereinigte technische Belege.

Empfohlene Struktur des Tickettexts

Knoten-ID: Kopieren Sie die exakte Kennung aus der Konsole und ersetzen Sie sie nicht durch einen eigenen Gerätenamen.
Zeitpunkt des Auftretens: Geben Sie Datum, Zeitzone, Startzeitpunkt und den letzten Zeitpunkt mit normalem Betrieb an.
Knotenregion: Geben Sie die Region aus der Bestellung an, nicht nur Ihre lokale Stadt.
Betroffener Umfang: Beschreiben Sie, ob ein einzelner Befehl, eine Pipeline, alle Verbindungen oder das gesamte Team betroffen ist.
Reproduktionsschritte: Listen Sie Befehle, Eingaben, erwartete und tatsächliche Ergebnisse in der tatsächlich ausgeführten Reihenfolge auf.
Bereits durchgeführte Prüfungen: Beschreiben Sie jeden Schritt und sein Ergebnis einzeln, statt nur „alles ausprobiert“ zu schreiben.

Regeln zur Log-Bereinigung

Ersetzen Sie Zugriffstoken, Passwörter und Inhalte privater Schlüssel durch eindeutige Bereinigungsmarkierungen.
Die Repository-Adresse darf den Plattformtyp enthalten; entfernen Sie Organisationsname, Projektname und Authentifizierungsparameter.
Ersetzen Sie Benutzerverzeichnisse durch einen allgemeinen Pfad, behalten Sie jedoch die relative Verzeichnisebene bei.
Bei Zertifikatsproblemen können Sie Name, Gültigkeitsdauer und Fehlermeldung angeben, aber keinen privaten Schlüssel übermitteln.
Bei Zahlungsproblemen können Sie Bestellnummer und Status-ID angeben, aber keine vollständigen Zahlungsdaten übermitteln.
Prüfen Sie vor Screenshots Befehlsverlauf, Menüleiste, Dateinamen und Benachrichtigungen.

Nicht hochladen

Private Schlüssel, vollständige Anmeldedaten, vollständige Zugriffstoken, nicht bereinigte Umgebungsvariablen und Konfigurationsdateien mit vertraulichen Parametern.

Wann sollte ich die Selbstprüfung überspringen und sofort ein Ticket einreichen?

Bei verdächtigen Aktivitäten mit Zugangsdaten, unerwarteten Änderungen des Hostschlüssels, deutlichen Abweichungen zwischen Knotenstatus und tatsächlicher Erreichbarkeit oder wenn weitere Aktionen Belege beschädigen könnten, brechen Sie wiederholte Versuche ab und reichen Sie sofort ein Konsolenticket ein.

Warum muss die Zuständigkeit für die Bestellung bei Knotenaktionen geprüft werden?

Das Zurücksetzen des Zugriffs, das Ändern des Knotenstatus oder die Bearbeitung sensibler Konfigurationen kann den exklusiven physischen Knoten beeinflussen. Das Support-Team muss Sitzung, Bestellnummer und Berechtigung prüfen, damit keine unbefugten Personen Knotenaktionen anfordern.

Soll ich bei gleichzeitigem Verbindungs- und Build-Fehler ein oder mehrere Tickets einreichen?

Wenn beide Probleme zur selben Zeit auftraten und möglicherweise durch denselben Knotenstatus verursacht wurden, können Sie Verbindungs- und Build-Belege getrennt in einem Ticket aufführen. Bei unterschiedlichen Zeitpunkten, Knoten oder Zuständigkeitsbereichen reichen Sie separate Tickets ein, damit sie unabhängig verfolgt werden können.

Support eskalieren

Diagnoseergebnisse mitsenden und nachvollziehbare Anfrage einreichen

Reichen Sie Fragen zu bestehenden Bestellungen, Knotenverbindungen, Build-Fehlern und Abrechnung bevorzugt über ein Konsolenticket ein. Vorabprüfungen, Team-Bereitstellungen und Sicherheitsmeldungen können Sie über die Kontaktseite an support@hexvm.com senden. Für Knotenaktionen ist eine Bestellzugehörigkeitsprüfung erforderlich.

Konsolenticket erstellen Kontaktmöglichkeiten ansehen Leitfaden für den Fernzugriff lesen

Cloud-Mac-Hilfezentrum