Aufgabenorientiertes Support-Handbuch

Vom ersten Login bis zur Build-Analyse: der nächste Schritt nach Aufgabe

DebugMac liefert dedizierte physische Apple-Silicon-Knoten statt virtueller Maschinen. Prüfe zuerst Zugangsdaten, Region und Toolchain und grenze anschließend Verbindungs-, Build-, Speicher- und Netzwerkprobleme anhand von Befehlsausgaben ein.

Cloud-Mac mieten Erste Schritte ansehen
Bereitstellung
Dedizierter Debug-M4-Knoten
Verbindung
SSH und macOS-Oberfläche
Supportkanäle
Support-Tickets und Support-E-Mail im Portal
BREAKPOINT REVIEW DESK Diagnoseauftrag
Schritt für Schritt prüfen
CASE / BUILD-042 Reproduktion ausstehend

Eingaben festlegen, dann die Laufzeitumgebung prüfen

Knoten
JP · Debug M4
Aufgabe
Xcode-Archiv
Zugang
SSH-Schlüssel
Nachweise
Befehle, Zeitstempel, bereinigte Logs
Fehleranalysepfad
  1. 01Host-Fingerabdruck prüfenSicherstellen, dass sich das Verbindungsziel nicht geändert hat
  2. 02Toolchain-Versionen dokumentierenXcode und Abhängigkeitseingaben festhalten
  3. 03Problem eingrenzenLokale Umgebung, Netzwerkpfad und Knotensitzung unterscheiden
EingabeBestellung und Region AusführungReproduktion und Messung ErgebnisPrüfbares Support-Ticket
Support-Index

Sechs Aufgabentypen parallel anzeigen – wichtige Schritte bleiben sichtbar

Wähle eine Kategorie, um das entsprechende Kapitel zu markieren. Die übrigen Leitfäden bleiben sichtbar, damit Bedingungen über mehrere Aufgaben hinweg verglichen werden können.

Erste Verbindung

Zugangsdaten und Host-Fingerabdruck prüfen

Halte Adresse, Benutzername und SSH-Schlüssel bereit, prüfe zuerst den Fingerabdruck und baue anschließend die Shell- und grafische Sitzung auf.

Tägliche Builds

Xcode- und Archivierungseingaben festlegen

Von Repository-Status und Toolchain bis zu Signaturprüfung und Archivexport: Bewahre Versionsinformationen auf, mit denen sich Ergebnisse reproduzieren lassen.

CI-Automatisierung

Runner nachvollziehbar und sauber halten

Begrenze die Parallelität, verwalte Caches und temporäre Verzeichnisse ausdrücklich und übertrage wichtige Build-Ausgaben zurück in die Pipeline.

Speichererweiterung

Kapazität, Einbindung und parallele Laufwerke prüfen

Bestätige Zusatzoptionen vor der Aktivierung und prüfe nach der Bereitstellung Kapazität, Einhängepunkt, Dateisystem und Schreib-/Leseziel.

Netzwerkdiagnose

Lokales Netz, Pfad und Sitzung getrennt prüfen

Grenze die Ursache mit Latenz-, Pfad-, Port- und Übertragungstests schrittweise ein, statt aus einem einzelnen Ping zu schließen.

Kontoverwaltung

Ein ausführbares Support-Ticket erstellen

Füge Bestellkennung, Region, Zeitangaben, Reproduktionsschritte und bereinigte Logs bei, um Rückfragen zu reduzieren.

SSH und grafische Sitzung

Beim ersten Login zuerst das Ziel prüfen und dann eine vertrauenswürdige Basis speichern

Adresse, Benutzername, Host-Fingerabdruck und Freigabestatus aus der Bereitstellungsbestätigung müssen zur selben Bestellung gehören. Stimmen Angaben nicht überein, stoppe die Verbindung und prüfe sie über ein Support-Ticket im Portal.

Vorbereitung der Verbindung

Halte privaten SSH-Schlüssel, Zuordnung zum öffentlichen Schlüssel, Bereitstellungsbestätigung und eine stabile Netzwerkverbindung bereit. Füge keine privaten Schlüssel, vollständigen Zugangsdaten oder unbereinigten Konfigurationen in Tickets ein.

  • Prüfe, dass der lokale private Schlüssel nur vom aktuellen Benutzer gelesen werden kann.
  • Bestätige, dass die Bestellregion Singapur, Japan (Tokio), Südkorea (Seoul), Hongkong oder der Westen der USA ist.
  • Prüfe den Host-Fingerabdruck in der Bestätigung unabhängig vor der ersten Verbindung.
  • Notiere Zeitpunkt der ersten erfolgreichen Verbindung, Systemversion und Standardkapazität des Laufwerks.
Vollständige Einführung ansehen
  1. 01 Zugangsdaten vorbereiten

    Lies Hostadresse, Benutzernamen und Fingerabdruck aus der Bereitstellungsbestätigung. Bewahre den privaten Schlüssel an einem geschützten lokalen Pfad auf und übertrage ihn nicht per Chat oder Ticket.

  2. 02 Fingerabdruck verifizieren

    Der bei der ersten SSH-Verbindung angezeigte Fingerabdruck muss mit der Bestätigung übereinstimmen. Ändert er sich nach einer früheren Verbindung plötzlich, lösche lokale Einträge nicht einfach und versuche es erneut.

  3. 03 Schlüssel-Login testen

    Führe zunächst schreibgeschützte Befehle aus, um Identität, Apple-Silicon-Architektur, Systemzeit und verfügbaren Speicher zu prüfen, bevor du in ein Repository oder Build-Verzeichnis wechselst.

  4. 04 Grafische Sitzung starten

    Prüfe Zugangsdaten der grafischen Sitzung, Bildschirmauflösung und Tastaturbelegung. Teste nach dem ersten Login einmal sicheres Trennen und erneutes Verbinden.

  5. 05 Verbindungsabbrüche behandeln

    Unterscheide zuerst lokale Netzwerkausfälle, nicht erreichbare SSH-Ports und Abbrüche der grafischen Sitzung. Ist die Shell noch verfügbar, sichere zuerst Logs und Aufgabenstatus.

Bei Verbindungsfehlern zuerst drei Nachweise sichern

Notiere lokale Uhrzeit, vollständigen Fehlertext und das Ergebnis der Portprüfung aus demselben Netzwerk. Setze Zugangsdaten nicht wiederholt zurück, da dies den Fehlerzustand überschreiben kann.

Xcode-Workflow

Repository, Toolchain und Archivparameter gemeinsam festlegen

Derselbe Commit kann mit anderem Xcode, einer anderen Abhängigkeitssperrdatei oder anderen Signierungseingaben zu abweichenden Ergebnissen führen. Fixiere bei der Analyse zuerst die Eingaben und aktualisiere nicht mehrere Abhängigkeiten gleichzeitig.

01

Repository abrufen

Dokumentiere Commit-Hash, Branch, Submodulstatus und Sperrdateien der Abhängigkeiten. Starte den Basis-Build erst, wenn der Arbeitsbereich keine nicht committeten Änderungen enthält.

02

Toolchain auswählen

Verwende xcode-select -p und xcodebuild -version um Entwicklerverzeichnis und Xcode-Version zu dokumentieren.

03

Signierungseingaben prüfen

Prüfe Team, Bundle-ID, Konfigurationsnamen und Signiermodus des Projekts. Bereinige Logdaten, bevor Zertifikatsdetails weitergegeben werden.

04

Archiv erstellen

Gib workspace oder project, scheme, configuration und archivePath ausdrücklich an und speichere vollständigen Exit-Code sowie Log.

05

Artefakte herunterladen

Prüfe nach Abschluss des Archivs Dateigröße, Prüfsumme und Exportverzeichnis und kopiere die Artefakte anschließend an den vereinbarten sicheren Speicherort.

Befehl für den Build-Basischeck Sensible Werte durch Beispielplatzhalter ersetzen 
git rev-parse HEAD
xcode-select -p
xcodebuild -version
xcodebuild -workspace "<WORKSPACE>" \
  -scheme "<SCHEME>" \
  -configuration Release \
  -archivePath "<OUTPUT>/App.xcarchive" \
  archive | tee "<LOG_DIR>/archive.log"

Erfolgreiche Abnahme

Der Exit-Code ist 0, das Archivverzeichnis existiert, die Artefaktgröße entspricht der Erwartung und die Logs enthalten keine übergangenen Signier- oder Skriptfehler.

Fehler weiterleiten

Prüfe nacheinander Abhängigkeitsauflösung, Kompilierung, Linking, Signierung, Skriptphase und Export. Fasse nicht jedes Problem als „Xcode-Build fehlgeschlagen“ zusammen.

Nachweise einreichen

Gib Commit-Hash, Xcode-Version, ausgeführten Befehl, Exit-Code, Fehlerphase und bereinigte Logauszüge an. Lade keine privaten Schlüssel oder vollständigen Zugangsdaten hoch.

CI/CD-Automatisierung

Jede Ausführung des self-hosted Runners klar abgrenzen

Pipelines von GitHub, GitLab und anderen Plattformen können macOS-Aufgaben an dedizierte Knoten weiterleiten. Die Laufzeitumgebung wird nicht mit anderen Kunden geteilt; Parallelität, Caches und Bereinigung müssen innerhalb des Teams dennoch verwaltet werden.

Parallelität

Mit einem Einzelaufgaben-Baseline starten

Prüfe zuerst eine Pipeline vollständig und erhöhe die Parallelität dann schrittweise. Gleichzeitige Builds in denselben DerivedData-, Schlüsselbund- oder Ausgabeverzeichnissen können sich gegenseitig verunreinigen.

  • Verwende für jede Aufgabe ein eigenes Arbeitsverzeichnis.
  • Füge Simulator- und Archivpfaden eine Aufgabenkennung hinzu.
  • Dokumentiere CPU-, Speicher- und Festplattenmaxima sowie Wartezeit.
Cache

Jeder Cache braucht einen prüfbaren Schlüssel

Der Cache-Schlüssel für Abhängigkeiten sollte mindestens die Zusammenfassung der Sperrdatei, Toolchain-Version und Architektur enthalten. Prüfe die Integrität der Abhängigkeiten auch nach einem Cache-Treffer und behandle einen alten Cache nicht als korrektes Ergebnis.

  • Verwalte Abhängigkeits-Caches und Build-Zwischenprodukte getrennt.
  • Erzeuge nach einem Toolchain-Wechsel aktiv einen neuen Cache-Schlüssel.
  • Dokumentiere Treffer, Fallbacks und Zeitaufwand für den Neuaufbau.
Bereinigung

Temporären Status am Aufgabenende zurücksetzen

Führe unabhängig vom Ergebnis eine Bereinigungsphase aus. Bewahre zu übertragende Logs und Artefakte auf und lösche temporäre Schlüssel, Arbeitsverzeichnisse sowie nicht mehr benötigte Simulatorzustände.

  • Verwende für die Bereinigung finally oder einen gleichwertigen Mechanismus.
  • Archiviere Fehler-Logs, bevor du das Arbeitsverzeichnis löschst.
  • Prüfe regelmäßig Festplattenbelegung und veraltete Caches.
  1. 01 Runner registrieren

    Binde den Runner mit kurzlebigen, vom Team kontrollierten Registrierungsdaten an. Die Labels sollten Apple Silicon, Region und vorgesehenen Workflow eindeutig angeben.

  2. 02 Basisaufgabe erstellen

    Führe nur Umgebungsprüfung und Minimal-Build aus und bestätige Repository-Berechtigungen, Xcode-Pfad, Abhängigkeitsdownload und Artefaktübertragung.

  3. 03 Cache hinzufügen

    Miss zuerst die Zeit ohne Cache und erstelle den Cache-Schlüssel anschließend anhand von Sperrdatei und Toolchain, damit seine Wirksamkeit überprüfbar bleibt.

  4. 04 Bereinigung verifizieren

    Erzeuge absichtlich einen Fehler und prüfe, dass Logs weiterhin übertragen, temporäre Daten widerrufen und Zustände nicht an Folgeaufgaben vererbt werden.

Speicher und Thunderbolt 5

Zusatzoptionen in der Bestellung bestätigen, danach Kapazität und Verbindung prüfen

Die Basiskonfiguration ist Debug M4: M4, 16 GB RAM, 256 GB SSD. +1TB SSD, +2TB SSD und Thunderbolt-5-Parallelschaltung sind separate Zusatzoptionen; der Bestellumfang darf nicht aus der Systemanzeige abgeleitet werden.

Zusätzlicher Speicher

+1TB SSD

Nach Bestellung abgerechnet
Pro Tag$2.3
Pro Woche$6.1
Pro Monat$11.3
Pro Quartal$30.7

Bestätige vor der Aktivierung Workflow, erwartete Spitzenlast und Datenmigration. Prüfe nach der Bereitstellung Gesamtkapazität, Volume-Name, Dateisystem und Einhängepfad.

Zusätzlicher Speicher

+2TB SSD

Nach Bestellung abgerechnet
Pro Tag$4.6
Pro Woche$12.2
Pro Monat$22.6
Pro Quartal$61.4

Geeignet für Aufgaben mit vielen Archiven, Medienressourcen oder Modelldateien. Maßgeblich für die Abnahme sind weiterhin Systeminformationen zum Laufwerk und das tatsächliche Einhängeergebnis.

Pro Gerät abgerechnet

Thunderbolt-5-Parallelschaltung

Pro Gerät separat berechnet
Pro Tag$1.7
Pro Woche$4.6
Pro Monat$8.5
Pro Quartal$23.1

Gib vor der Bestellung Anzahl der parallelen Geräte, Aufgabenverteilung und Speicherort der zusammengeführten Artefakte an. Diese Option wird pro Gerät berechnet; der Preis eines Geräts lässt sich nicht auf die gesamte Gruppe übertragen.

  1. 01 Bestellung prüfen

    Bestätige Name und Anzahl der Zusatzoption, Laufzeit und USD-Betrag. Verfügbarkeit und Abrechnungsportal ergeben sich in Echtzeit aus dem Portal.

  2. 02 System prüfen

    Verwende diskutil list und df -h um Laufwerke, Volumes und freien Speicher zu dokumentieren, statt nur auf Desktopsymbole zu achten.

  3. 03 Schreib- und Lesetest durchführen

    Führe im Zielarbeitsverzeichnis einen kleinen Schreib-/Lesetest aus und prüfe Berechtigungen, Pfad und tatsächlichen Artefaktstandort. Ein einzelner Extremtest repräsentiert keine Langzeitleistung.

  4. 04 Zuordnung dokumentieren

    Dokumentiere bei mehreren Laufwerken oder Geräten die Zuordnung „Aufgabe – Volume – Artefaktverzeichnis“, damit Bereinigungen benötigte Daten nicht löschen.

Handbuch zur Netzwerkdiagnose

Vier Testgruppen unterscheiden lokales Netz, regionsübergreifenden Pfad und Knotensitzung

Eine einzelne Latenzmessung oder ein einzelner Abbruch beweist nicht die Ursache. Wiederhole Messungen im selben Netzwerk und zu ähnlichen Zeiten und bewahre Befehle, Ziel, Zeitpunkt und Originalausgabe auf.

Netzwerkdiagnose: Befehle, Beobachtungen und Abgrenzung
Test Beispielbefehl Worauf achten Was lässt sich unterscheiden
Basislatenz ping -c 20 <HOST> Paketverlust, Schwankungen, Position aufeinanderfolgender Timeouts Lokale Zugangsprobleme und anhaltende Pfadprobleme
Pfadverfolgung traceroute <HOST> Pfadänderungen, auffällige Hops, anhaltende Timeouts Lokaler Ausgang, regionsübergreifender Pfad und Verbindung nahe am Ziel
Portprüfung nc -vz <HOST> 22 Verbindung erfolgreich, abgelehnt oder Timeout Host erreichbar, SSH-Port jedoch nicht erreichbar
Übertragungstest scp <FILE> <USER>@<HOST>:<PATH> Durchsatz, Wiederholungen, Dateiprüfsumme Interaktive Latenz und Probleme bei großen Dateien
Sitzungsprüfung ssh -vv <USER>@<HOST> Auflösung, Handshake, Schlüsselauswahl, Authentifizierungsphase Probleme mit Netzwerk, Fingerabdruck, Schlüssel und Benutzerkonfiguration

Lokales Netzwerkproblem

Der Zugriff auf mehrere Ziele ist vom selben Gerät aus gestört, funktioniert nach Wechsel in ein kontrolliertes Netzwerk wieder oder zeigt bereits in den ersten Hops des lokalen Ausgangs anhaltenden Paketverlust. Gib beim Einreichen Netzwerktyp und Ergebnis der Wiederholungsmessung an.

Regionsübergreifendes Pfadproblem

Der lokale Zugang ist normal, aber ein bestimmter Pfad schwankt anhaltend. Liefere mehrere Pfadverfolgungen und setze eine nicht reagierende Zwischenstation nicht direkt mit echtem Paketverlust gleich.

Problem mit der Knotensitzung

Host und Port sind erreichbar, aber Authentifizierung, Shell oder grafische Sitzung schlagen fehl. Sichere jetzt vor allem die ausführliche SSH-Ausgabe, Sitzungsfehler und die letzten Aktionen.

Messgrundlage

Netzwerkergebnisse hängen von lokalem Anbieter, Zugangsart, regionsübergreifendem Pfad und Messzeit ab und dienen nur der Eingrenzung, nicht als Leistungszusage. Alle Knoten laufen 365 Tage im Jahr normal; die Verfügbarkeit wird anhand tatsächlicher Servicedaten geprüft.

Checkliste für Support-Tickets

Supportanfragen als reproduzierbare Übergabe aufbereiten

Probleme mit laufenden Knoten bitte bevorzugt über das Portal als Ticket einreichen. Vor dem Kauf oder bei fehlendem Login kannst du eine E-Mail an support@debugmac.com senden; beide Kanäle verwenden dieselbe Informationscheckliste.

  1. 01 Bestellkennung

    Gib die im Portal angezeigte Bestellkennung und das Modell Debug M4 an. Sende keine Zahlungsnachweise, privaten Schlüssel oder vollständigen Zugangspasswörter.

  2. 02 Knotenregion

    Nenne Singapur, Japan (Tokio), Südkorea (Seoul), Hongkong oder den Westen der USA und gib an, ob das Problem nur in dieser Region auftritt.

  3. 03 Zeitpunkt des Auftretens

    Nenne den ersten Zeitpunkt mit Zeitzone, die letzte Reproduktion und die Dauer. Schreibe nicht nur „gerade eben“ oder „gelegentlich“.

  4. 04 Reproduktionsschritte

    Ordne Eingaben, ausgeführte Befehle, erwartetes Ergebnis und tatsächliches Ergebnis. Wenn die Reproduktion nicht stabil gelingt, nenne Häufigkeit und beobachtete gemeinsame Bedingungen.

  5. 05 Bereinigte Logs

    Bewahre Zeitstempel, Exit-Code und Fehlerkontext auf; entferne Schlüssel, Tokens, Passwörter, interne Repository-Adressen und andere sensible Werte.

  6. 06 Bereits durchgeführte Prüfungen

    Liste ausgeführte Befehle, Wiederholungsversuche, Netzwerkwechsel und Ergebnisse auf, damit der Support dieselben Basisprüfungen nicht erneut anfordern muss.

Laufende Knoten und Konto

Über das Portal ein Ticket einreichen

Tickets können mit Bestellung, Knoten und bisheriger Bearbeitung verknüpft werden und eignen sich für Verbindungs-, Build-, Speicher-, Abrechnungs- und Kontozugangsprobleme.

Portal öffnen
Vor dem Kauf oder ohne Login

Strukturierte Support-E-Mail senden

Nenne im Betreff Aufgabentyp und Knotenregion und strukturiere den Text nach der Checkliste dieses Leitfadens. Die einzige Support-E-Mail lautet support@debugmac.com.

Support-E-Mail senden
Bereit zum Start

Du brauchst einen Cloud-Mac mit prüfbarer Konfiguration?

Wähle Debug M4, Laufzeit und Knoten in fünf Regionen. Prüfe vor dem Absenden erneut Basiskonfiguration, Zusatzoptionen, Region und fälligen USD-Betrag. Die tatsächliche Verfügbarkeit zeigt das Portal in Echtzeit.

Cloud-Mac mieten Konfiguration und Preise ansehen