Dokumentation

Erst den passenden Schritt finden

Von der Verbindung mit einem exklusiven Mac mini bis zu Builds, Mietzeiträumen und Fehlerbehebung: Suchen Sie auf dieser Seite nach Befehlen oder Stichwörtern, um die passende Anleitung zu finden.

01 / Erste Verbindung

Adresse prüfen, SSH oder Desktop wählen

Prüfen Sie nach der Bereitstellung in den Instanzdetails der Konsole die Hostadresse, den Benutzernamen und die Verbindungsmethode. Beispielvariablen sind keine echten Zugangsdaten. Setzen Sie sie vor dem Ausführen auf die Werte Ihrer Instanz.

SSH-Anmeldung mit Schlüssel

Erstellen Sie auf Ihrem Gerät ein Schlüsselpaar und hinterlegen Sie den öffentlichen Schlüssel in der Konsole. Der private Schlüssel bleibt auf Ihrem Gerät. Stellen Sie sicher, dass die Instanz bereitgestellt und der Schlüssel zugeordnet ist. Verbinden Sie sich dann mit Adresse und Benutzername aus den Instanzdetails.

ssh-keygen -t ed25519
ssh -i ~/.ssh/id_ed25519 "$USER@$HOST"

USER und HOST sind Umgebungsvariablen, die Sie lokal setzen müssen. Prüfen Sie beim ersten Verbindungsaufbau den Host-Fingerprint. Überspringen Sie diese Prüfung nicht.

VNC-Desktop

Wenn Sie Xcode, den Simulator oder Systemeinstellungen bedienen müssen, verbinden Sie sich über die in den Instanzdetails der Konsole angegebene Methode mit dem Desktop. Prüfen Sie vorher den Instanzstatus sowie Anzeigeadresse und Zugangsdaten.

Bei deutlicher Verzögerung reduzieren Sie zunächst Auflösung oder Farbtiefe im Client und prüfen Sie Ihre Netzwerkverbindung. Hinterlegen Sie VNC-Zugangsdaten weder in Build-Logs noch zusammen mit Ihrem SSH-Schlüssel.

Ports und Firewall

Entnehmen Sie die tatsächlich freigegebenen Ports den Instanzdetails in der Konsole. Gehen Sie nicht davon aus, dass alle Instanzen dieselben Ports verwenden. Bei einem SSH-Timeout prüfen Sie zunächst, ob Ihr Netzwerk ausgehende Verbindungen blockiert, und kontrollieren Sie dann Hostadresse, Port und Instanzstatus. Lassen Sie vor Änderungen an den Firewall-Regeln eine funktionierende Verwaltungsverbindung bestehen, damit Sie sich nicht aussperren.

02 / Build-Workflow

Toolchain festlegen, Builds reproduzierbar machen

Prüfen Sie bei Builds über die Kommandozeile auf einem exklusiven Mac, ob Xcode-Version und Projektanforderungen übereinstimmen. Fixieren Sie im Team die Quellen für Projekt, Scheme und Signiermaterial, damit erfolgreiche Builds nicht von vorübergehenden Desktop-Einstellungen abhängen.

Xcode-Version und Kommandozeilen-Tools

Listen Sie zuerst die installierten Xcode-Versionen auf und wählen Sie die für Ihr Projekt benötigte aus. Prüfen Sie anschließend erneut Pfad und Version der Kommandozeilen-Tools. Die folgenden Pfade gelten nur, wenn die jeweilige Version tatsächlich installiert ist.

ls /Applications | grep Xcode
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
xcode-select -p
xcodebuild -version

xcodebuild und fastlane

Listen Sie im Projektverzeichnis die verfügbaren Schemes auf und prüfen Sie das Projektziel, bevor Sie einen Release-Build starten. Teams, die fastlane verwenden, sollten ihre Lane-Konfiguration versionieren und vor dem Lauf Zertifikate sowie Umgebungsvariablen prüfen.

xcodebuild -list
xcodebuild -scheme App -configuration Release build
bundle exec fastlane gym

App Ersetzen Sie den Namen durch ein im Projekt vorhandenes Scheme;gym setzt eine passende fastlane-Konfiguration im Projekt voraus.

01Eigenes Konto einrichten

Richten Sie für das Systemkonto, unter dem die Jobs laufen, die benötigten Berechtigungen ein und begrenzen Sie das Arbeitsverzeichnis. Hinterlegen Sie weder SSH-Schlüssel noch Signiermaterial im Repository.

02Runner registrieren

Erstellen Sie in den Projekteinstellungen von GitHub Actions oder GitLab die benötigten Registrierungsdaten und folgen Sie auf dem Mac den aktuellen Installationsanweisungen der Plattform.

03Job testen

Führen Sie zunächst einen kleinen Job aus, der sw_vers und xcodebuild -version ausgibt. Prüfen Sie, ob der richtige Runner den Job ausführt, bevor Sie vollständige Builds einrichten.

Wenn Sie die bereitgestellte Instanz zum ersten Mal verwenden, können Sie zunächst dieSchnellstartanleitungfür die Verbindung und den ersten Build durcharbeiten.

Begriffe verstehen

Acht Begriffe rund um Instanz und Mietzeit

Diese Begriffe unterscheiden das gemietete Gerät, die Verbindungsmethoden und die Abrechnungseinheiten. Wählen Sie zuerst den passenden Gerätetyp für Ihre Arbeitslast und legen Sie dann den Mietzeitraum fest.

Physischer Standort: Der Standort, an dem der Mac mini tatsächlich betrieben wird. Berücksichtigen Sie bei der Auswahl die Netzwerkstandorte von Ihnen und Ihrem Team. Die verfügbaren Standorte finden Sie in denStandortdetails.
Exklusiver physischer Mac: Jede Bestellung umfasst einen eigenen Mac mini. CPU, Arbeitsspeicher und Speicherplatz werden nicht mit anderen Mietern geteilt.
Keine virtuelle Maschine: Sie erhalten Zugriff auf einen physischen Mac und keine virtuelle Instanz auf einem gemeinsam genutzten Host.
VNC: Remoteverbindung zum grafischen macOS-Desktop – geeignet für Entwicklungs- und Debugging-Aufgaben, bei denen Sie die Benutzeroberfläche benötigen.
SSH-Schlüssel: Ein Authentifizierungsverfahren mit öffentlichem und privatem Schlüssel. Der öffentliche Schlüssel dient der Autorisierung; den privaten Schlüssel verwahren Sie selbst.
Self-hosted Runner: Ein bei einer CI-Plattform registriertes Programm, das Build-Jobs auf dem gemieteten Mac ausführt. Welche Berechtigungen ein Job hat, hängt vom ausführenden Systemkonto ab.
Thunderbolt 5-Kopplung: Optionale Erweiterung zu Ihrem Tarif, abgerechnet pro Gerät. Details zur Konfiguration und zu geeigneten Arbeitslasten finden Sie auf derTarifseite.
Mietzeitraum: Bei der Bestellung wählen Sie einen Abrechnungszeitraum von einem Tag, einer Woche, einem Monat oder einem Quartal. Jeder Zeitraum hat einen eigenen Preis; die Mietzeit beginnt mit der Bereitstellung.

03 / Abrechnung & Verlängerung

Die Mietzeit beginnt mit der Bereitstellung

Wählen Sie bei der Bestellung Modell, Standort, Mietzeitraum und optionale Erweiterungen aus und bezahlen Sie den gewählten Zeitraum im Voraus. Maßgeblich sind die in der Konsole angezeigten Bereitstellungs- und Ablaufzeiten, nicht der Zahlungszeitpunkt.

01Bestellung prüfen

Prüfen Sie vor der Zahlung Modell, Standort und Abrechnungszeitraum: Tag, Woche, Monat oder Quartal. Die aktuelle Verfügbarkeit zeigt die Konsole an.

02Ablauferinnerung ansehen

Nach der Bereitstellung finden Sie Mietzeitraum und Ablaufdatum in der Konsole. Erinnerungen helfen bei der Planung, ersetzen aber keine eigene Datensicherung.

03Verlängern oder upgraden

Wenn Sie die Instanz weiter nutzen möchten, starten Sie die Verlängerung über die Bestellung in der Konsole. Wenn Sie von Commit 16 zu Commit 24 wechseln möchten, prüfen Sie zuerst die neue Konfiguration und die Datenmigration und folgen Sie dann den Anweisungen in der Konsole.

Zahlung und Abrechnung

Unterstützt werden USDT-TRC20 sowie Visa, Mastercard und Amex, abgewickelt über Stripe. Alle Preise und Zahlungen lauten auf US-Dollar (USD). Welche Zahlungsanbieter beim Checkout verfügbar sind, zeigt die Konsole an. Preise für die verfügbaren Modelle und alle vier Abrechnungszeiträume finden Sie unterTarife & Preise.

04 / Häufige Probleme

Fehlerquelle Schritt für Schritt eingrenzen

Gehen Sie vom Instanzstatus über Netzwerk und Systemsitzung bis zur Projektkonfiguration vor. Notieren Sie den genauen Fehlertext, den Zeitpunkt und die bereits getesteten Schritte. So kann der Support schneller mit der eigentlichen Fehlersuche beginnen.

VNC verbunden, aber der Bildschirm bleibt schwarz

Prüfen Sie zuerst, ob die Instanz in der Konsole als verbindungsbereit angezeigt wird. Trennen Sie die Verbindung, starten Sie die grafische Sitzung erneut und verringern Sie gegebenenfalls die Auflösung im Client. Falls SSH funktioniert, prüfen Sie, ob das System weiterhin auf Befehle reagiert. Geben Sie bei einem Support-Ticket den Client-Hinweis, den Verbindungszeitpunkt und die SSH-Verfügbarkeit an. Senden Sie kein Verbindungspasswort mit.

SSH-Timeout ohne Aufforderung zur Authentifizierung

Ein Timeout tritt in der Regel auf, bevor die Schlüsselprüfung beginnt. Kontrollieren Sie die von der Konsole angegebene Adresse und den Port, den Instanzstatus und ob Ihr Netzwerk ausgehende Verbindungen zulässt. Testen Sie die Verbindung über ein anderes Netzwerk und notieren Sie das Ergebnis. Wechseln Sie den privaten Schlüssel nicht wiederholt, bevor Sie die Portregeln geprüft haben.

Build schlägt wegen zu wenig Speicherplatz fehl

Prüfen Sie mit df -h zuerst den verfügbaren Speicherplatz. Kontrollieren Sie anschließend den Speicherbedarf von Build-Artefakten, DerivedData, Archiven und Modelldateien. Prüfen Sie vor dem Löschen, wem die Dateien gehören, und sichern Sie alle benötigten Artefakte. Wenn Sie langfristig mehr Speicherplatz benötigen, finden Sie verfügbare SSD-Erweiterungen auf derTarifseite.

Archivierung wegen Schlüsselbund oder Signierzertifikat fehlgeschlagen

Prüfen Sie, ob das Zertifikat gültig ist, Provisioning Profile und Bundle ID zusammenpassen und das ausführende Konto auf den betreffenden Schlüsselbund zugreifen darf. Das Desktop-Anmeldekonto und das Konto des CI-Runners können unterschiedlich sein. Reproduzieren Sie den Fehler zunächst unter demselben Konto. Einem Support-Ticket können Sie bereinigte Fehlerprotokolle beifügen. Senden Sie keine privaten Schlüssel oder Zertifikatpasswörter.

Bevor Sie die Instanz verlassen

Daten vor Ablauf exportieren – nicht auf die Aufbewahrungsfrist verlassen

Sichern Sie Projektquellcode, Build-Artefakte, Zertifikate und Modelldateien selbst. Nach Ablauf der Mietzeit wird der Instanzzugriff gemäß den Nutzungsbedingungen behandelt. Maßgeblich für die Datenaufbewahrung und die anschließende Löschung sind dieNutzungsbedingungenund Ihre Bestellinformationen. Gehen Sie nicht davon aus, dass Sie sich nach Ablauf noch anmelden und Dateien abrufen können.

01Arbeitsergebnisse exportieren

Committen Sie Ihren Code in Ihr eigenes Repository und kopieren Sie noch nicht archivierte IPA-Dateien, Logs oder Modellergebnisse an einen von Ihnen verwalteten Speicherort.

02Vertrauliche Daten prüfen

Prüfen Sie den Umfang der Verwendung von Signierzertifikaten, Schlüsseln und CI-Variablen. Rotieren Sie Zugangsdaten bei Bedarf auf Projektebene und speichern Sie keine privaten Schlüssel in gemeinsam genutzten Build-Logs.

03Nächste Schritte festlegen

Wenn Sie dieselbe Instanz weiter nutzen möchten, prüfen Sie rechtzeitig die Verlängerungsoptionen. Wenn Sie die Nutzung beenden, stellen Sie vor dem Abschluss sicher, dass sich Ihre Sicherungen öffnen lassen.

Noch keine Lösung?

Schildern Sie uns das Problem und Ihre bisherigen Schritte

Wenn Sie bereits eine Bestellung haben, melden Sie sich in der Konsole an und reichen Sie ein Support-Ticket ein. Geben Sie Bestellnummer, Standort, Zeitpunkt des Problems und Fehlermeldung an. Bei Fragen zu Verbindung oder Konfiguration vor der Bestellung können Sie uns per E-Mail über die Kontaktseite erreichen.

In der Konsole anmelden und Ticket erstellen Kontaktmöglichkeiten ansehen