Öffentliche Anleitung — Abonnementfreigabe, Registrierung eines SSH-Schlüssels und Yocto-Quellcodezugriff mit Git und Repo.
Nach Bestätigung des Abonnements lädt LinRT HelpDesk die vom Kunden benannten Personen einzeln ein (je nach Supportstufe maximal ein bis drei Benutzer). Der Zugriff ist personenbezogen und auf die freigegebenen Repositories und Branches begrenzt. Ein HelpDesk-Konto allein gewährt keinen Git-Zugriff.
Jeder benannte Benutzer erhält eine Einladungs-E-Mail vom LinRT-Support, legt über den Aktivierungslink ein eigenes Passwort fest und vervollständigt sein Profil. Falls die Nachricht fehlt, Spamordner prüfen und das offizielle Portal verwenden. HelpDesk-Passwörter nicht weitergeben.
Die Beispiele gelten für Linux-/macOS-Terminals sowie Git Bash unter Windows mit OpenSSH. Benötigt werden Git, OpenSSH und für Yocto-Multi-Repository-Checkouts das Google-Tool Repo. Versionen prüfen:
ssh -V git --version
Jeder berechtigte Benutzer sollte ein eigenes Schlüsselpaar nutzen, möglichst je Rechner. Das aktuelle HelpDesk-Ticket heißt „RSA Key soumission“, daher verwendet das Beispiel RSA mit 4096 Bit. Bitbucket Cloud unterstützt auch Ed25519; die Freigabe dafür vorher bei LinRT erfragen. Eine sichere Passphrase vergeben und vorhandene Schlüssel nicht überschreiben.
mkdir -p "$HOME/.ssh" chmod 700 "$HOME/.ssh" ssh-keygen -t rsa -b 4096 -C "user@company.example" -f "$HOME/.ssh/linrt_bitbucket"
Dabei entstehen ein privater Schlüssel linrt_bitbucket (geheim halten) und ein öffentlicher Schlüssel linrt_bitbucket.pub (weitergeben). Privaten Schlüssel in den lokalen SSH-Agent laden:
eval "$(ssh-agent -s)" ssh-add "$HOME/.ssh/linrt_bitbucket"
Im LinRT HelpDesk ein Ticket mit dem Thema RSA Key soumission eröffnen. Firmenname, registrierte E-Mail-Adresse des berechtigten Benutzers und die vollständige Zeile aus der .pub-Datei übermitteln; optional den SHA256-Fingerabdruck. Niemals privaten Schlüssel, Passphrase, Passwort oder den kompletten .ssh-Ordner senden.
cat "$HOME/.ssh/linrt_bitbucket.pub" ssh-keygen -lf "$HOME/.ssh/linrt_bitbucket.pub"
Der LinRT-Support prüft die Anfrage, registriert den öffentlichen Schlüssel im LinRT-Bitbucket-Dienst und bestätigt die Einrichtung der relevanten Repository-Berechtigungen. Schlüsselregistrierung und Repository-Freigabe sind getrennte Prüfungen.
Die Verbindung mit dem zugehörigen privaten Schlüssel testen. Bei der ersten Verbindung den Host-Key-Fingerabdruck mit der offiziellen Atlassian-Referenz vergleichen, bevor er akzeptiert wird.
ssh -T -i "$HOME/.ssh/linrt_bitbucket" -o IdentitiesOnly=yes git@bitbucket.org
Eine erfolgreiche Bitbucket-Cloud-Verbindung meldet normalerweise:
authenticated via ssh key. You can use git to connect to Bitbucket. Shell access is disabled
„Shell access is disabled“ ist korrekt: Bitbucket bietet Git über SSH, aber keine interaktive Shell. Erfolgreiche SSH-Anmeldung bedeutet nicht automatisch Zugriff auf alle privaten Repositories. Das berechtigte Manifest-Repository gesondert testen:
git ls-remote git@bitbucket.org:linrt/linrt-multifb-oxygen-manifest.git
Beispielsweise lässt sich das LinRT-Oxygen-Manifest-Repository per HTTPS klonen. Wichtig: HTTPS- und SSH-Authentifizierung sind unabhängig. Der Befehl lädt nur das Manifest-Repository, nicht die gesamte Yocto-Quellcodebasis:
git clone https://bitbucket.org/linrt/linrt-multifb-oxygen-manifest.git
Wenn SSH freigegeben ist, stattdessen die SSH-Adresse verwenden:
git clone git@bitbucket.org:linrt/linrt-multifb-oxygen-manifest.git
Repo liest das Manifest und ruft die aufgeführten Git-Projekte ab. Befehle in einem neuen leeren Verzeichnis ausführen. Das Beispiel nutzt den Standard-Branch. Für konkrete Oxygen-5.x-/6.x-Versionen ausschließlich den von LinRT-Support freigegebenen Branch und die XML-Datei verwenden.
mkdir -p "$HOME/linrt/oxygen-sources" cd "$HOME/linrt/oxygen-sources" repo init -u git@bitbucket.org:linrt/linrt-multifb-oxygen-manifest.git repo sync -j4
Im Manifest können mehrere Repositories mit unterschiedlichen Protokollen referenziert sein. HTTPS-Klonen des Manifests richtet nicht automatisch SSH-Zugriff auf andere Repositories ein.
Nur öffentliche Schlüssel weitergeben. Private Schlüssel per Passphrase sichern, keine gemeinsam genutzten Benutzerkonten verwenden und beim Benutzerwechsel oder Geräteverlust die Sperrung über HelpDesk veranlassen. HelpDesk-Passwort und Bitbucket-SSH-Schlüssel erfüllen unterschiedliche Aufgaben.
Öffentliche Einrichtungsanleitung. Repository- und Branch-Zugriff hängen vom Abonnement und den erteilten Berechtigungen ab.