Wählen Sie Verbindung, Xcode, CI/CD, Speicher, Netzwerk oder Verlängerung. Die Seite zeigt dann die passenden Einstiege. Sie können auch nach Kommandos, Symptomen oder Toolnamen suchen.
Derzeit werden alle 6 Hilfekategorien angezeigt.
Verkürzen Sie die Suchbegriffe oder löschen Sie die Kategorie und suchen Sie nach dem Kommandonamen. Fragen zu bestehenden Bestellungen können Sie direkt als Konsolen-Ticket senden.
Maßgeblich sind die Verbindungsdaten auf der Detailseite der Konsoleninstanz. Raten Sie die Hostadresse nicht anhand alter Tickets oder historischer Befehle. Nach einer erneuten Bereitstellung des Knotens müssen die aktuellen Daten erneut kopiert werden.
Öffnen Sie die Instanzdetails in der Konsole und kopieren Sie Hostadresse, SSH-Benutzername, Port und Schlüsseldaten. Prüfen Sie zuerst, ob Bestellung und Knoten übereinstimmen, und fügen Sie den Befehl anschließend in Ihr lokales Terminal ein.
Speichern Sie die Schlüsseldatei in einem lokal kontrollierten Benutzerverzeichnis. Legen Sie sie nicht in Git-Repositories, Build-Artefakte oder Team-Chats. Der Dateiname ist frei wählbar, der Pfad im späteren Befehl muss jedoch übereinstimmen.
Führen Sie im lokalen macOS- oder Linux-Terminal aus chmod 600 ~/.ssh/oncemac_key. Wenn SSH zu weit gefasste Berechtigungen für den privaten Schlüssel meldet, korrigieren Sie diese zuerst. Umgehen Sie die Prüfung nicht durch Deaktivieren der Sicherheitskontrollen.
Führen Sie den von der Konsole bereitgestellten SSH-Befehl aus. Prüfen Sie bei der ersten Verbindung die Quelle des Host-Fingerabdrucks. Führen Sie nach dem Anmelden auf dem Knoten hostname,sw_vers und whoamiaus, um Host, System und aktuellen Benutzer zu bestätigen.
Ändern Sie pro Diagnose nur eine Variable. Prüfen Sie zuerst eine stabile SSH-Sitzung, lesen Sie dann die Xcode-Version aus und führen Sie zuletzt den Build mit Ergebnis-Bundle und Logs aus. So lassen sich Verbindungs-, Toolchain- und Projektprobleme unterscheiden.
$ ssh -i ~/.ssh/oncemac_key user@host
Last login: current session
connected: once-node
$ xcodebuild -version
Xcode 16.x
Build version 16x
$ xcode-select -p
/Applications/Xcode.app/Contents/Developer
$ set -o pipefail
$ xcodebuild \
-workspace App.xcworkspace \
-scheme App \
-destination 'generic/platform=iOS' \
-resultBundlePath ./BuildResults.xcresult \
build | tee build.log
** BUILD SUCCEEDED **
$ bundle exec fastlane ios build
[fastlane] resolving dependencies
[fastlane] archive completed
[fastlane] lane finished successfully„Lokal funktioniert der Build, auf dem Knoten nicht“ reicht meist nicht zur Ursachenanalyse. Vergleichen Sie denselben Commit, Lock-Dateien, scheme, destination und Umgebungsvariablen sowie die Ausgaben beider Seiten.
Führen Sie xcodebuild -versionaus und notieren Sie Hauptversion und Build version. Ist die Pipeline von einer bestimmten Version abhängig, geben Sie die Version am Aufgabenbeginn aus – nicht nur bei der Ersteinrichtung.
xcodebuild -version
xcrun --find simctl
swift --versionFühren Sie xcode-select -p aus, um den aktuellen Pfad der Command Line Tools zu prüfen. Bei mehreren Xcode-Versionen muss die Ausführungsumgebung DEVELOPER_DIRexplizit setzen, damit interaktive Sitzung und Automatisierungsaufgabe nicht unterschiedliche Pfade verwenden.
xcode-select -p
echo "$DEVELOPER_DIR"
xcrun --sdk iphoneos --show-sdk-pathPrüfen Sie zunächst, ob der Schlüsselbund erreichbar ist und Zertifikatsname sowie Provisioning-Profile-Bedingungen übereinstimmen. Kontrollieren Sie anschließend Team, Bundle Identifier und Signiermethode des Projekts. Für Tickets genügen bereinigte Fehlerabschnitte; fügen Sie keine Zertifikate, privaten Schlüssel oder Passwörter bei.
security list-keychains
security find-identity -v -p codesigning
xcodebuild -showBuildSettingsMit set -o pipefail den echten Exit-Status erhalten und zugleich mit tee in ein Log schreiben. Bei komplexen Fehlern empfiehlt sich ein .xcresult-Bundle. Entfernen Sie vor dem Teilen Benutzernamen, Pfade, Token und Geschäftsdaten.
set -o pipefail
xcodebuild build | tee build.log
echo "${PIPESTATUS[0]}"OnceMac bietet dedizierte physische Knoten und eine vollständige macOS-Kommandozeilenumgebung. Plattformfunktionen, Plugin-Kompatibilität und Aufgabendefinitionen sollten Teams unter ihren eigenen Repository- und Versionsbedingungen prüfen.
runs-on Bedingung.whoami,pwd, Xcode-Version und freien Speicher aus.Bauen Sie die Toolchain bevorzugt aus Git, Lock-Dateien und Brewfile neu auf und migrieren Sie nur benötigte Arbeitsverzeichnisse und Caches. Das Kopieren der gesamten alten Benutzerumgebung übernimmt veraltete Konfigurationen, absolute Pfade und sensible Zugangsdaten.
Prüfen Sie zunächst im Dry-Run, welche Inhalte kopiert und gelöscht werden. Löschvorgänge im Zielpfad müssen vom Ausführenden bestätigt werden.
rsync -avhn \
--exclude '.git' \
--exclude 'DerivedData' \
./Project/ user@host:~/Project/Notieren Sie auf dem Quellknoten Branch, Commit-Hash und nicht committete Änderungen. Prüfen Sie nach dem Klonen auf dem neuen Knoten den Hash und stellen Sie erst danach Abhängigkeiten wieder her. Verwenden Sie keine Archive als Ersatz für Versionsdaten.
git status --short
git rev-parse HEAD
git clone repository-url
git checkout commit-hashPrüfen Sie die Liste vor dem Export und entfernen Sie nicht mehr benötigte Software. Verifizieren Sie nach der Wiederherstellung jede Kommandozeilenversion; ein erfolgreicher Installationsbefehl beweist keine funktionsfähige Umgebung.
brew bundle dump --file Brewfile
brew bundle check --file Brewfile
brew bundle install --file BrewfileSSH-Private-Keys, Repository-Token, Signiermaterial, Umgebungsdateien und Dienstschlüssel dürfen nicht mit dem Projektverzeichnis kopiert werden. Konfigurieren Sie sie nach Prüfung der geringsten erforderlichen Berechtigungen über den vom Team freigegebenen sicheren Prozess neu.
Bearbeiten Sie alle fünf Problemarten in dieser Reihenfolge: Symptom bestätigen, minimales Kommando ausführen, Ergebnis dokumentieren, unwirksame Änderungen stoppen. Öffnen Sie den jeweiligen Punkt für die Checkliste.
chmod 600 aus, um die lokalen Berechtigungen des privaten Schlüssels zu prüfen, und stellen Sie sicher, dass der im Befehl angegebene Schlüsselpfad vorhanden ist.ssh -vvv für die Verbindungsphase. Entfernen Sie vor dem Ticket persönliche Daten aus vollständiger Adresse, Benutzername und Schlüsselpfad.set -o pipefail für den echten Exit-Code und exportieren Sie .xcresult oder vollständige Logs.df -h aus, um freien Speicher des Volumes zu prüfen, und verwenden Sie anschließend du -sh zur Lokalisierung von Workspace, DerivedData, Archiven und Abhängigkeits-Caches.uptimeausführen und Startzeit mit dem Zeitpunkt des Problems abgleichen.Fragen zu bestehenden Bestellungen, Knotenstatus und Verlängerungen bitte bevorzugt als Konsolen-Ticket senden. Konfigurations- und Nutzungsfragen vor der Bestellung können per E-Mail gestellt werden. Die einzige Kontaktadresse ist support@oncemac.com.
Bestellnummer, Konfigurationsname und Knotenregion angeben; keine Zahlungsnachweise oder vollständigen Abrechnungsdaten senden.
Zeitzone, Zeitpunkt des ersten Auftretens, letzte Reproduktion und Dauer des Problems angeben.
Befehle, erwartetes Ergebnis, tatsächliches Ergebnis und Exit-Code auflisten – nicht nur „funktioniert nicht“ schreiben.
Fehlerkontext beibehalten, Schlüssel, Token, Passwörter, vollständige IP-Adressen, Signiermaterial und Geschäftsdaten entfernen.
Geprüfte Netzwerke, Versionen, Pfade, Speicher- und Wiederholungsergebnisse nennen, damit unwirksame Schritte nicht wiederholt werden.
Geeignet für Knotenverbindung, Build-Fehler, Abrechnung, Verlängerung und Bestellstatus. Das Ticket wird dem angemeldeten Konto zugeordnet, damit der Instanzkontext geprüft werden kann.
Konsole öffnenBitte Zweck, Zielknoten, Xcode-Version, Anzahl paralleler Builds, Speicherbedarf und gewünschten Aktivierungszeitpunkt angeben.
support@oncemac.comOnceMac bietet 3 verfügbare Konfigurationen und 6 Knoten, die 365 Tage im Jahr durchgehend betrieben werden. Alle Bestellungen werden in US-Dollar abgerechnet; Bestellungen, Knoten und Tickets lassen sich zentral in der Konsole verwalten.