Von der Bereitstellung zum Einsatz

Ihre Maschine lässt sich nicht verbinden?
Hier finden Sie den Fehler

Hier finden Sie Anleitungen zur Verbindung mit Ihrem dedizierten Cloud-Mac und zur Einrichtung der Entwicklungsumgebung. Prüfen Sie zuerst die im Portal hinterlegten Bereitstellungsdaten und anschließend Ihre Toolchain und Aufgaben. Ihr Knoten ist ein dedizierter physischer Rechner, keine virtuelle Maschine. Sie können sowohl die grafische Oberfläche als auch die Kommandozeile nutzen.

Wenn Sie bereits bestellt haben, öffnen Sie die Instanzdetails. Maßgeblich sind die aktuell im Portal angezeigte Adresse, der Benutzername, der Port und der Bereitstellungsstatus.

Erste Verbindung

Verbindungsdaten abrufen und Verbindungsmethode wählen

Der Remote Desktop eignet sich zum Prüfen des Systems, Einrichten von Xcode und Arbeiten mit grafischen Oberflächen. SSH ist ideal zum Abrufen von Code, Ausführen von Builds und Lesen von Protokollen. Beide Methoden verbinden Sie mit derselben Maschine. Sie müssen Ihr Projekt also nicht doppelt kopieren.

Grafische Oberfläche

Bildschirmfreigabe / VNC

Die Adresse und Zugangsdaten für den Remote Desktop finden Sie in den Instanzdetails im Portal. Unter macOS können Sie die Bildschirmfreigabe verwenden; auf anderen Systemen benötigen Sie einen VNC-kompatiblen Client. Verwechseln Sie das SSH-Passwort nicht mit den separaten VNC-Zugangsdaten.

  1. Kopieren Sie Hostadresse, Remote-Desktop-Port und Benutzernamen. Achten Sie darauf, keine Leerzeichen mitzukopieren.
  2. Geben Sie Adresse und Port im Client ein. Der übliche VNC-Port ist 5900; verwenden Sie unbedingt den im Portal angegebenen Port.
  3. Folgen Sie den Bereitstellungshinweisen zur Anmeldung. Bei einem Authentifizierungsfehler prüfen Sie zuerst Benutzername und Art der Zugangsdaten und versuchen es dann erneut.
  4. Ändern Sie nach der Anmeldung am Desktop das anfängliche Systempasswort. Wenn Sie separate Zugangsdaten für den Remote Desktop verwenden, aktualisieren und speichern Sie diese ebenfalls gemäß den Instanzhinweisen.

Wenn der Desktop verzögert reagiert, reduzieren Sie zunächst die Bildqualität und deaktivieren Sie unnötige Animationen. Lassen Sie eine SSH-Verbindung geöffnet, um Netzwerk- von Grafikproblemen unterscheiden zu können.

Kommandozeile

SSH

Verwenden Sie das Systemterminal oder einen vertrauenswürdigen SSH-Client. Der übliche SSH-Port ist 22. Wenn in Ihren Bereitstellungsdaten ein anderer Port steht, geben Sie ihn mit dem Parameter -p im Verbindungsbefehl an.

  1. Rufen Sie Hostadresse, SSH-Port und Benutzernamen in den Instanzdetails ab. Verwenden Sie keine geratenen Standardkonten.
  2. Verbinden Sie sich mit ssh -p PORT USER@HOST und ersetzen Sie die Platzhalter in Großbuchstaben durch die bereitgestellten Werte.
  3. Prüfen Sie beim ersten Hinweis zum Hostschlüssel zunächst die vertrauenswürdigen Instanzdaten. Ändert sich der Fingerprint unerwartet, brechen Sie die Verbindung ab und erstellen Sie ein Supportticket.
  4. Ändern Sie nach der ersten Anmeldung mit passwd das anfängliche Passwort und richten Sie anschließend Ihren eigenen öffentlichen SSH-Schlüssel ein.

Ändern Sie die Passwort-Anmelderegeln erst, wenn die Anmeldung mit dem öffentlichen Schlüssel funktioniert. Lassen Sie vor Änderungen eine bestehende Sitzung geöffnet, damit Sie sich nicht selbst aussperren.

Gehen Sie von der Fehlermeldung aus – setzen Sie die Maschine nicht wiederholt zurück
Meldung oder Symptom Zuerst prüfen Dem Supportticket beifügen
Verbindungs-Timeout Ist die Instanz bereits bereitgestellt? Stimmen Adresse und Port? Erlauben Ihr lokales Netzwerk und die Firewall ausgehende Verbindungen? Testen Sie den Zugang über ein anderes Netzwerk. Knoten, Maschinennummer, Verbindungsmethode, Zeitpunkt des Fehlers und Zeitzone.
Authentifizierung fehlgeschlagen Ist der Benutzername korrekt? Verwenden Sie die richtigen Zugangsdaten? Wurde das Passwort bereits geändert? Veröffentlichen Sie Passwörter nicht in Protokollen oder Screenshots. Den vollständigen Fehlertext, den verwendeten Client und die Authentifizierungsmethode. Keine Passwörter oder privaten Schlüssel beifügen.
SSH funktioniert, Desktop bleibt schwarz Beenden Sie die grafische Sitzung und verbinden Sie sich erneut. Prüfen Sie, ob Ihr Client kompatibel ist. Beenden Sie zunächst keine laufenden Builds oder Tests. Clientversion, Screenshot des schwarzen Bildschirms, Status der SSH-Verbindung und zuletzt vorgenommene Änderungen an den Systemeinstellungen.
Host-Fingerprint hat sich geändert Gibt es eine bestätigte Mitteilung zu einem Maschinentausch oder Systemreset? Löschen Sie den lokalen Fingerprint-Eintrag erst, wenn Sie die Änderung bestätigt haben. Alten und neuen Fingerprint, Maschinennummer und die letzte Bereitstellungsmitteilung.
Startklar am ersten Tag

In etwa 4 Minuten die wichtigsten Grundlagen prüfen

Die folgenden Zeitangaben gelten bei bereitgestellter Umgebung, kleinem Repository und funktionierender Netzwerkverbindung. Das Herunterladen großer Projekte, die Xcode-Installation und das Kompilieren von Abhängigkeiten sind nicht eingerechnet. Erst prüfen, dann ausführen – überspringen Sie keine Sicherheitseinstellungen, um Zeit zu sparen.

  1. 01

    Passwort ändern und Firewall prüfen

    Ca. 1 Minute

    Ändern Sie das anfängliche Passwort und bewahren Sie die Zugangsdaten sicher auf. Aktivieren oder prüfen Sie die macOS-Firewallregeln und stellen Sie sicher, dass der von Ihnen verwendete Remotezugriff erlaubt ist. Deaktivieren Sie nicht pauschal alle Zugriffsmöglichkeiten, bevor Sie die Verbindung getestet haben.

  2. 02

    Xcode und Kommandozeilenwerkzeuge prüfen

    Ca. 2 Minuten

    Prüfen Sie die Xcode-Version in der grafischen Oberfläche und führen Sie dann xcode-select -p sowie xcodebuild -version aus. Benötigt Ihr Projekt eine bestimmte Version, wechseln Sie zuerst zur passenden Toolchain und starten Sie erst danach den Build.

  3. 03

    Repository abrufen und kleinen Testlauf starten

    Ca. 1 Minute

    Richten Sie Zugangsdaten mit den geringstmöglichen Berechtigungen für das Repository ein und rufen Sie den Code ab. Starten Sie zunächst einen kleinen Build oder Test, um Abhängigkeiten, Pfade und Schreibrechte zu prüfen. Führen Sie erst danach die vollständige Pipeline aus.

Die Prüfung ist abgeschlossen, wenn Sie sich erneut anmelden können, die Toolchain den Projektanforderungen entspricht, der Code lesbar ist und in das Build-Ausgabeverzeichnis geschrieben werden kann. Falls ein Punkt nicht erfüllt ist, beheben Sie zuerst dieses Problem.

Migration & CI

Erst Daten, dann Toolchain, zuletzt CI-Aufgaben migrieren

Teilen Sie die Migration in drei Schritte auf, damit sich Fehler leichter eingrenzen lassen. Übertragen Sie nicht pauschal lokale Caches, Binärdateien für alte Architekturen und aktive Signaturzugänge zusammen. Ihre Maschine kann eine stabile Entwicklungsumgebung behalten; die Berechtigungen für Aufgaben müssen Sie jedoch selbst einrichten.

01 / DATA

Daten

Übertragen Sie Projekte und Ressourcen mit rsync oder über ein externes Cloud-Laufwerk. Prüfen Sie zuerst den freien Speicherplatz und kopieren Sie dann Projekte, Medien und Archive in getrennten Schritten. Neu erstellbare Build-Ausgaben und Caches müssen Sie nicht zuerst migrieren.

Fügen Sie beim ersten rsync-Lauf am besten --dry-run hinzu, um die Änderungen vorab anzuzeigen. Beachten Sie, dass ein Schrägstrich am Ende des Quellpfads die Verzeichnisstruktur beim Kopieren beeinflusst. Verwenden Sie keine Option zum Löschen von Zieldateien, bevor Sie den Zielinhalt geprüft haben.

Erfolgreich, wenn die Projektstruktur vollständig ist, wichtige Ressourcen lesbar sind und Dateianzahl oder Prüfergebnisse den Erwartungen entsprechen.

02 / TOOLS

Toolchain

Prüfen Sie Versionen von Homebrew, Xcode, SDKs und Projektabhängigkeiten. Homebrew liegt auf Apple-Silicon-Systemen häufig unter /opt/homebrew. Übernehmen Sie keine absoluten Pfade von Ihrem lokalen Rechner.

Installieren Sie Abhängigkeiten anhand der Sperrdatei des Projekts neu. Prüfen Sie Signaturzertifikate, den zugehörigen privaten Schlüssel und Bereitstellungsprofile getrennt. Eine verfügbare grafische Oberfläche bedeutet nicht, dass ein CI-Prozess ohne Benutzeroberfläche Signierrechte besitzt.

Erfolgreich, wenn die Versionsbefehle funktionieren, ein lokaler Build durchläuft und Zertifikat sowie Bereitstellungsprofil zum aktuellen Projekt passen.

03 / CI

CI einrichten

Registrieren Sie einen selbst gehosteten Runner für GitHub Actions oder GitLab. Verwenden Sie dafür ein eigenes Systemkonto und ein Token mit möglichst geringen Berechtigungen. Ordnen Sie Runner-Tags und Projektaufgaben korrekt zu.

Starten Sie zuerst einen Prüflauf, der nur den Code liest und nicht signiert. Danach können Sie Tests und Releases hinzufügen. Prüfen Sie PATH, Arbeitsverzeichnis und Schlüsselbundzugriff des Runner-Prozesses – ein erfolgreicher Test im interaktiven Terminal allein reicht nicht aus.

Erfolgreich, wenn Aufgaben angenommen werden, die Protokolle vollständig sind und der Runner nach einem Neustart wie erwartet wieder eine Verbindung herstellt.

Ein Runner kann auf alle Repositories zugreifen, für die er Berechtigungen besitzt – und damit auch auf deren Code. Lassen Sie keine nicht vertrauenswürdigen Aufgaben in derselben Ausführungsumgebung wie Release-Signierungen laufen. Auch bei der Zusammenarbeit mehrerer Personen sollte nicht dasselbe Systemkonto gemeinsam genutzt werden.

Xcode & Signierung

Das Zertifikat liegt auf der Maschine – der Prozess braucht ebenfalls Zugriff

Prüfen Sie bei Signierfehlern zuerst Zertifikat, privaten Schlüssel, Bereitstellungsprofil und Prozessberechtigungen. Importieren Sie dieselbe Datei nicht wiederholt und legen Sie private Schlüssel weder im Code-Repository noch als Ticketanhang ab.

Warum wird die Signieridentität nach dem Zertifikatsimport nicht gefunden?

Prüfen Sie zuerst in der Schlüsselbundverwaltung, ob dem Zertifikat der zugehörige private Schlüssel zugeordnet ist. Ohne privaten Schlüssel lässt sich mit einer Zertifikatsdatei allein nicht signieren. Wenn Sie eine Exportdatei mit privatem Schlüssel verwenden, prüfen Sie das Exportpasswort und den Zielschlüsselbund. Kontrollieren Sie anschließend die Gültigkeitsdauer des Zertifikats.

Führen Sie danach security find-identity -v -p codesigning aus, um die für den aktuellen Benutzer verfügbaren Signieridentitäten anzuzeigen. Weichen die Ergebnisse von der grafischen Oberfläche ab, prüfen Sie zuerst den ausführenden Benutzer und die Schlüsselbund-Suchliste, statt sofort das Maschinenmodell zu wechseln.

Zertifikat gültig, aber das Build meldet ein nicht passendes Bereitstellungsprofil?

Prüfen Sie Bundle Identifier, Team-ID, Build-Typ und Gültigkeitsdauer des Bereitstellungsprofils. Für Entwicklung und Veröffentlichung können unterschiedliche Profile erforderlich sein. Bei Tests auf Geräten muss das jeweilige Gerät außerdem im passenden Profil enthalten sein.

Prüfen Sie zunächst eine eindeutig festgelegte Build-Konfiguration. Bei Projekten mit mehreren Targets müssen Sie die Signiereinstellungen einzeln kontrollieren, damit Hauptanwendung und Erweiterungen nicht unterschiedliche Teams oder abgelaufene Dateien verwenden.

Das Signieren funktioniert im Terminal. Warum schlägt es in CI fehl?

CI läuft möglicherweise unter einem anderen Benutzer, mit anderen Umgebungsvariablen oder in einer Sitzung ohne Benutzeroberfläche. Prüfen Sie, ob der tatsächlich verwendete Schlüsselbund entsperrt ist, die Signieridentität enthält und das Signierwerkzeug auf den privaten Schlüssel zugreifen darf.

Hinterlegen Sie notwendige Zugangsdaten in den geschützten CI-Secrets, nicht im Skripttext. Führen Sie einen minimalen Signiertest mit dem Runner-Benutzer aus und notieren Sie, in welchem Schritt der Fehler auftritt. Stellen Sie dem Support nur bereinigte Fehlermeldungen bereit – niemals Schlüsselbund- oder Exportpasswörter oder private Schlüssel.

Wie lassen sich Berechtigungen auf einem gemeinsam genutzten physischen Knoten trennen?

Richten Sie für jedes Teammitglied ein eigenes Systemkonto ein und vergeben Sie Verzeichnis- und Schlüsselbundberechtigungen nach Aufgabenbereich. Automatisierte Aufgaben sollten unter einem eigenen Runner-Konto laufen. Klären Sie bei Übergaben, wer die grafische Sitzung verwendet, und wechseln Sie nicht während eines fremden Builds die Toolchain oder leeren Sie gemeinsam genutzte Verzeichnisse.

Diese Maßnahmen verringern das Risiko versehentlicher Änderungen. Dennoch teilen sich alle Benutzer desselben Rechners CPU, Arbeitsspeicher und Festplatte. Für Projekte mit strengen Trennungsanforderungen, nicht vertrauenswürdige Aufgaben oder stabile parallele Releases sollten Sie separate Knoten verwenden.

Leistung & Speicher

Erst den Engpass finden, dann gezielt aufrüsten

Ein langsamer Build liegt nicht zwangsläufig am Chip. Prüfen Sie in der Aktivitätsanzeige zuerst Speicherdruck und CPU-Auslastung, danach freien Speicherplatz, Downloads von Abhängigkeiten und die Zahl gleichzeitig laufender Aufgaben. Vergleichen Sie stets dasselbe Projekt mit derselben Build-Konfiguration.

Simulatoren und Build-Caches belegen die Festplatte. Was lässt sich zuerst löschen?

Prüfen Sie mit df -h zuerst den verfügbaren Speicherplatz. Suchen Sie dann in Xcode nach nicht mehr verwendeten Simulator-Laufzeitumgebungen und Build-Archiven. DerivedData lässt sich neu erstellen; nach dem Löschen muss der nächste Build die Caches jedoch erneut aufbauen. Unterbrechen Sie laufende Aufgaben des Projekts vor dem Bereinigen.

Mit xcrun simctl list devices können Sie die Geräte prüfen. Löschen Sie nicht mehr benötigte, nicht verfügbare Geräte mit xcrun simctl delete unavailable. Dabei können Testdaten im Simulator verloren gehen. Exportieren Sie wichtige Daten deshalb vorher.

Wann lohnt sich eine zusätzliche 1-TB- oder 2-TB-SSD?

Eine Erweiterung lohnt sich, wenn Projekte, mehrere Simulator-Laufzeitumgebungen, Container-Images und Medien dauerhaft gespeichert werden müssen und der Speicherplatz trotz Bereinigung neu erstellbarer Caches dauerhaft knapp wird. Eine zusätzliche 1-TB-SSD kostet $2.2/Tag, eine 2-TB-SSD $4.4/Tag. Preise für andere Laufzeiten finden Sie bei der Konfiguration Ihrer Bestellung.

Mehr Speicherplatz löst kein Arbeitsspeicherproblem. Wenn mehrere Aufgaben parallel laufen und der Speicherdruck dauerhaft hoch ist, reduzieren Sie zunächst die Parallelität oder prüfen Sie eine passendere Konfiguration.

Builds und Inferenz: Welche der drei Konfigurationen passt?

Hold 16 bietet einen M4, 16 GB Arbeitsspeicher und eine 256-GB-SSD. Die Konfiguration eignet sich für kleinere Builds und CI für ein einzelnes Projekt. Hold 24 bietet einen M4, 24 GB Arbeitsspeicher und eine 512-GB-SSD – mehr Spielraum für die tägliche Xcode-Entwicklung, mehrere Simulatoren und UI-Tests.

Hold Pro 64 bietet einen M4 Pro, 64 GB Arbeitsspeicher und eine 2-TB-SSD. Die Konfiguration eignet sich für große Projekte und MLX-Experimente. Ob ein Modell ausgeführt werden kann, hängt weiterhin von Modellgröße, Quantisierung und Kontextbedarf ab. Der Modellname allein ersetzt keinen Praxistest.

Für welche Aufgaben eignet sich die Kopplung über Thunderbolt 5?

Sie eignet sich, wenn Sie bereits mehrere Knoten nutzen und Ihr Software-Workflow die Zusammenarbeit zwischen Maschinen unterstützt. Diese Zusatzoption kostet $1.5/Tag pro Maschine. Geben Sie bei der Konfiguration die Zahl der beteiligten Knoten, die Art des Datenaustauschs und die Anforderungen Ihrer Anwendung an. Der Support hilft Ihnen zu klären, ob die Voraussetzungen erfüllt sind.

Die Kopplung macht aus mehreren Maschinen weder automatisch einen Mac mit mehr Arbeitsspeicher noch teilt sie gewöhnliche Build-Aufgaben automatisch auf. Prüfen Sie zuerst, ob Ihre Anwendung die Zusammenarbeit unterstützt.

Abrechnung & Verlängerung

Prüfen Sie Bestellung und Laufzeit, bevor Sie verlängern

Sie können tage-, wochen-, monats- oder quartalsweise mieten. Abgerechnet wird ausschließlich in US-Dollar. Für Bestellungen, Ablaufdatum, Zusatzoptionen und Zahlungsstatus sind die Angaben im Portal maßgeblich. Verlassen Sie sich nach einer Zahlung nicht allein auf den Hinweis Ihres Clients, dass die Laufzeit verlängert wurde.

Wo kann ich Ablaufdatum und Verlängerungsstatus prüfen?

Melden Sie sich im Portal an und prüfen Sie Ablaufdatum, Rechnungen und Verlängerungsmöglichkeit des entsprechenden Abonnements. Achten Sie außerdem auf Ablaufhinweise per E-Mail an Ihre Konto-E-Mail-Adresse. Stellen Sie sicher, dass Sie dort Nachrichten empfangen können. Der tatsächliche Zeitpunkt der Hinweise richtet sich nach der jeweiligen Benachrichtigung. Warten Sie nicht auf eine einzelne Erinnerung, um die Verlängerung erst im letzten Moment zu planen.

Kehren Sie nach der Zahlung zum ursprünglichen Abonnement zurück und prüfen Sie das neue Ablaufdatum. Wenn die Rechnung bezahlt ist, sich die Laufzeit aber nicht geändert hat, senden Sie dem Support die Rechnungsnummer und den Zahlungsnachweis. Bezahlen Sie dieselbe Rechnung nicht erneut.

Ändern sich die Verbindungsdaten nach einer Verlängerung?

Bei einer normalen Verlängerung derselben Instanz verwenden Sie weiterhin die aktuellen Verbindungsdaten aus den Instanzdetails. Eine Verlängerung setzt das System nicht zurück. Bei einem Maschinentausch, einer Neuerstellung oder einer anderen Änderung der Bereitstellung gelten die neuen Verbindungsdaten und Mitteilungen im Portal.

Wenn die Miete bereits beendet wurde und die Rücknahme läuft, ist eine Verlängerung keine Möglichkeit, Daten wiederherzustellen. Exportieren Sie Projekte, Zertifikatsicherungen und nicht erneut erstellbare Ressourcen vor Ablauf. Das Löschen der Festplatte nach der Rücknahme lässt sich nicht durch eine neue Bestellung rückgängig machen.

Welche Zahlungsmethoden werden akzeptiert?

Akzeptiert werden ausschließlich USDT-TRC20 sowie Visa / Mastercard / Amex über Stripe. Alle Beträge werden in US-Dollar (USD) abgerechnet. Welche Zahlungs-Gateways verfügbar sind, richtet sich nach der Antwort der Backend-Schnittstelle.

Prüfen Sie bei USDT-TRC20 im Zahlungsfenster Netzwerk, Adresse und Betrag sorgfältig. Bei Kartenzahlung schließen Sie die erforderliche Verifizierung gemäß den Vorgaben des Gateways ab. Bei Zahlungsfragen können Sie den Transaktions-Hash oder die Rechnungsnummer angeben. Teilen Sie niemals die vollständige Kartennummer, den Sicherheitscode oder den privaten Wallet-Schlüssel mit.

Konfiguration oder Zusatzspeicher ändern – soll ich einfach neu bestellen?

Notieren Sie zunächst die aktuelle Instanznummer, die gewünschte Konfiguration und einen Zeitraum, in dem die Aufgaben pausiert werden können. Erstellen Sie dann über das Portal ein Supportticket. Klären Sie vor der Umsetzung, ob eine Migration erforderlich ist, die bisherigen Verbindungsdaten erhalten bleiben können und wann die Änderung wirksam wird.

Bei zusätzlichem Speicher hängen Datenpfade davon ab. Übertragen Sie die Inhalte vor einer Kündigung und prüfen Sie die Anwendungseinstellungen. Gehen Sie nicht davon aus, dass Änderungen sofort umgesetzt werden, alle Daten automatisch erhalten bleiben oder automatisch eine Erstattung erfolgt. Maßgeblich sind die Bestellbedingungen und die bestätigte Vorgehensweise.

Noch keine Lösung? Beschreiben Sie das Problem möglichst genau

Bei Problemen mit einer bestehenden Instanz melden Sie sich im Portal an und erstellen Sie ein Supportticket. Geben Sie Maschinennummer und Knoten, Zeitpunkt des Fehlers samt Zeitzone, den letzten Zeitpunkt, zu dem die Maschine noch funktionierte, und bereits unternommene Schritte an. Bereinigte Protokolle helfen mehr als eine Meldung wie „Verbindung fehlgeschlagen“.

Den Bearbeitungsstand sehen Sie im Supportticket im Portal. Die Antwortzeit hängt von Art und Umfang der Fehleranalyse ab; eine feste Minutenzahl können wir auf dieser Seite nicht zusagen. Bei Fragen vor dem Kauf, zur Teamkonfiguration oder bei Problemen mit der Anmeldung wenden Sie sich an support@vpshold.com.