Acceso a los repositorios de código fuente de LinRT BSP
Guía pública — activación de la suscripción, registro de una clave SSH y acceso a los fuentes Yocto mediante Git y Repo.
Esquema del proceso de acceso
¿Quién puede solicitar acceso?
Tras la aprobación de la suscripción, LinRT HelpDesk invita individualmente a los usuarios designados por el cliente (de uno a tres como máximo, según el plan de soporte). El acceso es personal y se limita a los repositorios y ramas autorizados. Disponer de una cuenta HelpDesk no concede automáticamente acceso a Git.
1. Activar la cuenta LinRT HelpDesk
Cada usuario designado recibe un correo de invitación del soporte LinRT. Debe seguir el enlace, establecer una contraseña personal y completar su perfil. Si no recibe el mensaje, compruebe la carpeta de correo no deseado y utilice el portal oficial. No comparta su contraseña de HelpDesk.
2. Preparar el equipo de desarrollo
Los ejemplos funcionan en terminales Linux/macOS o Git Bash de Windows con OpenSSH. Se necesitan Git, OpenSSH y, para varios repositorios Yocto, la herramienta Google Repo. Compruebe las herramientas:
ssh -V git --version
3. Crear un par de claves SSH
Utilice una clave personal por usuario autorizado y, preferiblemente, por equipo. El ticket actual se llama « RSA Key soumission »; el ejemplo usa RSA de 4096 bits. Bitbucket Cloud también admite Ed25519, pero confirme previamente su aceptación con LinRT. Proteja la clave mediante una frase de contraseña y no sobrescriba claves existentes.
mkdir -p "$HOME/.ssh" chmod 700 "$HOME/.ssh" ssh-keygen -t rsa -b 4096 -C "user@company.example" -f "$HOME/.ssh/linrt_bitbucket"
Se generan una clave privada linrt_bitbucket (secreta) y una clave pública linrt_bitbucket.pub (compartible). Añada la clave privada al agente SSH:
eval "$(ssh-agent -s)" ssh-add "$HOME/.ssh/linrt_bitbucket"
4. Abrir el ticket « RSA Key soumission »
Entre en el HelpDesk LinRT y cree un ticket de tipo RSA Key soumission. Adjunte el nombre de la empresa suscrita, el correo registrado del usuario y toda la línea del archivo .pub. Opcionalmente, incluya la huella SHA256. Nunca envíe la clave privada, frase secreta, contraseña ni el directorio .ssh completo.
cat "$HOME/.ssh/linrt_bitbucket.pub" ssh-keygen -lf "$HOME/.ssh/linrt_bitbucket.pub"
5. Esperar la confirmación de LinRT Support
El soporte revisa la solicitud, registra la clave pública en Bitbucket LinRT y confirma que se han habilitado los permisos correspondientes. El registro de la clave y la autorización del repositorio son comprobaciones distintas.
6. Probar la autenticación SSH
Pruebe la conexión con la clave privada correspondiente. En la primera conexión, verifique la huella de la clave del servidor con la referencia oficial de Atlassian antes de aceptarla.
ssh -T -i "$HOME/.ssh/linrt_bitbucket" -o IdentitiesOnly=yes git@bitbucket.org
Una respuesta correcta de Bitbucket Cloud suele incluir:
authenticated via ssh key. You can use git to connect to Bitbucket. Shell access is disabled
« Shell access is disabled » es normal: Bitbucket permite Git por SSH pero no una consola interactiva. La autenticación SSH no garantiza permisos para todos los repositorios. Compruebe el repositorio de manifiestos autorizado:
git ls-remote git@bitbucket.org:linrt/linrt-multifb-oxygen-manifest.git
7. Descargar el repositorio de manifiestos
Como ejemplo, los manifiestos de LinRT Oxygen pueden clonarse por HTTPS. Importante: la autenticación HTTPS es independiente de las claves SSH. Esto descarga solo los manifiestos, no todos los fuentes Yocto:
git clone https://bitbucket.org/linrt/linrt-multifb-oxygen-manifest.git
Si el método aprobado es SSH, use la dirección SSH del repositorio:
git clone git@bitbucket.org:linrt/linrt-multifb-oxygen-manifest.git
8. Inicializar y sincronizar fuentes Yocto con Repo
Repo procesa el manifiesto y descarga los proyectos Git. Ejecute lo siguiente en un directorio vacío. Se usa la rama predeterminada; para una versión Oxygen 5.x/6.x específica, siga la rama y el XML indicados por LinRT Support.
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
El manifiesto puede contener distintos repositorios y protocolos. Clonar el manifiesto por HTTPS no configura automáticamente el acceso SSH a otros repositorios.
Lista de verificación
- Cuenta HelpDesk activada
- Clave pública enviada mediante ticket RSA Key soumission
- Confirmación de registro recibida
- Autenticación SSH correcta
- Repositorio de manifiestos accesible
- Repo sincronizado con la rama aprobada
Solución de problemas
- Permission denied (publickey): compruebe el registro de la clave, las identidades cargadas y los permisos comunicados por soporte.
- SSH correcto pero repositorio inaccesible: verifique la URL y los permisos específicos del repositorio y la rama.
- HTTPS solicita credenciales: las claves SSH no autentican HTTPS; utilice la URL SSH o el procedimiento HTTPS autorizado.
- Host key verification failed: deténgase y compare con las huellas oficiales; no omita la comprobación.
- repo sync falla: compruebe rama, manifiesto y permisos para cada repositorio; envíe registros depurados al HelpDesk.
Seguridad y revocación
Comparta solo claves públicas; proteja las privadas con una frase secreta. No comparta cuentas. Solicite al HelpDesk la revocación de las claves de equipos antiguos o usuarios que abandonan el proyecto. La cuenta HelpDesk y la autenticación SSH son independientes.
Referencias oficiales
Guía pública de incorporación. La disponibilidad de los repositorios depende de la suscripción y de los permisos concedidos.
