Technische Problemweiterleitung

Zuerst die Fehler­ebene bestimmen, dann ein reproduzierbares Problem melden

Hier finden Sie Hilfe zu Verbindungen, Xcode-Builds, CI/CD-Runnern, Speicher, Netzwerk und Abrechnung auf exklusiven physischen Mac-Knoten. Führen Sie zuerst die Basisprüfungen der Reihe nach durch. Wenn das Problem bleibt, senden Sie Bestellung, Umgebung und bereinigte Logs gemeinsam ein.

6 Kategorien
Problemzugänge
5
Verfügbare Knotenregionen
7
Erforderliche Ticketangaben
Build-Diagnosekonsole BUILD / CHECK
Auf Logs warten
Verbindung Adresse, Port, Zugangsdaten
Zuerst prüfen
Umgebung System, Xcode, SDK
Dann abgleichen
Build Abhängigkeiten, Signierung, Cache
Reproduzieren
Bereitstellung Archiv, Upload, Artefakte
Abgleichen
Empfohlene Reihenfolge Verbindung → Umgebung → Build → Bereitstellung
Überblick über die Support-Einstiege

Zum passenden Prüfpfad nach Symptomen

Ändern Sie nicht gleichzeitig Netzwerk, Systemversion und Build-Konfiguration. Ändern Sie immer nur eine Variable und bewahren Sie den ursprünglichen Fehlertext sowie den Zeitpunkt auf. Nur so lässt sich die Ursache der Verbindungs-, Umgebungs- oder Projektebene zuordnen.

Verbindungsprobleme

Adresse erreichbar, Sitzung lässt sich nicht öffnen

Prüfen Sie zuerst Knotenadresse, Port, Benutzername und Zugangsdaten. Kontrollieren Sie anschließend lokale Netzwerkbeschränkungen, Verschlüsselungsoptionen des Clients und den Sitzungsstatus. Verwenden Sie alte Zugangsdaten nicht wiederholt.

Verbindungsschritte öffnen
Xcode-Build

Kompilierung, Archivierung oder Upload fehlgeschlagen

Notieren Sie die Fehlerphase und prüfen Sie danach Speicherplatz, Xcode- und SDK-Version, Sperrdatei der Abhängigkeiten, Signiermaterial und das vollständige Build-Log. Bewahren Sie vor allem den ersten tatsächlichen Fehler auf.

Reihenfolge der Build-Diagnose anzeigen
CI/CD

Runner offline oder Auftrag wird nicht eingeplant

Prüfen Sie Runner-Prozess, Registrierungsstatus, passende Labels, Berechtigungen des Arbeitsverzeichnisses und das Parallelitätslimit. Ein online angezeigter Runner erfüllt nicht automatisch die Labels des aktuellen Auftrags.

Runner-Konfiguration prüfen
Speichererweiterung

Cache und Build-Artefakte belegen den gesamten Speicher

Trennen Sie Quellcode, Abhängigkeits-Cache, DerivedData, Archive und Auslieferungsartefakte nach ihrer Nutzung. Exportieren Sie benötigte Dateien zuerst und bereinigen Sie anschließend gezielt Verzeichnisse. Löschen Sie keine Daten mit unklarem Zweck direkt.

Häufige Fragen zum Speicher
Knotenwechsel

Team- oder Repository-Standort hat sich geändert

Dokumentieren Sie vor einer Migration den aktuellen Knoten, die Hostingregion des Repositorys, den Standort der Hauptnutzer und die Richtung großer Dateiübertragungen. Erstellen Sie vorab unabhängige Kopien von Code und Build-Artefakten.

Knoten und Netzwerk vergleichen
Abrechnungsprobleme

Bestellung, Zeitraum oder Zahlungsstatus muss geprüft werden

Halten Sie Bestellnummer, gewählte Konfiguration, Abrechnungszeitraum, Zahlungsart und den im Dashboard angezeigten Status bereit. Senden Sie nur die Transaktionskennung, niemals vollständige Kartendaten oder private Schlüssel.

Abrechnungsticket im Dashboard einreichen
Ersteinrichtung

Zuerst die Knotenbasis festlegen, dann Projektools installieren

Führen Sie beim ersten Zugriff zuerst Verbindungs- und Sicherheitsprüfungen durch und konfigurieren Sie danach die Entwicklungsumgebung. So lassen sich System- und Abhängigkeitsprobleme trennen und später leichter reproduzieren.

  1. 01

    Verbindungsdaten im Dashboard abrufen

    Prüfen Sie den zur Bestellung gehörenden Knoten, Serveradresse, Port, Benutzernamen und temporäre Zugangsdaten. Die Verbindungsdaten sind ausschließlich für aktuell autorisierte Mitglieder bestimmt und dürfen nicht über Chatverläufe oder öffentliche Dokumente weitergegeben werden.

    Abschlusskriterium: Eine Sitzung lässt sich stabil aufbauen und der richtige, zur Bestellung gehörende Knoten ist bestätigt.
  2. 02

    Kontosicherheit einrichten

    Aktualisieren Sie nach dem ersten Zugriff die temporären Zugangsdaten und erstellen Sie Systemkonten gemäß der Berechtigungsrichtlinie des Teams. Administratorrechte erhalten nur Mitglieder, die Tools installieren oder Dienste anpassen müssen.

    Abschlusskriterium: Temporäre Zugangsdaten werden nicht mehr verwendet; Alltags- und Administratorkonten sind klar getrennt.
  3. 03

    System- und Entwicklungsbasis dokumentieren

    Dokumentieren Sie macOS-Version, Chip, verfügbaren Speicher, Xcode-Version, Pfad der Kommandozeilentools und Ziel-SDK. Das Team sollte diese Angaben in sein Build- und Betriebs­handbuch übernehmen.

    Abschlusskriterium: Unterschiede zwischen lokalen und Cloud-Builds lassen sich mit denselben Versionsangaben erklären.
  4. 04

    Abhängigkeiten und Runner installieren

    Installieren Sie Abhängigkeiten anhand der Sperrdatei des Projekts, richten Sie ein separates Cache-Verzeichnis ein und registrieren Sie anschließend den self-hosted runner. Verwenden Sie beim ersten Auftrag eine geringe Parallelität, um Signierung, Archivierung und Upload zu prüfen.

    Abschlusskriterium: Ein minimaler Build-Auftrag lässt sich wiederholt ausführen und hinterlässt vollständige Logs.
Basisdokumentation

Empfohlene Umgebungsübersicht

  • Vollständige macOS- und Xcode-Versionsnummern
  • Ziel-SDK und Pfad der Kommandozeilentools
  • Version von Abhängigkeitsmanager und Sperrdatei
  • Runner-Name, Labels und Arbeitsverzeichnis
  • Cache-Verzeichnis und maximale Anzahl paralleler Aufträge
Erstprüfung

Die gesamte Kette mit einem Minimalauftrag prüfen

Rufen Sie zunächst einen nachweislich baubaren Commit ab und führen Sie nur Installation der Abhängigkeiten, Kompilierung und Archivierung aus. Fügen Sie parallele Aufträge, Cache-Wiederherstellung und Bereitstellung erst nach erfolgreicher Prüfung hinzu.

Vorbereitung der Verbindungsprüfung
Build-Fehlerdiagnose

Die Fehlerkette Schritt für Schritt prüfen – nicht sechs Variablen gleichzeitig ändern

Build-Probleme betreffen meist sechs Ebenen: Speicherplatz, Signierung, Versionen, Abhängigkeiten, Logs und Parallelität. Führen Sie nach jeder Ebene denselben Commit erneut aus und dokumentieren Sie die Änderung.

01

Speicherplatz

Prüfen Sie getrennt den freien Speicher des Systemvolumes, DerivedData, Abhängigkeits-Cache, Archivverzeichnis und Exportartefakte. Bei Platzmangel sichern Sie notwendige Artefakte und bereinigen anschließend gezielt Verzeichnisse.

Kapazität
02

Zertifikate und Bereitstellungsprofile

Prüfen Sie, ob Team, gültiges Zertifikat, Ziel des Bereitstellungsprofils und Bundle Identifier übereinstimmen. Fügen Sie privaten Signierschlüssel niemals Logs oder Tickets bei.

Signierung
03

Xcode- und SDK-Version

Dokumentieren Sie den tatsächlich für den Build verwendeten Xcode-Pfad. Stellen Sie sicher, dass die Kommandozeilentools nicht auf eine andere Version zeigen, und prüfen Sie, ob das erforderliche Ziel-SDK vorhanden ist.

Version
04

Abhängigkeits-Cache

Vergleichen Sie den Cache mit der Sperrdatei auf Aktualität. Versuchen Sie zunächst einen sauberen Build ohne Cache-Wiederherstellung. Funktioniert dieser, stellen Sie die Abhängigkeits-Caches einzeln wieder her, um die Abweichung zu finden.

Abhängigkeiten
05

Vollständiges Build-Log

Bewahren Sie ausgeführten Befehl, Exit-Code und ersten tatsächlichen Fehler auf. Der letzte Bildschirmausschnitt allein lässt häufig frühere Fehler aus; fügen Sie bereinigte Logs vom Start bis zum Ende bei.

Logs
06

Anzahl paralleler Aufträge

Reduzieren Sie die Parallelität auf einen einzelnen Auftrag und beobachten Sie Speicher-, Festplatten- und Netzwerkauslastung. Ist ein Einzelauftrag erfolgreich, ein paralleler Lauf jedoch nicht, erhöhen Sie die Parallelität schrittweise, bis die stabile Grenze erreicht ist.

Parallelität

Wenn die sechs Prüfebenen keine Ursache ergeben, senden Sie fehlgeschlagenen Commit, ausgeführten Befehl, Umgebungsversionen, Exit-Code und bereinigte Logs ein.

Build-Ticket einreichen
CI/CD-Support

Runner erkennbar, wiederherstellbar und prüfbar machen

Exklusive physische Knoten eignen sich als self-hosted runner. Ein stabiler Betrieb setzt jedoch eine klare Registrierungsstrategie, Labels, Dienstverwaltung, Cache-Grenzen und Berechtigungssteuerung voraus.

A1

Registrierung

Verwenden Sie für jeden Knoten einen eindeutigen Runner-Namen und dokumentieren Sie Repository oder Organisation, Registrierungsbereich, Arbeitsverzeichnis und Dienstkonto. Widerrufen Sie bei einer Migration zuerst die alte Registrierung.

A2

Labels

Labels sollten stabile Fakten wie Chiparchitektur, Xcode-Hauptversion, Knotenregion und Zweck ausdrücken. Vermeiden Sie schwer wartbare Kombinationen aus temporären Projektnamen.

A3

Dienstbetrieb

Betreiben Sie den Runner als verwalteten Dienst und dokumentieren Sie Startmethode sowie Log-Speicherort. Prüfen Sie nach einem Neustart, ob der Dienst automatisch wiederhergestellt wird, und testen Sie einen Minimalauftrag.

A4

Cache-Verzeichnisse

Verwalten Sie Abhängigkeiten, DerivedData und Archive in getrennten Verzeichnissen und legen Sie Bereinigungsschwellen fest. Der Cache beschleunigt Abläufe, darf aber weder die einzige Projektkopie noch ein dauerhaftes Auslieferungsarchiv sein.

A5

Minimale Berechtigungen

Das reguläre Build-Konto erhält nur die für den Auftrag erforderlichen Verzeichnis- und Befehlsrechte. Für Toolinstallation, Systemänderungen und Dienstverwaltung sind Administratorrechte zu verwenden.

Prüfreihenfolge bei einem Offline-Runner

Dienstprozess → Gültigkeit der Registrierung → passende Labels → Berechtigungen des Arbeitsverzeichnisses → externe Verbindung → Auftragswarteschlange der Plattform.

Runner-Ticket einreichen
Kleines Glossar

Zuerst Begriffe vereinheitlichen, dann das Problem beschreiben

Einheitliche Begriffe im Ticket verhindern, dass physischer Knoten, Remote-Sitzung, Runner und Build-Cache als derselbe Fehlergegenstand behandelt werden.

Physischer Knoten
Apple-Silicon-Mac-Gerät, auf dem macOS, Xcode und Build-Aufträge tatsächlich laufen. Der Knoten ist eine Hardwareeinheit und keine gemeinsam genutzte virtuelle Ressource.
Exklusiv
Die einem Auftrag zugeordnete Knotenressource wird vom jeweiligen Kunden genutzt; CPU, Arbeitsspeicher und lokaler Speicher werden nicht mit Aufgaben anderer Kunden gemeinsam eingeplant.
Keine virtuelle Maschine
Das System läuft direkt auf einem physischen Mac, nicht als mehrere virtuelle Instanzen auf einem Gerät. Die Hardware entspricht unmittelbar der bestellten Konfiguration.
VNC
Verbindungsart zur Anzeige und Bedienung der grafischen macOS-Oberfläche aus der Ferne. Adresse, Port, Konto und Verschlüsselungsoptionen müssen anhand der Verbindungsdaten eingetragen werden.
Self-hosted runner
Ein vom Team bei der CI/CD-Plattform registrierter Runner, der Aufträge auf einem exklusiven Knoten ausführt und die Kontrolle über Toolversionen, Cache und Parallelität ermöglicht.
Build-Cache
Wiederverwendbare Daten, die wiederholte Downloads oder Kompilierungen vermeiden, darunter Abhängigkeits-Cache und DerivedData. Bei Beschädigung muss der Cache sicher neu erstellt werden können.
Signierzertifikat
Vertrauliches Signiermaterial im Build- und Bereitstellungsprozess. Beschreiben Sie bei der Diagnose nur Name, Status und Fehler des Zertifikats und laden Sie keinen privaten Schlüssel ins Ticket hoch.
Knotenregion
Region des physischen Knotens. Berücksichtigen Sie bei der Auswahl Entwicklerstandort, Repository-Standort, Bereitstellungsziel und Richtung großer Dateiübertragungen.
Knoten- und Netzwerkdiagnose

Region nach dem gesamten Workflow auswählen, nicht nur nach einer einzelnen Latenzmessung

VMArm bietet 5 Knotenregionen: Singapur, Japan (Tokio), Südkorea (Seoul), Hongkong und den Westen der USA. Vergleichen Sie Remote-Bedienung, Repository-Abrufe, Abhängigkeitsdownloads und Artefakt-Uploads gemeinsam.

SG

Singapur

Geeignet für Teams in Südostasien sowie Repositorys und Bereitstellungsketten mit Schwerpunkt in Südostasien.

JP

Japan (Tokio)

Geeignet für Teams in Japan und Ostasien; ermöglicht eine gute Verbindung aus Remote-Desktop-Bedienung und Zugriff auf regionale Build-Ressourcen.

KR

Südkorea (Seoul)

Geeignet für Entwicklerteams, Abhängigkeitsspiegel und Bereitstellungsprozesse in Südkorea und Nordostasien.

HK

Hongkong

Geeignet für kollaborierende Teams in Südchina und Südostasien. Testen Sie vor der Auswahl sowohl Repository- als auch Remote-Sitzungsverbindungen.

US-W

Westen der USA

Geeignet für Teams an der US-Westküste sowie Projekte mit Repositorys, Abhängigkeitsquellen oder Bereitstellungssystemen in Nordamerika.

Methode zur Erfassung von Knoten- und Netzwerkanomalien
Prüfobjekt Messung Zu dokumentieren Bewertungsschwerpunkt
Remote-Sitzung Verbindung und Interaktion während und außerhalb der Arbeitszeit getrennt testen Lokales Netzwerk, Knoten, Clientversion, Zeitpunkt Dauerhafte Störung oder Schwankung zu bestimmten Zeiten
Code-Repository Klonen, Abrufen und Submodule mit demselben Repository und Commit testen Repositoryregion, Dauer, fehlgeschlagener Befehl, Exit-Code Langsamer Verbindungsaufbau oder langsame Übertragung großer Dateien
Abhängigkeitsdownload Einmalige vollständige Abhängigkeitsauflösung ohne Cache ausführen Abhängigkeitsquelle, Paketmanager-Version, fehlerhaftes Paket, Anzahl der Wiederholungen Einzelne Quelle gestört oder gesamte Bandbreite beeinträchtigt
Artefakt-Upload Übertragung mit bereinigten Testdateien gleicher Größe vergleichen Dateigröße, Zielregion, Start- und Endzeit Einfluss von Upload-Strecke, Zieldienst oder Dateigröße
Erforderliche Ticketangaben

Den Diagnosekontext vollständig in einer Nachricht liefern

Ein Ticket soll nicht nur belegen, dass ein Problem besteht, sondern die Zuordnung zu Bestellung, Knoten, Zeitpunkt und fehlgeschlagenem Schritt ermöglichen.

Diagnosedaten 7 ERFORDERLICHE ANGABEN
01 Bestellnummer

Zur Bestätigung von Konfiguration, Abrechnungszeitraum und Bereitstellungsdaten.

02 Knotenregion

Geben Sie Singapur, Japan (Tokio), Südkorea (Seoul), Hongkong oder den Westen der USA an.

03 Zeitpunkt

Geben Sie den Zeitpunkt einschließlich Zeitzone an und teilen Sie mit, ob der Fehler reproduzierbar ist.

04 Systemversion

Geben Sie die vollständige macOS-Version an, nicht nur den Namen der Hauptversion.

05 Xcode-Version

Geben Sie außerdem die von den tatsächlichen Kommandozeilentools verwendete Version und den Pfad an.

06 Reproduktionsschritte

Beginnen Sie mit dem funktionierenden Zustand und beschreiben Sie jeden Klick oder Befehl in der tatsächlichen Reihenfolge.

07 Bereinigte Logs

Behalten Sie Fehlerkontext und Exit-Code bei und entfernen Sie Tokens, private Schlüssel sowie andere vertrauliche Informationen.

Bestehende Bestellung

Ticket im Dashboard einreichen

Melden Sie sich an, wählen Sie die betreffende Bestellung und senden Sie das Problem ein. Bestell- und Knotenkontext sind dann vollständig und eignen sich für Verbindungs-, Build-, Migrations- und Abrechnungsprobleme.

Zum Dashboard
Vorverkauf und Beschaffung

Zuerst Workload und Umfang beschreiben

Wenn Sie noch nicht bestellt haben, nennen Sie Zweck, Zielkonfiguration, Anzahl paralleler Builds, bevorzugte Region und geplanten Starttermin.

Kontaktmöglichkeiten anzeigen

Entfernen Sie vor dem Einreichen Zugriffstokens, private Signierschlüssel, vollständige Zahlungsdaten und andere vertrauliche Inhalte. Informationen zur Datenverarbeitung finden Sie in derDatenschutzerklärung.

Supportumfang und Antwortprozess

Von der Problembestätigung bis zum Ticketabschluss liefert jeder Schritt ein Ergebnis

Die Reihenfolge der Bearbeitung richtet sich nach Auswirkung und Reproduzierbarkeit. Der Support kümmert sich um Bereitstellung, Verbindung, Umgebung und Bestellung; die Projektverantwortlichen müssen die Geschäftslogik bestätigen.

  1. 01

    Problem einstufen

    Bewerten Sie den Umfang anhand nicht möglicher Verbindungen, vollständig blockierter Builds, einzelner fehlerhafter Aufträge oder allgemeiner Fragen und prüfen Sie mögliche Alternativen.

  2. 02

    Eingangsbestätigung

    Wir bestätigen Bestellung, Knoten, Zeitpunkt, Umgebung und Logs. Fehlen Angaben, werden die benötigten Felder ausdrücklich genannt.

  3. 03

    Diagnose-Update

    Wir nennen aktuelle Prüfebene, bereits ausgeschlossene Ursachen, nächste Validierung und erforderliche Tests, damit keine Schritte ohne zusätzlichen Erkenntnisgewinn wiederholt werden.

  4. 04

    Abschlussbedingungen

    Das Ticket geht in den Abschlussprozess über, sobald das Problem behoben, Ursache und Vermeidung erklärt oder eine Projektkonfiguration festgestellt und eine umsetzbare Prüfrichtung genannt wurde.

Vom Support abgedeckt

  • Prüfung von Bestellung und Bereitstellungsstatus des Knotens
  • Diagnose von VNC-Adresse, Port und Sitzungsverbindung
  • Grundlegende Diagnose von System, Speicher, Netzwerk und Berechtigungen des Knotens
  • Status und allgemeine Konfiguration des Runner-Dienstes
  • Erläuterung von Abrechnungszeitraum und Zahlungsstatus

Gemeinsam mit dem Projektteam zu klären

  • Geschäftslogik des Codes und Verhalten von Drittanbieter-SDKs
  • Projektspezifische Skripte und interne Abhängigkeitsquellen
  • Vom Team festgelegte Signier- und Veröffentlichungsprozesse
  • Repository-Berechtigungen, Branch-Strategie und Auslöserbedingungen
  • Fachliche Abnahmekriterien der Build-Artefakte
Nächster Schritt

Den nächsten Build auf einen exklusiven physischen Mac-Knoten verlagern

Wählen Sie VMArm M4 Core oder VMArm M4 Plus und anschließend eine Region: Singapur, Japan (Tokio), Südkorea (Seoul), Hongkong oder Westen der USA. Maßgeblich ist die Verfügbarkeit, die das Dashboard in Echtzeit meldet.