salta al contenuto

LinRT · Base di conoscenza · LinRT 5.x

Wiki tecnico LinRT

Documentazione Real-Time Linux Yocto BSP per ingegneri e integratori.

OPZIONI DI ESECUZIONE REAL-TIME
OXYGEN Linux · PREEMPT_RT COBALT Xenomai 3 · RTDM TUNGSTEN Xenomai 4 · EVL
YOCTO LTS • NXP i.MX • EVIDENZE CRA
LinRT WikiLinRT 5.xit:source-access
Documentazione

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

Schema della procedura di accesso

Schema: attivazione dell’account e accesso SSH, subordinati alle autorizzazioni previste.

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.

LinRT HelpDesk ↗

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.

LinRT HelpDesk ↗ · Wiki

it/source-access.txt · Ultima modifica: da 127.0.0.1