Accesso ai repository sorgente del BSP LinRT
Guida pubblica — attivazione dell’abbonamento, registrazione della chiave SSH e accesso alle sorgenti Yocto tramite Git e Repo.
Schema della procedura di accesso
Chi può richiedere l’accesso?
Dopo la convalida dell’abbonamento, gli utenti indicati dal cliente (da uno a un massimo di tre in base al livello di supporto) ricevono un invito personale da LinRT HelpDesk. I permessi sono nominativi e limitati ai repository e ai rami autorizzati. Un account HelpDesk non garantisce automaticamente l’accesso a Git.
1. Attivare l’account LinRT HelpDesk
Ogni utente designato riceve un’email di invito dal supporto LinRT, segue il collegamento, imposta la password personale e completa il profilo. Se il messaggio manca, controllare la posta indesiderata e utilizzare il portale ufficiale. Non condividere la password.
2. Preparare la postazione di sviluppo
Gli esempi usano terminali Linux/macOS o Git Bash su Windows con OpenSSH. Installare Git, OpenSSH e, per il download di più repository Yocto, lo strumento Google Repo. Verificare le versioni:
ssh -V git --version
3. Generare la coppia di chiavi SSH
Usare chiavi personali per ciascun utente e preferibilmente per ogni postazione. Il ticket HelpDesk attuale si chiama « RSA Key soumission »; l’esempio usa RSA a 4096 bit. Bitbucket Cloud supporta anche Ed25519, ma verificare prima la relativa autorizzazione con LinRT. Impostare una passphrase forte e non sovrascrivere chiavi esistenti.
mkdir -p "$HOME/.ssh" chmod 700 "$HOME/.ssh" ssh-keygen -t rsa -b 4096 -C "user@company.example" -f "$HOME/.ssh/linrt_bitbucket"
Vengono create una chiave privata linrt_bitbucket (segreta) e una chiave pubblica linrt_bitbucket.pub (condivisibile). Caricare la chiave privata nell’agente SSH:
eval "$(ssh-agent -s)" ssh-add "$HOME/.ssh/linrt_bitbucket"
4. Aprire un ticket « RSA Key soumission »
Accedere al LinRT HelpDesk e aprire un ticket nella categoria RSA Key soumission. Indicare azienda abbonata, email registrata dell’utente e l’intera riga del file .pub. Facoltativamente aggiungere l’impronta SHA256. Non inviare mai chiave privata, passphrase, password o l’intera cartella .ssh.
cat "$HOME/.ssh/linrt_bitbucket.pub" ssh-keygen -lf "$HOME/.ssh/linrt_bitbucket.pub"
5. Attendere la conferma di LinRT Support
Il supporto verifica la richiesta, registra la chiave pubblica sul servizio Bitbucket LinRT e conferma l’abilitazione dei permessi sui repository appropriati. Registrazione della chiave e autorizzazioni dei repository sono controlli distinti.
6. Testare l’autenticazione SSH
Provare la connessione con la chiave privata corrispondente. Al primo collegamento, confrontare l’impronta della chiave host con i riferimenti ufficiali Atlassian prima di accettarla.
ssh -T -i "$HOME/.ssh/linrt_bitbucket" -o IdentitiesOnly=yes git@bitbucket.org
Una risposta positiva di Bitbucket Cloud normalmente include:
authenticated via ssh key. You can use git to connect to Bitbucket. Shell access is disabled
« Shell access is disabled » è normale: Bitbucket fornisce Git via SSH, non una shell interattiva. Un test SSH riuscito non significa accesso a tutti i repository privati. Controllare separatamente il repository dei manifest autorizzato:
git ls-remote git@bitbucket.org:linrt/linrt-multifb-oxygen-manifest.git
7. Recuperare il repository dei manifest
Per esempio, il repository dei manifest di LinRT Oxygen può essere clonato via HTTPS. Attenzione: l’autenticazione HTTPS è distinta da quella SSH. Questa operazione scarica soltanto i manifest, non tutti i sorgenti Yocto:
git clone https://bitbucket.org/linrt/linrt-multifb-oxygen-manifest.git
Se il protocollo approvato è SSH, utilizzare invece l’URL SSH del repository:
git clone git@bitbucket.org:linrt/linrt-multifb-oxygen-manifest.git
8. Inizializzare e sincronizzare le sorgenti Yocto con Repo
Repo legge il manifest e recupera i vari progetti Git. Eseguire i comandi in una nuova directory vuota. L’esempio usa il ramo predefinito; per una versione specifica Oxygen 5.x/6.x applicare soltanto il ramo e il file XML forniti dal supporto LinRT.
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
Un manifest può contenere repository diversi e URL con protocolli differenti. Il clone HTTPS del manifest non configura automaticamente l’accesso SSH agli altri repository.
Lista di controllo
- Account HelpDesk attivato
- Chiave pubblica inviata con ticket RSA Key soumission
- Conferma del supporto ricevuta
- Test SSH riuscito
- Repository dei manifest accessibile
- Repo sincronizzato sul ramo approvato
Risoluzione dei problemi
- Permission denied (publickey): verificare registrazione della chiave, identità caricate e conferma del supporto.
- Test SSH corretto ma repository non accessibile: controllare URL e diritti specifici per repository/ramo.
- HTTPS richiede credenziali: la chiave SSH non autentica HTTPS. Usare l’URL SSH o la procedura HTTPS approvata.
- Host key verification failed: fermarsi e verificare l’impronta ufficiale; non ignorare l’errore.
- repo sync non riesce: verificare manifest, ramo e autorizzazioni per ogni repository; inviare log privi di segreti al HelpDesk.
Sicurezza e revoca delle autorizzazioni
Trasmettere soltanto chiavi pubbliche. Proteggere quelle private con una passphrase, evitare account condivisi e richiedere al HelpDesk la revoca quando cambia una postazione o un utente lascia il progetto. Password HelpDesk e chiave SSH Bitbucket sono distinte.
Riferimenti ufficiali
Guida pubblica per gli abbonati. Repository e rami disponibili dipendono dall’abbonamento e dalle autorizzazioni confermate.
