01Bereitstellung prüfen
Erste Anmeldung mit den Zugangsdaten
Ordnen Sie Bestellung, Mac und Verbindungsdaten einander zu. Testen Sie zuerst einen Mac, damit Sie nicht versehentlich die Adresse eines anderen Knotens im Client eintragen.
Schritte anzeigen
- Melden Sie sich in der Konsole an und öffnen Sie die Instanzdetails der passenden Bestellung. Prüfen Sie Modell, Knoten, Mietdauer und aktuellen Bereitstellungsstatus.
- Notieren Sie Verbindungsadresse, Anmeldename und den tatsächlich verwendeten Port. Maßgeblich sind die Angaben in der Konsole. Setzen Sie die Daten nicht aus weitergeleiteten E-Mails oder Chatverläufen zusammen.
- Ändern Sie nach der ersten Verbindung das Anmeldepasswort und führen Sie
sw_vers aus, um die Systemversion zu prüfen. Führen Sie anschließend df -h aus, um den freien Speicherplatz zu überprüfen.
- Notieren Sie Projektverzeichnis, Ausgabeverzeichnis und zuständige Person. Wenn mehrere Personen im Team arbeiten, legen Sie Zugangsdaten nicht im Code-Repository ab.
Erfolgreich, wenn:Sie sich erneut verbinden können, die Systeminformationen mit der Bestellung übereinstimmen und Sie wissen, wo die Build-Ergebnisse gespeichert werden. Haben Sie bezahlt, aber noch keine Zugangsdaten erhalten, erstellen Sie eine Supportanfrage in der Bestellung, statt mehrfach dieselbe Bestellung anzulegen.
02Fernzugriff
Bildschirmfreigabe und SSH-Schlüssel einrichten
Die grafische Oberfläche eignet sich für die erste Einrichtung und interaktives Debugging. SSH ist praktisch für Befehle, Dateiübertragungen und automatisierte Aufgaben.
Schritte anzeigen
- Stellen Sie mit den bereitgestellten Zugangsdaten eine Verbindung über die Bildschirmfreigabe her. Prüfen Sie in den Systemeinstellungen unter „Allgemein → Teilen“, dass nur die benötigten Accounts Zugriff haben.
- Wenn Sie die Befehlszeile benötigen, prüfen Sie die Einstellung „Entfernte Anmeldung“. Erstellen Sie lokal einen SSH-Schlüssel oder verwenden Sie einen vorhandenen und übertragen Sie nur den öffentlichen Schlüssel auf den Remote-Mac.
- Fügen Sie den öffentlichen Schlüssel der Datei
~/.ssh/authorized_keysdes Zielbenutzers hinzu. Setzen Sie die Berechtigungen für das Verzeichnis auf 700und für die Datei auf 600.
- Lassen Sie die aktuelle Sitzung geöffnet und prüfen Sie die Anmeldung mit dem öffentlichen Schlüssel in einem zweiten Terminal. Ändern Sie erst danach die Authentifizierungsmethode. Der private Schlüssel bleibt stets lokal oder im Schlüsselverwaltungssystem Ihres Teams.
Erfolgreich, wenn:Sie sich mit der grafischen Sitzung verbinden können und der SSH-Schlüssel in einer neuen Sitzung akzeptiert wird. Prüfen Sie Port- und Firewall-Einstellungen anhand der tatsächlich bereitgestellten Angaben.
Verbindungsanleitungen für die einzelnen Systeme lesen
03Tools prüfen
Xcode-Befehlszeilentools installieren und prüfen
Prüfen Sie zuerst, ob die aktuelle Umgebung den Projektanforderungen entspricht. Aktualisieren Sie nicht automatisch, nur weil Xcode bereits installiert ist.
Schritte anzeigen
- Prüfen Sie die Version und den Pfad der Entwicklertools mit
xcodebuild -version und xcode-select -p .
- Fehlen die Befehlszeilentools, führen Sie
xcode-select --installaus. Für vollständige Builds benötigen Sie eine zum Projekt passende Xcode-Version. Die Befehlszeilentools enthalten nicht alle SDKs.
- Wenn mehrere Xcode-Versionen installiert sind, können Sie
DEVELOPER_DIR verwenden, um für einen einzelnen Auftrag ein Entwicklerverzeichnis festzulegen, oder mit xcode-select die systemweite Auswahl ändern.
- Bestätigen Sie die Tool-Lizenzbedingungen, installieren Sie die Komponenten für den ersten Start und kompilieren sowie testen Sie anschließend ein kleines Projekt.
Erfolgreich, wenn:Die Xcode-Version im Terminal und in den CI-Logs stimmt überein und das benötigte SDK ist verfügbar. Halten Sie die Version in der Projektkonfiguration oder der Runner-Startumgebung fest, statt sich auf das Gedächtnis der zuständigen Person zu verlassen.
04Automatisierung einrichten
Selbst gehosteten Runner auf dem Mac mini Server registrieren
Führen Sie zuerst einen manuellen Build erfolgreich aus und übergeben Sie Aufgaben erst danach an den Runner. Die Registrierungsbefehle unterscheiden sich je nach CI-Plattform. Verwenden Sie die Angaben im jeweiligen Projektbereich.
Schritte anzeigen
- Erstellen Sie einen dedizierten Build-Benutzer und ein Arbeitsverzeichnis. Laden Sie in den CI-Projekteinstellungen ein Runner-Installationspaket für macOS und Apple Silicon herunter.
- Registrieren Sie den Runner mit einem kurzlebigen Registrierungstoken. Kennzeichnen Sie ihn mit Betriebssystem, Chip, Knoten und Einsatzzweck. Speichern Sie keine langfristigen Zugriffstoken im Repository.
- Starten Sie zunächst eine einfache Aufgabe als Vordergrundprozess und prüfen Sie PATH, Xcode-Pfad, Schlüsselbundzugriff und Artefakt-Upload.
- Konfigurieren Sie den Dienst erst nach Prüfung der Berechtigungen für unbeaufsichtigte Ausführung gemäß den Anweisungen Ihrer CI-Plattform. Aufgaben mit grafischer Oberfläche müssen separat auf die Anforderungen an die Sitzung geprüft werden.
Erfolgreich, wenn:Eine Teständerung löst eine Aufgabe aus, die Logs lassen sich der richtigen Instanz zuordnen und die Artefakte werden außerhalb des Macs gespeichert. Ein exklusiv genutzter Mac ermöglicht keine unbegrenzte Parallelität. Testen Sie zuerst mit serieller Ausführung und erhöhen Sie die Parallelität anschließend passend zur Speicher- und Festplattenauslastung.