Orquestração

Execute uma frota de nós de borda MiroxOS como um único cluster auto-reparável na sua central, com cada nó a percorrer uma máquina de estados protegida, de modo que um dispositivo nunca possa acabar num estado inválido ou semiconfigurado.

Visão geral

Pôr em funcionamento um cluster de borda é um aperto de mão coordenado entre as ações que executa no dispositivo e as ações que o pessoal da Mirox realiza na cloud. Cada nó avança através de uma máquina de estados rigorosa, e cada transição verifica primeiro os seus pré-requisitos — pelo que não pode, por exemplo, retirar um nó de um parque enquanto este ainda está a servir um cluster ativo. Quando um dispositivo fica desatualizado em relação à cloud (por exemplo, após uma limpeza forçada enquanto estava offline), um único comando de sincronização reconcilia-o.

Máquina de estados

Diagrama de estados do dispositivo

Legenda:

Setas sólidas: Transições normais (executadas no dispositivo ou por um administrador da organização)
Setas tracejadas: Transições forçadas realizadas pelo pessoal da Mirox, com limpeza automática
Bloqueado ao parque Cluster de borda em execução Ponto de sincronização

Comportamento das transições forçadas

Quando o pessoal da Mirox utiliza a opção de força, todas as limpezas intermédias são executadas automaticamente:

Ação forçada	Executa automaticamente
Eliminar dispositivo (a partir de CLUSTER_ACTIVE)	sair do cluster → desinicializar nó → desatribuir do parque → desatribuir da organização → cancelar registo
Eliminar dispositivo (a partir de NODE_INITIALIZED)	desinicializar nó → desatribuir do parque → desatribuir da organização → cancelar registo
Desatribuir da organização (a partir de NODE_INITIALIZED)	desinicializar nó → desatribuir do parque → desatribuir da organização
Desatribuir do parque (a partir de NODE_INITIALIZED)	desinicializar nó → desatribuir do parque

Sincronização do dispositivo

O dispositivo pode executar mrxcloud sync para obter o estado atual da cloud e reconciliar a sua configuração local:

Se o dispositivo foi desatribuído à força do parque → a configuração local do nó é limpa
Se o dispositivo foi desatribuído à força da organização → a configuração local da organização é limpa
Se o dispositivo foi eliminado à força → o dispositivo tem de se voltar a registar

Diagrama de estados do cluster

Legenda:

Setas sólidas: Transições normais
Setas tracejadas: Transições forçadas realizadas pelo pessoal da Mirox
A aguardar nós Cluster operacional

Estados do dispositivo

Estado	Descrição	Estados seguintes permitidos
`UNREGISTERED`	O dispositivo não está registado em nenhuma cloud	`REGISTERED`
`REGISTERED`	O dispositivo está registado na cloud	`ASSIGNED_ORG`, `UNREGISTERED`
`ASSIGNED_ORG`	O dispositivo está atribuído a uma organização	`ASSIGNED_PARK`, `REGISTERED`
`ASSIGNED_PARK`	O dispositivo está atribuído a um parque	`NODE_INITIALIZED`, `ASSIGNED_ORG`
`NODE_INITIALIZED`	O dispositivo está inicializado como nó de borda	`CLUSTER_ACTIVE`, `ASSIGNED_PARK`
`CLUSTER_ACTIVE`	O cluster de borda está em execução no dispositivo	`NODE_INITIALIZED`

Estados do cluster

Estado	Descrição
`NOT_CREATED`	Não existe nenhum cluster de borda para o parque
`CREATED`	Cluster de borda criado, a aguardar nós
`ACTIVE`	Pelo menos um nó aderiu

Etapas do fluxo de trabalho

Fluxo direto (configuração)

Etapa	Ação	Ator	Ferramenta	Pré-requisito
1	Registar o dispositivo	Dispositivo	`mrxcloud register`	-
2	Atribuir à organização	Pessoal da Mirox	Cloud	Etapa 1
3	Atribuir ao parque	Administrador da organização	Cloud	Etapa 2
4	Criar cluster de borda	Pessoal da Mirox	Cloud	Etapa 3 (parque existe)
5	Inicializar o nó	Dispositivo	`mrxcloud node init`	Etapas 3 + 4
6	Inicializar o cluster	Dispositivo	`mrxnode init`	Etapa 5
7	Implementar cargas de trabalho	Dispositivo	`mrxnode bootstrap`	Etapa 6

Fluxo inverso (desmontagem)

Etapa	Ação	Ator	Ferramenta	Pré-requisito
7	Parar cargas de trabalho	Dispositivo	`mrxnode teardown`	-
6	Sair do cluster	Dispositivo	`mrxnode leave`	Etapa 7
5	Desinicializar o nó	Dispositivo	`mrxcloud node deinit`	Etapa 6
4	Eliminar cluster de borda	Pessoal da Mirox	Cloud	Sem nós ativos
3	Desatribuir do parque	Administrador da organização	Cloud	Etapa 5 (nó desinicializado)
2	Desatribuir da organização	Pessoal da Mirox	Cloud	Etapa 3
1	Cancelar registo do dispositivo	Dispositivo	`mrxcloud unregister`	Etapa 2

Restrições de bloqueio

Bloqueio de atribuição ao parque

Quando um dispositivo é inicializado como nó de borda (Etapa 5), o dispositivo fica bloqueado ao parque:

Ação	Permitida quando	Bloqueada quando
Desatribuir dispositivo do parque	Nó NÃO inicializado	Nó inicializado
Desatribuir dispositivo da organização	Dispositivo NÃO atribuído a um parque	Dispositivo atribuído a um parque
Eliminar cluster de borda	Nenhum nó inicializado	Qualquer nó inicializado

Matriz de aplicação

Cada ação é recusada enquanto um bloqueio estiver ativo, a menos que seja executada com a flag force — caso em que a plataforma realiza por si todas as limpezas intermédias:

Ação	Sem força	Com força
Desatribuir dispositivo do parque	Recusada enquanto o dispositivo for um nó inicializado	Desinicialização automática do nó e, em seguida, desatribuição
Desatribuir dispositivo da organização	Recusada enquanto o dispositivo estiver atribuído a um parque	Desatribuição automática do parque (e desinicialização do nó se necessário)
Eliminar dispositivo	Recusada enquanto o dispositivo tiver quaisquer atribuições	Cadeia de limpeza completa automática
Eliminar cluster de borda	Recusada enquanto algum nó estiver inicializado	Desinicialização automática de todos os nós e, em seguida, eliminação
Inicializar nó (`mrxcloud node init`)	Requer que o dispositivo esteja atribuído a um parque com um cluster de borda	-
Sair do cluster (`mrxcloud node deinit`)	Requer que o dispositivo tenha atualmente um número de nó	-

Referência de comandos

Comandos no dispositivo (mrxcloud)

Comando	Descrição
`mrxcloud register <domain>`	Registar o dispositivo na cloud
`mrxcloud unregister`	Cancelar o registo do dispositivo
`mrxcloud sync`	Obter e reconciliar o estado atual da cloud
`mrxcloud node init`	Inicializar o dispositivo como nó de borda
`mrxcloud node deinit`	Desinicializar o nó do cluster
`mrxcloud node info`	Mostrar a configuração de nó do dispositivo

Comandos no dispositivo (mrxnode)

Comando	Descrição
`mrxnode init`	Iniciar o cluster de borda (primeiro nó) ou aderir a um existente
`mrxnode leave`	Sair do cluster de borda
`mrxnode bootstrap`	Implementar as cargas de trabalho da central no cluster
`mrxnode teardown`	Parar e remover as cargas de trabalho implementadas
`mrxnode check`	Verificar o estado do cluster

Ações no lado da cloud

Estas etapas são realizadas na cloud em vez de no dispositivo. Atribuir um dispositivo a um parque e geri-lo dentro do parque está disponível para os administradores da sua organização; registar ou atribuir um dispositivo a uma organização, e criar ou eliminar o próprio cluster de borda, são realizados pelo pessoal da Mirox.

Ação	Realizada por	Com força
Atribuir dispositivo à organização	Pessoal da Mirox	-
Desatribuir dispositivo da organização	Pessoal da Mirox	Desatribuição automática do parque + desinicialização do nó
Eliminar dispositivo	Pessoal da Mirox	Cadeia de limpeza completa automática
Atribuir / desatribuir dispositivo a um parque	Administrador da organização	Desinicialização automática do nó ao desatribuir
Criar cluster de borda para um parque	Pessoal da Mirox	-
Eliminar cluster de borda	Pessoal da Mirox	Desinicialização automática de todos os nós

Verificação de estado

Verificar o estado atual

# No dispositivo: verificar o estado de registo e do nó
mrxcloud status
mrxcloud node info

# Verificar o estado do cluster de borda
mrxnode check

Indicadores de estado

mrxcloud node info reporta a configuração de nó atual do dispositivo:

Indicador	Significado
`edge_location`	UID do parque que este dispositivo serve como nó
`edge_node_number`	Número de nó atribuído (1, 2, 3...)
`private_ip`	IP de rede privada do nó dentro do cluster
`token_to_join`	Token de adesão ao cluster utilizado por nós adicionais

Tratamento de erros

Erros comuns

Erro	Causa	Resolução
"Device is not assigned to a park"	Etapa 3 não concluída	Atribua o dispositivo a um parque na cloud
"No edge cluster exists for park"	Etapa 4 não concluída	Solicite a criação do cluster de borda na cloud
"Cannot unassign: device is initialized as edge node"	Etapa 5 concluída, bloqueio ativo	Execute `mrxcloud node deinit` ou utilize a opção de força
"Cannot delete cluster: active nodes exist"	Nós ainda inicializados	Desinicialize todos os nós ou utilize a opção de força
"Cannot unassign from org: device assigned to park"	Dispositivo ainda no parque	Desatribua primeiro do parque ou utilize a opção de força
"State mismatch: device was forcefully modified"	O estado da cloud mudou enquanto o dispositivo estava offline	Execute `mrxcloud sync` para reconciliar

Funcionalidades relacionadas

mrxnode — o nó de hardware de borda que funciona como parte do cluster
Visão geral do mrxnode — configuração do dispositivo, registo e passo a passo da CLI
Folha de consulta do mrxnode — referência rápida dos comandos mrxcloud e mrxnode
Resolução de problemas — padrões de recuperação quando um nó se comporta de forma incorreta
Opções de implementação do Agent — clusters de borda no local versus agentes alojados na cloud