Visão Geral do mrxnode

O seu mrxnode é um dispositivo de borda que liga o hardware no local à plataforma Mirox. Este guia orienta-o no acesso ao dispositivo, no seu registo na cloud, na ativação de aplicações e na construção de um cluster de borda.

Configuração do Dispositivo

Ligação via SSH

Para aceder ao seu dispositivo mrxnode, ligue-se via SSH utilizando o endereço IP do dispositivo.

ssh appuser@<device-ip>

Credenciais de Início de Sessão:

Nome de utilizadorPalavra-passeFinalidade
appusermirox (não registado) / UID do Dispositivo (registado)Acesso do cliente
mrxuserToken do DispositivoAcesso de administrador do sistema

Alteração da Palavra-passe

Assim que o dispositivo é registado numa plataforma Mirox, a palavra-passe predefinida de appuser é automaticamente substituída pelo UID exclusivo do dispositivo, por motivos de segurança.

Primeiro Início de Sessão

Quando se liga a um dispositivo novo ou não registado, verá o seguinte 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.
==========================================

Registar o Dispositivo

Modo de Recuperação Necessário

O registo do dispositivo só é possível quando este arranca no modo de recuperação. Os dispositivos novos arrancam no modo de recuperação por predefinição.

Voltar a Registar um Dispositivo

Se o dispositivo já estiver registado numa plataforma, tem de o cancelar primeiro utilizando mrxcloud unregister.

Se o dispositivo tiver sido registado anteriormente mas não tiver sido devidamente removido da plataforma (por exemplo, se o dispositivo tiver sido reposto), o comando de registo irá falhar. Neste caso, tem primeiro de eliminar o dispositivo da plataforma para limpar o seu registo antes de o voltar a registar.

Para registar o seu dispositivo na plataforma SaaS Mirox:

mrxcloud register service.mirox.io

Para obter uma lista completa dos comandos mrxcloud, consulte o Resumo de Comandos.

Após o registo bem-sucedido, mude para o slot principal do sistema e reinicie:

mrxos switch A
sudo reboot

O dispositivo irá agora arrancar no Slot A com a configuração registada.

Configurar a Utilização da Aplicação

Após o registo, ative a aplicação Generic Relay para controlar o hardware HAT:

sudo mrxhat activate generic-relay

Verifique o estado da ativação:

sudo mrxhat status

Para obter uma lista completa dos comandos mrxhat, consulte o Resumo de Comandos.

Configuração do Cluster de Borda

Para executar um cluster K3s nos seus dispositivos mrxnode, é necessária uma configuração adicional.

Pré-requisitos (SaaS)

Antes de inicializar um dispositivo como nó de borda, conclua estes passos na SaaS:

  1. Registar o dispositivo - O dispositivo tem de estar registado na cloud
  2. Atribuir o dispositivo a um parque - O dispositivo tem de estar atribuído a um parque
  3. Criar o cluster de borda - Tem de ser criado um cluster de borda para o parque

Passo 1: Inicializar o Nó (Modo de Recuperação)

No modo de recuperação, inicialize o dispositivo como nó de borda:

sudo mrxcloud node init

O dispositivo recebe automaticamente:

  • A atribuição do parque a partir da SaaS
  • Um número de nó de borda exclusivo

Passo 2: Iniciar o Cluster K3s (Modo Normal)

Após reiniciar para o sistema normal, inicialize o cluster:

sudo mrxnode init

O Nó 1 cria um novo cluster. Os nós adicionais juntam-se ao cluster existente.

Passo 3: Inicializar o FluxCD (Bootstrap)

Após a inicialização bem-sucedida do cluster, configure o FluxCD:

sudo mrxnode bootstrap

O FluxCD sincroniza automaticamente as configurações a partir do registo OCI.

Verificar o Estado

# Verificar a ligação à cloud e o registo
sudo mrxcloud status

# Mostrar a configuração do nó
sudo mrxcloud node info

# Verificar o estado do K3s e do FluxCD
sudo mrxnode check

# Mostrar o estado de sincronização do FluxCD
sudo mrxnode flux-status

Funcionalidades Relacionadas

MIT Licensed | Copyright 2026 Mirox Verwaltungs GmbH