Visión general de mrxnode
Tu mrxnode es un dispositivo edge que conecta el hardware in situ con la plataforma Mirox. Esta guía te muestra cómo acceder al dispositivo, registrarlo en la nube, activar aplicaciones y construir un clúster edge.
Configuración del dispositivo
Conexión vía SSH
Para acceder a tu dispositivo mrxnode, conéctate vía SSH usando la dirección IP del dispositivo.
ssh appuser@<device-ip>
Credenciales de inicio de sesión:
| Usuario | Contraseña | Propósito |
|---|---|---|
appuser | mirox (no registrado) / UID del dispositivo (registrado) | Acceso del cliente |
mrxuser | Token del dispositivo | Acceso del administrador del sistema |
Cambio de contraseña
Una vez que el dispositivo se registra con una plataforma Mirox, la contraseña por defecto de appuser se reemplaza automáticamente con el UID único del dispositivo por motivos de seguridad.
Primer inicio de sesión
Cuando te conectas a un dispositivo nuevo o no registrado, verás el siguiente banner:
███╗ ███╗██╗██████╗ ██████╗ ██╗ ██╗ ██████╗ ███████╗
████╗ ████║██║██╔══██╗██╔═══██╗╚██╗██╔╝ ██╔═══██╗██╔════╝
██╔████╔██║██║██████╔╝██║ ██║ ╚███╔╝ ██║ ██║███████╗
██║╚██╔╝██║██║██╔══██╗██║ ██║ ██╔██╗ ██║ ██║╚════██║
██║ ╚═╝ ██║██║██║ ██║╚██████╔╝██╔╝ ██╗ ╚██████╔╝███████║
╚═╝ ╚═╝╚═╝╚═╝ ╚═╝ ╚═════╝ ╚═╝ ╚═╝ ╚═════╝ ╚══════╝
Welcome to mrxnode - an Edge-Node for the Mirox Platform
==========================================
CLOUD REGISTRATION REQUIRED
==========================================
This device must be registered before use.
To register:
mrxcloud register <service>.<domain>
Example:
mrxcloud register myservice.mirox.io
After registration, reboot the device.
==========================================
Registro del dispositivo
Se requiere el modo de recuperación
El registro del dispositivo solo es posible cuando se arranca en modo de recuperación. Los dispositivos nuevos arrancan en modo de recuperación por defecto.
Volver a registrar un dispositivo
Si el dispositivo ya está registrado en una plataforma, debes cancelar primero su registro con mrxcloud unregister.
Si el dispositivo se registró previamente pero no se canceló correctamente su registro en la plataforma (p. ej. el dispositivo se reseteó), el comando de registro fallará. En ese caso, debes eliminar primero el dispositivo de la plataforma para borrar su registro antes de volver a registrarlo.
Para registrar tu dispositivo con la plataforma SaaS de Mirox:
mrxcloud register service.mirox.io
Para una lista completa de comandos mrxcloud, consulta la Hoja de referencia de comandos.
Tras un registro correcto, cambia al slot principal del sistema y reinicia:
mrxos switch A
sudo reboot
El dispositivo arrancará ahora en el slot A con la configuración registrada.
Configurar el uso de la aplicación
Tras el registro, activa la aplicación Relé genérico para controlar el hardware HAT:
sudo mrxhat activate generic-relay
Verifica el estado de la activación:
sudo mrxhat status
Para una lista completa de comandos mrxhat, consulta la Hoja de referencia de comandos.
Configuración del clúster edge
Para ejecutar un clúster K3s en tus dispositivos mrxnode se requiere configuración adicional.
Requisitos previos (SaaS)
Antes de inicializar un dispositivo como nodo edge, completa estos pasos en el SaaS:
- Registra el dispositivo - El dispositivo debe estar registrado con la nube
- Asigna el dispositivo a un parque - El dispositivo debe estar asignado a un parque
- Crea un clúster edge - Debe crearse un clúster edge para el parque
Paso 1: Inicializar el nodo (modo de recuperación)
En modo de recuperación, inicializa el dispositivo como nodo edge:
sudo mrxcloud node init
El dispositivo recibe automáticamente:
- La asignación de parque desde el SaaS
- Un número único de nodo edge
Paso 2: Iniciar el clúster K3s (modo normal)
Tras reiniciar en el sistema normal, inicializa el clúster:
sudo mrxnode init
El nodo 1 crea un nuevo clúster. Los nodos adicionales se unen al clúster existente.
Paso 3: Arrancar FluxCD
Tras la inicialización correcta del clúster, configura FluxCD:
sudo mrxnode bootstrap
FluxCD sincroniza automáticamente las configuraciones desde el registro OCI.
Comprobar el estado
# Comprobar la conexión y el registro en la nube
sudo mrxcloud status
# Mostrar la configuración del nodo
sudo mrxcloud node info
# Comprobar el estado de K3s y FluxCD
sudo mrxnode check
# Mostrar el estado de sincronización de FluxCD
sudo mrxnode flux-status
Funciones relacionadas
- Hoja de referencia de comandos — referencia completa de
mrxcloud,mrxos,mrxnodeymrxhat - Guía paso a paso — tareas de configuración de red y disco para tu dispositivo
- Despliegue de contenedores — despliega y gestiona contenedores en el dispositivo
- Resolución de problemas — recuperación con el botón de encendido y soluciones comunes
- Orquestación del clúster edge — cómo se gestionan los dispositivos como un clúster edge desde la plataforma
- Relé genérico — controla el hardware de relé HAT desde un dispositivo registrado