Saltar a contenido

LinRT · Base de conocimiento · LinRT 5.x

Wiki técnico LinRT

Documentación Real-Time Linux Yocto BSP para ingenieros e integradores.

REAL-TIME EXECUTION CHOICES
OXYGEN Linux · PREEMPT_RT COBALT Xenomai 3 · RTDM TUNGSTEN Xenomai 4 · EVL
YOCTO LTS   •   NXP i.MX   •   CRA EVIDENCE
LinRT WikiLinRT 5.xes:source-access
Documentación

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

Esquema del proceso de acceso

Esquema: activación de la cuenta y acceso SSH; se requiere autorización para cada etapa.

¿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.

LinRT 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.

LinRT HelpDesk ↗ · Wiki

es/source-access.txt · Última modificación: por 127.0.0.1