Technischer Support für Cloud-Macs

Fehlerquelle eingrenzen, nachvollziehbare Informationen bereitstellen

Bei Verbindungsproblemen prüfen Sie zuerst Gerätestatus und Zugangsdaten, bei Build-Fehlern Xcode, Abhängigkeiten und Signierung. CDNMac stellt dedizierte physische Macs bereit, keine virtuellen Maschinen. Projektcode, Entwicklerkonten und Signierungsressourcen verwalten Sie selbst.

Halten Sie bei bestehenden Bestellungen möglichst Bestellnummer, ausgewählten Standort, Zeitpunkt und bereinigte Logs bereit. Maßgeblich sind der aktuelle Gerätestatus und die in der Konsole verfügbaren Aktionen.

6 Themen Verbindung, Build, Signierung, Netzwerk, Abrechnung und Geräte
6 Angaben Alle nötigen Informationen fürs Support-Ticket
Ganzjährig verfügbar Geräte laufen 365 Tage im Jahr
Fehlerbericht Vom Symptom zu klaren Reproduktionsschritten
Mit vollständigen Angaben wird der Fall bearbeitet
01

Fehlerumfang ermitteln

Halten Sie fest, ob ein einzelnes Gerät, ein Repository, ein Build oder alle Verbindungsarten betroffen sind.

Gerätestatus
Aktuellen Status in der Konsole prüfen
Ausgewählter Standort
Region der Bestellung notieren
02

Fehlerquelle eingrenzen

Prüfen Sie Netzwerk, Systemzugriff, Toolchain, Projektabhängigkeiten und Signierung einzeln. Ändern Sie nicht mehrere Einstellungen gleichzeitig.

Minimale Reproduktion
Schritte für eine zuverlässige Reproduktion notieren
Zeitangaben
Erstes und letztes Auftreten festhalten
03

Wichtige Nachweise bereitstellen

Senden Sie bereinigte Logs, das erwartete Ergebnis und bereits getestete Schritte. Übermitteln Sie keine privaten Schlüssel, Tokens, Zertifikatpasswörter oder vollständigen Zahlungsdaten.

Umfang der Logs
Befehle, Phasen und Zeitstempel einbeziehen
Erwartetes Ergebnis
Beschreiben, was im Normalfall passieren sollte
Zuerst Problemtyp auswählen

Sechs Themen, jeweils mit den nötigen Angaben

Ordnen Sie das Problem nach dem Hauptsymptom ein und halten Sie die passenden Informationen bereit. Beschränken Sie jede Anfrage auf ein Hauptproblem; weitere Symptome können Sie in den Reproduktionsschritten ergänzen.

Keine Verbindung

Gerät nicht erreichbar oder Zugangsdaten ungültig?

Notieren Sie den Gerätestatus in der Konsole, die genaue SSH- oder VNC-Fehlermeldung, Ihr lokales Netzwerk, den Zeitpunkt des ersten Auftretens und ob nur eine Verbindungsart betroffen ist.

Bereithalten: Gerät, Netzwerk, Fehlermeldung, Zeitpunkt
Build fehlgeschlagen

Fehlerhafte Build-Phase ermitteln

Geben Sie die Versionen von Xcode und Command Line Tools, die verwendete Lockdatei, den fehlgeschlagenen Befehl, das Ziel-Scheme, den freien Speicherplatz und den ersten aussagekräftigen Fehler im Log an.

Bereithalten: Versionen, Befehl, Phase, bereinigte Logs
Signierungsproblem

Zertifikate, Profile und Zieleinstellungen prüfen

Senden Sie die bereinigte Signierungsfehlermeldung, die Bundle-ID, die Zielumgebung und den Gültigkeitsstatus des Zertifikats. Keine Zertifikatpasswörter, privaten Schlüssel oder verwendbaren Tokens übermitteln.

Bereithalten: Ziel, Kennung, Gültigkeit, Fehlermeldung
Netzwerkproblem

Latenz und tatsächliche Downloadstrecke getrennt testen

Notieren Sie den Internetanbieter, den Netzwerktyp, den Zielstandort und den Median mehrerer aufeinanderfolgender Messungen. Prüfen Sie auch, ob Repository-Abrufe oder Downloads von Abhängigkeiten betroffen sind.

Bereithalten: Anbieter, Netzwerktyp, Messwerte, Ziel
Frage zur Abrechnung

Bestellpositionen mit Basiskonfiguration und Extras abgleichen

Geben Sie Bestellnummer, Mietdauer, Basiskonfiguration und die Bezeichnung gebuchter SSD- oder Thunderbolt-5-Verbindungen an. Vollständige Zahlungsdaten gehören nicht ins Ticket.

Bereithalten: Bestellung, Laufzeit, Konfiguration, Extras
Gerätestandort ändern

Grund für den Wechsel und benötigte Daten erläutern

Notieren Sie den aktuellen Standort, die gewünschte Verbindungsrichtung sowie Arbeitsverzeichnisse und Build-Artefakte, die erhalten bleiben sollen. Geben Sie an, ob die Umgebung neu eingerichtet werden darf. Welche Optionen verfügbar sind, sehen Sie aktuell in der Konsole.

Bereithalten: aktueller Standort, Ziel, Datenumfang
Verbindung prüfen

Gehen Sie systematisch vor und verwechseln Sie Netzwerkprobleme nicht mit einem Gerätedefekt

Schließen Sie jeden Schritt ab und notieren Sie das Ergebnis, bevor Sie fortfahren. Tauschen Sie nicht gleichzeitig Schlüssel aus, ändern Sie die Firewall nicht und starten Sie das lokale Netzwerk nicht neu – sonst lässt sich die Ursache kaum feststellen.

01

Gerätestatus prüfen

Prüfen Sie Bestellung und Gerätestatus in der Konsole und vergleichen Sie Standort und Gerätekennung. Ändert sich der Status gerade, warten Sie auf eine stabile Anzeige, bevor Sie die Verbindung testen.

02

Zugangsdaten abgleichen

Verwenden Sie den Systembenutzernamen, Hostnamen und die aktuellen Zugangsdaten des betreffenden Geräts. Vermischen Sie keine Verbindungsdaten verschiedener Bestellungen.

03

SSH-Verbindung prüfen

Testen Sie aus einem vertrauenswürdigen Netzwerk, ob Host und Port erreichbar sind. Prüfen Sie anschließend Dateiberechtigungen des Schlüssels und Authentifizierungsfehler. Sichern Sie die Fehlermeldung mit Zeitstempel, aber übermitteln Sie niemals den privaten Schlüssel.

04

VNC-Sitzung prüfen

Funktioniert SSH, aber die grafische Sitzung nicht, notieren Sie separat VNC-Client, Verbindungsphase und Bildschirmanzeige. So lässt sich ein Sitzungsproblem von einem grundlegenden Netzwerkfehler unterscheiden.

05

Lokale Firewall prüfen

Prüfen Sie, ob Unternehmensnetzwerk, VPN, ausgehende Verbindungsregeln oder lokale Firewall den Zielport blockieren. Testen Sie gegebenenfalls ein anderes vertrauenswürdiges Netzwerk, um die lokale Verbindung als Ursache einzugrenzen.

Ein einzelner Ping zeigt nur die Netzwerk-Rundlaufzeit zu diesem Zeitpunkt. Er sagt nichts Verlässliches über die VNC-Darstellung, Downloadgeschwindigkeit von Abhängigkeiten oder die gesamte Build-Dauer aus. Prüfen Sie mehrere Messwerte und testen Sie reale Aufgaben.

Build-Fehler beheben

Von der Toolchain-Version bis zum ersten aussagekräftigen Fehler

Build-Logs enthalten oft Folgefehler. Suchen Sie zuerst den ersten aussagekräftigen Fehler, der den Ablauf unterbricht. Prüfen Sie anschließend die zugehörigen Tools, Abhängigkeiten, Signierung oder Speicherbedingungen.

01

Xcode und Ziel-SDK

Notieren Sie die vollständige Xcode-Version, Zielplattform, Scheme, Configuration und den tatsächlich verwendeten Toolpfad. Grafische Oberfläche und Befehlszeile sollten dieselbe Version nutzen.

02

Command Line Tools

Prüfen Sie, ob das ausgewählte Entwicklerverzeichnis und die erwartete Version übereinstimmen. Kontrollieren Sie nach einem Xcode-Upgrade, auf welchen Pfad die Kommandozeilenwerkzeuge verweisen, damit Skripte nicht eine alte Version aufrufen.

03

Abhängigkeiten und Lockdatei

Behalten Sie die im Projekt verwendete Lockdatei bei und notieren Sie den Befehl zur Wiederherstellung der Abhängigkeiten sowie die Cache-Einstellungen. Testen Sie zuerst in einem sauberen Arbeitsverzeichnis, bevor Sie eine beschädigte Cache-Datei als Ursache annehmen.

04

Zertifikate und Profile

Prüfen Sie, ob Gültigkeitsstatus, Bundle-ID, Zielumgebung und Signierungseinstellungen zusammenpassen. Übermitteln Sie nur bereinigte Fehlermeldungen, keine privaten Schlüssel oder Zertifikatpasswörter.

05

Speicherplatz und temporäre Verzeichnisse

Berücksichtigen Sie gemeinsam den Speicherbedarf von Quellcode, Dependency-Caches, DerivedData, Archiven und exportierten Builds. Bei Platzmangel können Sie zuerst wiederherstellbare Cache-Dateien löschen.

06

Zeitstempel und fehlgeschlagene Build-Phase

Halten Sie Startzeit, ersten Fehler und Endzeit fest. Geben Sie an, ob der Fehler beim Wiederherstellen von Abhängigkeiten, Kompilieren, Archivieren, Signieren oder Exportieren auftrat.

CI/CD anbinden

Dedizierten physischen Mac als verwalteten self-hosted Runner registrieren

CDNMac M4 kann iOS-Builds aus Repository-Ereignissen ausführen. Bei der Anbindung an GitHub Actions, GitLab CI, Jenkins oder andere Systeme sollte der Runner als dauerhaft verfügbarer Build-Host behandelt werden, nicht als kurzlebiger Container.

  • Erstellen Sie für jedes Repository ein eigenes Arbeitsverzeichnis und verwenden Sie keine ungeprüften Build-Caches projektübergreifend.
  • Vergeben Sie Tokens nur die für den jeweiligen Job erforderlichen Mindestberechtigungen und konfigurieren Sie sie getrennt für jedes Repository.
  • Bewahren Sie Signierungsdaten an einem geschützten Ort auf. Pipeline-Logs dürfen keine Schlüssel, Tokens oder Zertifikatpasswörter ausgeben.
  • Löschen Sie nach Abschluss des Jobs temporäre Dateien, abgeleitete Daten und nicht mehr benötigte Artefaktkopien.
  • Weisen Sie dem Runner eindeutige Labels zu, damit keine inkompatiblen Jobs versehentlich auf diesem Gerät ausgeführt werden.
Übergabeprotokoll für Builds RUNNER / M4
A1

Vertrauenswürdigen Job annehmen

Anhand von Repository, Branch und Runner-Labels entscheiden, ob der Job ausgeführt wird.

Warteschlange
B2

Abhängigkeiten wiederherstellen

Lockdatei und Repository-spezifischen Cache verwenden; Cache-Treffer protokollieren.

Arbeitsbereich
C3

Archiv erstellen

Xcode-Pfad, Scheme, Configuration und Exportparameter festlegen.

Archiv
D4

Ausliefern und bereinigen

Benötigte Artefakte kopieren, temporäre Verzeichnisse löschen und bereinigte Diagnose-Logs aufbewahren.

Artefakte
Getrennt nach: Repository Zugangsdaten: Mindestberechtigungen Bereinigung: nach Jobende
Begriffe kurz erklärt

Acht häufige Begriffe für die Fehlerbehebung

Einheitliche Begriffe im Support-Ticket erleichtern die Unterscheidung zwischen physischem Gerät, Zugriffsprotokoll, Automatisierungs-Runner und ausgelieferten Dateien.

Cloud Mac
Ein Mac, der über eine Netzwerkverbindung aus der Ferne genutzt wird. CDNMac stellt dedizierte physische Geräte bereit, die nicht mit anderen Bestellungen geteilt werden.
Physischer Standort
Region, in der das Gerät aufgestellt und ans Netzwerk angebunden ist. Der Standort beeinflusst den Verbindungsweg, bestimmt aber nicht allein die gesamte Build-Dauer.
Dediziert
Eine Bestellung umfasst die Ressourcen und Zugriffsumgebung eines einzelnen Geräts. Die Rechenleistung wird nicht auf mehrere Mietparteien aufgeteilt.
Keine virtuelle Maschine
Die Arbeitslast läuft auf echter Mac-Hardware und nicht in einer virtuellen Instanz auf einem geteilten Host.
VNC
Fernzugriff auf die grafische macOS-Oberfläche, etwa zur Anzeige des Bildschirms oder für Aufgaben mit grafischer Bedienung.
SSH
Verschlüsselte Verbindung für Kommandozeile, Skripte und Dateiübertragungen. Geeignet für Automatisierung und die tägliche Systemverwaltung.
self-hosted Runner
Ein von Ihrem Team verwalteter Runner, der bei einem CI-System registriert ist. Er nimmt Pipeline-Jobs entgegen und führt sie auf dem angegebenen Cloud-Mac aus.
Build-Artefakte
Dateien und erforderliche Logs aus Kompilierung, Archivierung oder Export. Kopieren Sie sie in einen vom Team verwalteten Speicher und legen Sie Aufbewahrungsregeln fest.
Vor dem Erstellen eines Tickets

Sechs Angaben vorbereiten, dann Ticket in der Konsole erstellen

Ein vollständiger Kontext erleichtert die Reproduktion mehr als mehrere kurze Nachrichten. Bei vertraulichen Daten nennen Sie nur Art und Status – niemals verwendbare Klartextinhalte.

01

Bestellnummer

Geben Sie Bestell- oder Gerätekennung aus der Konsole an, damit Modell, Mietdauer und Gerät zugeordnet werden können.

02

Ausgewählter Standort

Nennen Sie den aktuellen Gerätestandort, nicht nur „Asien“ oder „USA“. Falls ein Wechsel nötig ist, geben Sie zusätzlich die gewünschte Verbindungsrichtung an.

03

Zeitpunkt

Notieren Sie das erste Auftreten, die letzte Reproduktion und das Ende des Vorgangs samt Zeitzone. So lassen sich passende Geräte- und Netzwerkprotokolle finden.

04

Reproduktionsschritte

Beschreiben Sie Eingaben, Befehle, Ziel und Ergebnis der Reihe nach. Tritt das Problem nicht immer auf, geben Sie Häufigkeit und Auslöser an.

05

Bereinigte Logs

Behalten Sie Fehlerkontext und Zeitstempel bei. Entfernen Sie private Schlüssel, Tokens, Zertifikatpasswörter, personenbezogene Daten und vollständige Zahlungsdaten.

06

Erwartetes Ergebnis

Beschreiben Sie den erwarteten Status, die Datei oder den Rückgabewert und nennen Sie bereits getestete, erfolglose Schritte.

Leistungsumfang

Wobei wir helfen – und was Ihr Team selbst verwaltet

Unterscheiden Sie zwischen Gerät und Netzwerk, Systemzugriff, Empfehlungen zur Toolchain und Verantwortlichkeiten Ihres Projekts. So vermeiden Sie wiederholte Änderungen auf der falschen Ebene.

Hardware- und Netzwerkstatus

Wir prüfen Gerätestatus, Netzwerk am Standort, Bestellzuordnung und in der Konsole sichtbare Verwaltungsinformationen. Mit nachvollziehbaren Angaben können wir den Fall weiter untersuchen.

Unterstützung durch CDNMac

Hilfe beim Systemzugriff

Wir helfen festzustellen, ob das Gerät erreichbar ist, die Zugangsdaten zum Gerät gehören und ob SSH- oder VNC-Probleme auf Netzwerk-, Authentifizierungs- oder Sitzungsebene auftreten.

Unterstützung durch CDNMac

Hinweise zur Build-Toolchain

Anhand von Logs können wir Xcode, Command Line Tools, Speicherplatz und Build-Phasen gemeinsam prüfen. Projektabhängigkeiten und Skripte muss Ihr Team selbst validieren.

Gemeinsame Fehlerbehebung

Projekt- und Entwicklerdaten

Projektcode, Entwicklerkonten, Zertifikate, Profile, Zugriffsschlüssel, Softwarelizenzen, Abhängigkeitsversionen und die zulässige Nutzung der Arbeitslast verwaltet Ihr Team selbst.

Verantwortung Ihres Teams
Sicherheitshinweis

Zugangsdaten, Signierungsdaten und Build-Artefakte gemeinsam im Offboarding berücksichtigen

Ein dediziertes Gerät verringert die gemeinsame Nutzung von Ressourcen, ersetzt aber nicht das Berechtigungsmanagement Ihres Teams. Für die erste Verbindung, den laufenden Betrieb und das Mietende sollte es jeweils eine klare Checkliste geben.

01

Mindestberechtigungen verwenden

Vergeben Sie CI-Tokens, Repository-Schlüsseln und Automatisierungskonten nur die für den jeweiligen Job nötigen Rechte. Verwenden Sie nicht dieselben weitreichenden Zugangsdaten dauerhaft für mehrere Projekte.

02

Zugangsdaten regelmäßig erneuern

Dokumentieren Sie die Erneuerung von Schlüsseln und Tokens. Entziehen Sie nicht mehr benötigte Zugriffsrechte umgehend, wenn sich Teammitglieder, Repositories oder Jobgrenzen ändern.

03

Abgelaufene Zertifikate entfernen

Prüfen Sie regelmäßig Zertifikate und Profile auf ihre Gültigkeit und löschen Sie nicht mehr benötigte Kopien. So verhindern Sie, dass Pipelines versehentlich alte Einstellungen verwenden.

04

Benötigte Artefakte rechtzeitig exportieren

Kopieren Sie Änderungen am Quellcode, Build-Logs, Archive und erforderliche Artefakte vor Mietende in einen vom Team verwalteten Speicher. Prüfen Sie, ob sich die Dateien öffnen lassen.

Fehler reproduziert? Mit allen Informationen zur Konsole

Geben Sie Bestellnummer, Standort, Zeitpunkt, Reproduktionsschritte, bereinigte Logs und erwartetes Ergebnis an. Senden Sie keine Schlüssel, Tokens oder Zertifikatpasswörter im Klartext.