Verbindungs- und Build-Support

Erst Fakten sichern,
dann Cloud-Mac-Probleme lösen.

Praxisleitfäden für Erstverbindungen, VNC-Sitzungen, Xcode-Builds und Bestellfragen. Prüfe lokales Netzwerk, Knotenstatus, Zugangsdaten, Client und Task-Protokolle Schritt für Schritt statt ungezielt erneut zu verbinden.

Verfügbare Knoten
6 Regionen
Verfügbare Konfigurationen
2 Modelle
Wichtig bereithalten
Region, Zeit, Fehlertext
CASE ROUTING / BAMINI

Probleme einordnen

Einreichbar
01 / KONTEXT Bestellung und Knoten Modell, Region und aktuellen Knotenstatus bestätigen
02 / ZUGANG Verbindung und Zugangsdaten Adresse, Benutzername und Client-Version prüfen
03 / NACHWEISE Protokoll und Zeit Vollständigen Fehlertext und Zeitpunkt des Fehlschlags sichern
04 / ROUTING Selbst prüfen oder Ticket Reproduzierbare Probleme über die Konsole als Ticket einreichen
Keine Kontopasswörter, Wiederherstellungscodes oder privaten Schlüssel einreichen STATUS / BEREIT
Erstnutzung

Vom verfügbaren Knoten bis zum geprüften Desktop

Jeder Schritt hat ein klares Prüfergebnis. Wenn ein Schritt fehlschlägt, sichere zuerst die Situation und ändere nicht mehrere Variablen gleichzeitig.

Knotenstatus prüfen

Melde dich in der Konsole an, öffne die passende Bestellung, bestätige den verbindungsbereiten Knoten und prüfe, ob Region und Kaufangabe übereinstimmen.

  • Bestellnummer korrekt
  • Modell und Region stimmen überein
  • Knoten verfügbar

Verbindungsdaten abrufen

Kopiere Serveradresse, Benutzernamen und Zugangsdaten getrennt. Führe Felder nicht zusammen und teile sie nicht in öffentlichen Dokumenten oder Chats.

  • Adresse ohne überflüssige Leerzeichen
  • Benutzername separat erfasst
  • Zugangsdaten gehören zur aktuellen Bestellung

VNC-Sitzung herstellen

Gib Zieladresse und Benutzernamen in einem vertrauenswürdigen VNC-Client ein. Stelle die Sitzung zunächst mit Standardqualität her und passe Auflösung und Farbtiefe anschließend an das Netzwerk an.

  • Unterstützte Client-Version
  • Lokales Netzwerk erlaubt die Verbindung
  • Fehlertext vollständig gesichert

Desktop-Erstprüfung abschließen

Prüfe nach dem Öffnen der macOS-Oberfläche Tastatureingabe, Anzeigeskalierung, Terminal und Projektverzeichnis, bevor du Repository oder Runner startest.

  • Eingabe und Anzeige funktionieren
  • Terminalbefehle ausführbar
  • Projektverzeichnis les- und beschreibbar
Reihenfolge bei Verbindungsproblemen

Immer nur eine Verbindungsebene prüfen

Bestimme zuerst, ob das Problem lokal, bei den Zieldaten, Zugangsdaten, im Client oder in einer bestehenden Sitzung liegt. Dokumentierte Einzelergebnisse sind hilfreicher als ständiges Neuverbinden.

Schrittweise VNC-Verbindungsprüfung
Schritt Prüfobjekt Konkrete Aktion Zu dokumentieren Erfolgskriterium
01 Lokales Netzwerk Wechsle zu einem bekannten stabilen Netzwerk und prüfe, ob Firewall oder Proxy die VNC-Verbindung blockieren. Netzwerktyp, Proxy-Nutzung, Fehlerzeit Zieladresse im selben Netzwerk erreichbar
02 Zieladresse Kopiere die Serveradresse erneut aus der aktuellen Bestellung, nicht aus alten Screenshots oder einer anderen Bestellung. Bestellnummer, Knotenregion, Quelle des Adressfelds Adresse stimmt mit dem aktuellen Knoten überein
03 Verbindungsdaten Prüfe Benutzername und Zugangsdaten getrennt auf Leerzeichen oder Zeilenumbrüche vor und nach dem Kopieren. Fehlertext, kein echtes Passwort Client meldet keinen Authentifizierungsfehler mehr
04 Client-Version Notiere Clientname, Version und Anzeigeeinstellungen; prüfe bei Bedarf mit einem zweiten vertrauenswürdigen Client. Client-Version, Betriebssystemversion, Qualitätseinstellungen Stabile Sitzung mit denselben Daten
05 Sitzungsstatus Prüfe belegte Sitzungen, eingefrorene Anzeige und ungültige Verbindungen, die der Client noch hält. Aktion vor Abbruch, Wiederverbindung, Sitzungszeit Nach Schließen alter Sitzungen erneut verbindbar
Leistungsprobleme getrennt dokumentieren

Eingabelatenz, langsame Bildaktualisierung und Build-Dauer sind drei verschiedene Messwerte. Dokumentiere Netzwerkbedingungen, VNC-Qualität und Task-Protokoll getrennt, statt alles der Knotenleistung zuzuschreiben.

Build-Task prüfen

Projektkonfiguration und Knoten-Umgebung unterscheiden

Sichere zuerst den fehlgeschlagenen Ablauf und erstelle dann eine minimale Reproduktion. Alle sechs Punkte müssen aus demselben fehlgeschlagenen Task stammen.

BUILD / VERSION

Xcode- und Tool-Versionen

Notiere die vollständige Xcode-Version, die Auswahl der Kommandozeilenwerkzeuge und den tatsächlich verwendeten Build-Befehl.

Worauf achten Ob dasselbe Projekt mit fester Version wiederholt fehlschlägt.
BUILD / LOG

Vollständiges Projektprotokoll

Bewahre den Kontext vor und nach dem fehlgeschlagenen Schritt auf, statt nur die letzte Fehlermeldung zu kopieren.

Worauf achten Ob der Fehler aus Abhängigkeiten, Kompilierung, Tests, Export oder Skriptphase stammt.
BUILD / TIME

Zeitpunkt des Fehlschlags

Notiere Zeitzone, Startzeit, Fehlerzeit und Task-Dauer, damit sie dem Knotenprotokoll zugeordnet werden können.

Worauf achten Ob das Problem bei einem festen Schritt oder nach einer festen Laufzeit auftritt.
RUNNER / LABEL

Runner-Label und Verzeichnis

Bestätige, dass der Workflow das erwartete Label trifft, und notiere Arbeits-, Cache-Verzeichnis und Ausführungskonto.

Worauf achten Ob der Task an den richtigen self-hosted Runner geleitet wurde.
REPRO / STEPS

Minimale Reproduktionsschritte

Entferne irrelevante Skripte und parallele Tasks und reproduziere denselben Fehler mit möglichst wenigen Befehlen.

Worauf achten Ob der Fehler von Projektkonfiguration, Cache oder Umgebungsvariablen abhängt.
COMPARE / RESULT

Vergleichsergebnis

Teste auf demselben Knoten in einem sauberen Arbeitsverzeichnis erneut oder führe ein Minimalbeispiel mit derselben Toolchain aus.

Worauf achten Wenn auch das Minimalbeispiel fehlschlägt, reiche ein Ticket zur Knoten-Umgebung ein.
Hinweise auf die Projektkonfiguration

Nur bestimmte Branches, Abhängigkeiten, Caches oder Skripte schlagen fehl; ein sauberes Beispiel läuft.

Hinweise auf die Knoten-Umgebung

Mehrere unabhängige Projekte scheitern beim selben Toolschritt, und das Minimalbeispiel lässt sich stabil reproduzieren.

Technisches Glossar

Im Ticket einheitliche Begriffe verwenden

Klare Begriffe vermeiden Rückfragen durch wechselnde Bezeichnungen wie Maschine, Instanz und Server.

Physischer Knoten
Physischer Mac mini für macOS und Entwicklungsaufgaben. Status, Region und Verbindungsdaten sind mit der jeweiligen Bestellung verknüpft.
Dedizierter physischer Rechner
Eine Bestellung entspricht einer unabhängig genutzten physischen Ressource; dieselbe Betriebssystemumgebung wird nicht mit anderen Kunden geteilt.
Keine virtuelle Maschine
Bereitgestellt wird eine macOS-Umgebung auf echter Hardware, keine aus einem gemeinsam genutzten Host abgetrennte virtuelle Instanz.
VNC
Verbindung zum Anzeigen und Bedienen eines entfernten grafischen Desktops. Qualität, Skalierung und Eingabelatenz hängen von Netzwerk und Client-Einstellungen ab.
Self-hosted Runner
Automatischer Task-Runner auf dem gemieteten Cloud-Mac, den das Team selbst registriert und verwaltet.
Abrechnungszeitraum
Für die Bestellung gewählter Tages-, Wochen-, Monats- oder Quartalszeitraum. Bei der Abrechnung Modell, Zeitraum und Zusatzoptionen gemeinsam angeben.
Knotenregion
Service-Region des Geräts. BAMini bietet Knoten in Singapur, Tokio, Seoul, Hongkong, US-Ostküste und US-Westküste – insgesamt 6 Regionen.
Thunderbolt-5-Parallelschaltung
Zusätzliche Verbindungsfunktion, die pro Gerät gewählt wird. Bei Anfragen Geräteanzahl und Verbindungstopologie angeben.
Vor dem Einreichen vorbereiten

Damit der Support reproduzieren und prüfen kann

Eine bearbeitbare Anfrage braucht Bestellkontext, Zeitpunkt, vollständigen Fehler und bereits getestete Schritte. Vertrauliche Zugangsdaten gehören nicht in die Diagnoseunterlagen.

SUPPORT REQUEST / REQUIRED FIELDS

Checkliste zum Problem

7 Punkte
01 Bestellnummer

Dient zur Zuordnung der Bestellung; nicht nur den Modellnamen angeben.

02 Knotenregion

Singapur, Tokio, Seoul, Hongkong, US-Ostküste oder US-Westküste angeben.

03 Verfügbares Modell

BookAMini M4 Core oder BookAMini M4 Plus angeben.

04 Zeitpunkt des Auftretens

Datum, Uhrzeit und Zeitzone angeben, damit der Eintrag dem Knotenprotokoll zugeordnet werden kann.

05 Vollständiger Fehlertext

Originaltext kopieren und Fehlercode sowie Kontext erhalten, statt nur „funktioniert nicht“ zu schreiben.

06 Bereits getestete Schritte

In Ausführungsreihenfolge auflisten und das Ergebnis jedes Schritts nennen.

07 Reproduzierbarkeit

Angeben, ob der Fehler immer, gelegentlich oder nur bei bestimmten Projekten und Netzwerken auftritt.

Support eskalieren

Wenn die Selbstprüfung nicht reicht: Konsolen-Ticket einreichen

Probleme bestehender Bestellungen gehören bevorzugt in ein Konsolen-Ticket, damit Bestellung, Knoten und Ergänzungen verknüpft werden können. Wenn du dich nicht anmelden kannst, nutze die Support-E-Mail.

01 / EINGANG

Problem und Kontext einreichen

Erstelle in der Konsole ein Ticket, wähle die passende Bestellung und füge Region, Modell, Zeit, Fehlertext, Protokollauszüge und Reproduktionsschritte hinzu.

02 / KLASSIFIZIERUNG

Verbindung, Umgebung oder Abrechnung unterscheiden

Der Support grenzt den Bereich anhand der Nachweise ein. Bei fehlenden Angaben nennt das Ticket die konkret benötigten Felder.

03 / ERGÄNZUNG

Im bestehenden Ticket antworten

Gib bei neuen Protokollen Zeitpunkt und Testbedingungen an und erstelle für dasselbe Problem kein weiteres Ticket.

04 / BEARBEITUNG

Ergebnis und nächste Schritte ansehen

Prüfe in der Konsole Bearbeitungsstand, empfohlene Maßnahmen und zu bestätigende Ergebnisse. Bestätige nach der Prüfung im ursprünglichen Eintrag, ob das Problem behoben ist.

TICKET

Bestehende Bestellung oder Knoten

Reiche ein Konsolen-Ticket ein und verknüpfe die passende Bestellung.

Konsole öffnen
E-MAIL

Anmeldung an der Konsole nicht möglich

Schreibe von der E-Mail-Adresse deines Kontos und nenne Bestellnummer sowie das Anmeldeproblem.

support@bookamini.com
Build vorbereiten

Wähle aus 6 Knoten und zwei Modellen mit dedizierter physischer Hardware.

BookAMini M4 Core und BookAMini M4 Plus sind Cloud-Macs mit dedizierter physischer Hardware und keine virtuellen Maschinen. Bestellungen werden in USD abgerechnet; die Verfügbarkeit in der Konsole ist maßgeblich.