Zugriff auf die LinRT BSP-Quellcode-Repositories
Öffentliche Anleitung — Abonnementfreigabe, Registrierung eines SSH-Schlüssels und Yocto-Quellcodezugriff mit Git und Repo.
Ablaufübersicht für den Quellcodezugriff
Wer kann Zugriff erhalten?
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.
1. LinRT HelpDesk-Konto aktivieren
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.
2. Entwicklungsrechner vorbereiten
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
3. Persönliches SSH-Schlüsselpaar erzeugen
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"
4. HelpDesk-Ticket „RSA Key soumission“ eröffnen
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"
5. Bestätigung vom LinRT-Support abwarten
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.
6. SSH-Authentifizierung testen
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
7. Manifest-Repository abrufen
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
8. Yocto-Quellcode mit Repo initialisieren und synchronisieren
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.
Prüfliste
- HelpDesk-Konto aktiviert
- Öffentlichen Schlüssel per RSA Key soumission übermittelt
- Bestätigung vom Support erhalten
- SSH-Test erfolgreich
- Manifest-Repository lesbar
- Repo-Synchronisierung mit freigegebenem Branch
Fehlerbehebung
- Permission denied (publickey): Schlüsselregistrierung, geladene Identitäten und Support-Freigabe prüfen.
- SSH funktioniert, Git-Repository nicht: URL und spezielle Repository-/Branch-Rechte prüfen.
- HTTPS verlangt Anmeldedaten: SSH-Schlüssel gelten nicht für HTTPS; SSH-URL oder freigegebenes HTTPS-Verfahren nutzen.
- Host key verification failed: Verbindung abbrechen und Host-Fingerabdruck mit Atlassian abgleichen.
- repo sync schlägt fehl: Manifest, Branch und Zugriffsrechte auf jedes private Projekt prüfen; bereinigte Fehlermeldungen an HelpDesk senden.
Sicherheit und Entzug von Zugriffsrechten
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.
Offizielle Referenzen
Öffentliche Einrichtungsanleitung. Repository- und Branch-Zugriff hängen vom Abonnement und den erteilten Berechtigungen ab.
