Vom Fehlerbild zur Lösung
Gib eine Fehlermeldung, ein Tool oder eine Verbindungsart ein. Statt allgemeiner Erklärungen listet diese Seite Gerätestatus, Logspeicherorte, Prüfkommandos und die für den Support benötigten Angaben in der richtigen Reihenfolge auf.
Schnelle Weiterleitung
Wähle zuerst das ähnlichste Fehlerbild und prüfe anschließend in der angegebenen Reihenfolge. Installiere Xcode, Abhängigkeiten oder Runner nicht neu, bevor Netzwerk- und Speicherstatus bestätigt sind.
Erstverbindung
Verbindungsprobleme liegen meist in Status, Zugangsdaten, Netzwerk oder Client-Konfiguration. Die Reihenfolge verhindert, dass ein Netzwerkfehler als Gerätefehler beurteilt wird.
Melde dich zunächst in der Konsole an und prüfe, ob die Instanz verfügbar ist. Vergleiche Gerätenamen und Knoten mit der Bestellung. Ist das Gerät verfügbar, schlagen aber beide Verbindungsarten fehl, prüfe das Netzwerk – ändere nicht zuerst die Systemkonfiguration.
Unterscheide Systembenutzername, Anfangspasswort und SSH-Schlüssel. Prüfe beim Kopieren Leerzeichen am Anfang und Ende. Bei fehlgeschlagener Schlüssel-Authentifizierung zuerst privaten Schlüssel und Benutzernamen bestätigen, statt fortlaufend Kombinationen zu testen.
Teste über ein anderes vertrauenswürdiges Netzwerk und schließe vorübergehend Unternehmensproxy, VPN, Ausgangsfirewall und Sicherheitssoftware-Regeln aus. Notiere Zieladresse, Port, Zeitpunkt und Timeout-Text.
Prüfe, ob gespeicherte Adresse, Benutzername und Anzeigeeinstellungen zum aktuellen Gerät gehören. Öffnet sich das Bild, reagiert aber verzögert, reduziere zunächst Auflösung und Farbqualität und prüfe dann Netzwerkschwankungen.
Nutze die ausführliche Ausgabe, um festzustellen, ob der Fehler bei Auflösung, Handshake oder Authentifizierung auftritt. Bei erfolgreichem Handshake, aber fehlgeschlagener Authentifizierung, prüfe Benutzername, privaten Schlüssel und Autorisierungsdatei. Bei direktem Timeout zum Netzwerkpfad zurückkehren.
ssh -vvv user@host
chmod 600 ~/.ssh/id_ed25519
ssh-add -lÜbermittle im Supportfall keine Passwörter, privaten Schlüssel, Wiederherstellungscodes, vollständigen Zahlungsdaten oder unbereinigten Zertifikate. Bei Konfigurationsauszügen nur fehlerrelevante Felder beibehalten.
Xcode und Signierung
Prüfe nicht alle Schritte mit einem vollständigen Release-Job. Zuerst Toolchain-Version bestätigen, dann die Signierung mit einem Testprojekt prüfen und zuletzt die Archiv-Logs des echten Projekts auswerten.
Prüfe, ob ausgewählte GUI-Version, Kommandozeilenpfad und Projektanforderungen übereinstimmen. Öffne Terminal und Build-Prozess nach einem Versionswechsel neu.
xcode-select -p
Prüfe, ob benötigtes Zertifikat und privater Schlüssel vollständig importiert und in der aktuellen Sitzung zugänglich sind. Der Zertifikatsname allein bestätigt keinen erfolgreichen Import.
security find-identity -v -p codesigning
Anwendungs-ID, Team, Capabilities und Gültigkeitsbereich prüfen. Vor dem Löschen alter Profile eine Liste sichern.
~/Library/MobileDevice/Provisioning Profiles
Kann die GUI archivieren, CI jedoch nicht, prüfe die vom Runner verwendete Keychain, den Entsperrvorgang und die Zugriffskontrolle.
security list-keychains
Ermittle im Archiv-Log den frühesten Fehler statt nur die Zusammenfassung zu kopieren. Notiere Ziel, Konfiguration, SDK und ausgeführtes Kommando.
xcodebuild -showBuildSettings
CI/CD-Fehlerhandbuch
CI-Fehler müssen in Scheduling, Ausführungsumgebung, Ressourcen und Skript zerlegt werden. Wiederholtes Ausführen überschreibt nur Logs und beweist keine Wiederherstellung.
| Fehlerbild | Zuerst prüfen | Reihenfolge | Wiederherstellungskriterium |
|---|---|---|---|
| Runner offline | Prozess, Netzwerk, Registrierung, Ausführungsbenutzer | Erreichbarkeit bestätigen, dann Servicelog lesen; Registrierungsbereich und Startbenutzer prüfen, nicht zuerst neu registrieren. | Runner bleibt online und übernimmt erfolgreich einen minimalen Testjob. |
| Job bleibt lange in der Warteschlange | Labels, Parallelitätslimit, vorhandene Jobs | Prüfen, ob Job-Labels zum Runner passen und ob laufende Prozesse oder belegte Slots existieren. | Neue Jobs werden in der erwarteten Warteschlange übernommen; Status alter Jobs ist eindeutig. |
| Cache-Wiederherstellung fehlgeschlagen | Cache-Schlüssel, Verzeichnisrechte, freier Speicher | Cache-Schlüssel erfolgreicher und fehlgeschlagener Jobs vergleichen; Eigentümer prüfen, dann rekonstruierbaren Cache löschen. | Abhängigkeiten werden wiederhergestellt und der nächste Job nutzt dieselben Cache-Regeln. |
| Skriptberechtigungsfehler | Ausführungsbit, Interpreter, Arbeitsverzeichnis | Prüfen, ob das Skript im Repository liegt und das Ausführungsbit besitzt; Interpreter in der ersten Zeile und relative Pfade kontrollieren. | Skript läuft in einer nichtinteraktiven Sitzung des Runner-Benutzers erfolgreich. |
| Build-Timeout | Letzte aktive Phase, CPU, Arbeitsspeicher, Speicher | Letztes gültiges Log suchen und dann Prozessblockade, Ressourcenmangel oder Warten auf Netzwerkabhängigkeit unterscheiden. | Gleicher Commit wird fortlaufend abgeschlossen, Dauer liegt nahe der Baseline und keine Prozesse bleiben zurück. |
Der Healthcheck prüft nur Arbeitsverzeichnis, Speicher, Toolchain-Pfade und einen kurzen Test. Er darf keine Release-Zugangsdaten enthalten und nicht von großem Cache abhängen.
whoami
pwd
df -h
xcodebuild -version
git --versionLeistung und Speicher
Ein einzelner langsamer Job rechtfertigt keine größere Konfiguration. Prüfe Aktivitätsanzeige, Speicherplatz und Build-Log gemeinsam und vergleiche mit der normalen Baseline desselben Projekts.
Beobachte den gesamten Job, nicht nur eine Sekunde. Dauerhaft volle CPU bei fortschreitendem Job bedeutet Rechenlast; steigender Speicherdruck mit starkem Swapping weist auf zu hohe Parallelität oder Projektgröße hin.
Erfasse zuerst den Verbrauch von Projekt, Abhängigkeiten, Simulatoren, Archiven und rekonstruierbarem Cache. Nahe der Speichergrenze können Entpacken, Archivierung und Logschreiben fehlschlagen. Vor dem Löschen Artefakte von rekonstruierbaren Daten unterscheiden.
Sind Ressourcen unauffällig, der Job aber in demselben Skript, Abhängigkeitsdownload oder Kompilierungsschritt blockiert, prüfe Versionsänderungen, Netzwerkabhängigkeiten und Wartebedingungen. Erfolgslogs zeigen Abweichungen schneller als die Gesamtdauer.
Parallelität reduzieren und erneut testen; ändert sich die Dauer stabil mit der Parallelität, größere Konfiguration prüfen.
Rekonstruierbaren Cache und alte Artefakte löschen und eine Bereinigungsregel nach jedem Job einrichten.
Skripte, Abhängigkeitsquellen, Toolchain-Version und nichtinteraktive Berechtigungen prüfen.
Knoten und Netzwerk
NUMACS bietet Knoten in Singapur, Japan (Tokio), Korea (Seoul) und Hongkong. Alle Verzeichniskombinationen können bestellt werden; maßgeblich ist der live von der Konsole gemeldete Status.
Geeignet für Zugriffe aus Südostasien und angrenzenden Regionen. Notiere bei der Diagnose lokalen Anbieter, Zieladresse, Verbindungsart und Zeitpunkt.
Singapur-Knoten auswählenTeste bei Verbindungsproblemen Remote-Desktop und SSH getrennt und vermerke, ob das Problem nur in einem bestimmten lokalen Netzwerk auftritt.
Japan-Knoten auswählenFüge bei Netzwerkproblemen Zeitraum von Timeout oder Verbindungsabbruch sowie den Test desselben Geräts über ein anderes Netzwerk bei.
Korea-Knoten auswählenÄndert sich die interaktive Latenz plötzlich, notiere Zieladresse, Protokoll, Client-Version und den gerade laufenden Job.
Hongkong-Knoten auswählenGib Zeitpunkt und Zeitzone, Knoten, Zieladresse, Protokoll, lokalen Netzwerktyp, vollständigen Fehlertext und das Ergebnis nach einem Netzwerkwechsel an. Übermittle Diagnoseausgaben bereinigt und nicht nur einzelne Zahlen aus einem Screenshot.
Abrechnung und Zeiträume
Geräte sind tage-, wochen-, monats- oder quartalsweise mietbar. Der Bestellbetrag wird einheitlich in US-Dollar (USD) abgerechnet; Zeitraum und Konfiguration ergeben sich aus der Bestellung.
Geeignet für kurzfristige Tests, temporäre Builds oder Migrationen. Bei Abrechnungsfragen Bestellbeginn und Geräte-ID angeben.
Geeignet für einen zusammenhängenden Sprint oder eine Versionsabnahme. Kalenderwoche und tatsächlichen Bestellzeitraum nicht verwechseln.
Geeignet für stabile Entwicklung und CI-Workflows. Vor einer Konfigurationsänderung erforderliche Daten exportieren und Migration abstimmen.
Geeignet für laufende Projekte und feste Runner. Das Team sollte Schlüsselrotation, Backups und Jobübergaben frühzeitig dokumentieren.
Vor dem Absenden prüfen
Diese Angaben ermöglichen dem Support, direkt mit Reproduktion und Eingrenzung zu beginnen, statt zunächst Basisinformationen nachzufordern.
Zuerst Gerätestatus in der Konsole bestätigen und dann Bestellnummer, Knoten, Zeitpunkt und Zeitzone, Zieladresse, vollständige Fehlertexte beider Verbindungsarten sowie den Test nach einem Netzwerkwechsel einreichen. Keine Passwörter oder privaten Schlüssel übermitteln.
Nein. Sichere zuerst den ersten Ursachfehler, Xcode-Version, Kommandozeilenpfad, Projektkonfiguration und letzte Änderungen. Eine Neuinstallation verändert den Zustand und kann relevante Versionsunterschiede und Logs entfernen.
Prüfe zuerst Geräteverbindung, Runner-Prozess, Ausführungsbenutzer und Servicelogs. Nur bei beschädigten oder ungültigen Registrierungsdaten neu registrieren. Sonst erschweren alte und neue Einträge die Beurteilung des Schedulings.
Behalte Zeit, Kommandos, Fehlercodes, Tool-Versionen und fehlerrelevante Pfadstrukturen; ersetze Benutzernamen, Repository-Adressen, Zugriffstoken, Zertifikatsinhalte, private Schlüssel und Geschäftsdaten. Lies die bereinigte Fassung erneut und prüfe den Reproduktionskontext.
Kennzeichne im Betreff den Build-Fehler und nenne Bestellnummer, Knoten, Zeitpunkt, reproduzierbare Schritte, erwartetes und tatsächliches Ergebnis sowie bereinigte Logs. Die Bearbeitung erfolgt nach Vollständigkeit; vollständiger Kontext reduziert Rückfragen.
An den Mitarbeitersupport eskalieren
Bereite Bestellnummer, Knoten, Zeitpunkt und Zeitzone, Reproduktionsschritte, erwartetes und tatsächliches Ergebnis, bereits getestete Maßnahmen und bereinigte Logs vor. Bestehende Bestellungen können über die Konsole als Ticket eingereicht werden; Fragen zu Auswahl, Knoten und Abrechnung an support@numacs.com senden.