Dispositivos de borda

Adicionando dispositivos de borda

Com dispositivos de borda adicionais (ou seja, PCs industriais) você pode implantar apps IronFlock em mais máquinas e descarregar a execução de apps do appliance. O próprio appliance já atua como dispositivo de borda, mas você pode conectar mais dispositivos de borda da mesma forma que faria para implantar dispositivos de borda na nuvem IronFlock. Basta ir em Configurações do Projeto -> Dispositivos -> Novo Dispositivo e seguir as instruções.

Atualizações do agente de dispositivo

Os dispositivos de borda conectados ao appliance recebem as atualizações do agente de dispositivo do IronFlock do próprio appliance — eles nunca contatam instance-registry.ironflock.com e não precisam de acesso à internet para isso:

• Modo simples (IP): http://<appliance-host>:15002/dl — a mesma porta que os dispositivos já usam para os tokens do registro.
• Modo domínio/TLS: https://registry.<appliance-domain>/dl pela porta 443.

O appliance mantém um espelho local dos binários do agente e o atualiza a partir de https://instance-registry.ironflock.com (já incluído na lista de permissões do firewall) a cada 6 horas, ou sob demanda em Configurações → Licença/Appliance → Atualizações do agente de dispositivo → Sincronizar agora. Você também pode atualizar o espelho de um appliance a partir da nuvem IronFlock, sem abrir a instância e sem fazer login no próprio appliance: no Studio da nuvem, vá em Perfil → Instâncias, onde cada appliance que você possui tem uma coluna Atualizações do agente de dispositivo mostrando a versão do agente que o seu espelho serve atualmente aos dispositivos (com a versão do instalador de dispositivos abaixo dela) e a mesma ação Sincronizar agora nessa célula. O espelho segue o manifesto de versões da nuvem: cada versão do agente à qual o manifesto da nuvem faz referência atualmente é mantida — para todos os alvos Linux e para Windows — e uma versão só é oferecida aos dispositivos quando está completamente presente no appliance. Se a nuvem publicar uma versão que ainda não está completa no appliance, os dispositivos continuam vendo a anterior.

O agente baixa da árvore assinada <base>/device-agent/ (um manifest.json assinado e os binários com suas assinaturas .sig), verifica cada atualização antes de aplicá-la e reverte automaticamente se a nova versão não iniciar. As atualizações só são aplicadas quando o agente inicia ou quando um usuário inicia a atualização no Studio.

Um dispositivo obtém o local das atualizações do seu arquivo .flock (update_url) e, a partir da versão 0.21.2 do agente, também do appliance a cada heartbeat — assim, uma mudança de IP do appliance ou a troca para o modo domínio se propaga aos dispositivos automaticamente.

Dispositivos provisionados antes deste recurso que ainda executam um agente mais antigo precisam baixar novamente o arquivo .flock uma vez. No Windows: pare o serviço (device-agent.exe service stop), substitua %ProgramData%\IronFlock\DeviceAgent\device.flock pelo novo arquivo (salvo sem BOM) — em dispositivos instalados antes do agente 1.4.0, a pasta é %ProgramData%\IronFlock\Reagent — e inicie-o novamente (device-agent.exe service start).

Registrar dispositivos sem acesso à internet

O appliance também espelha o instalador de dispositivos (ironflock-init) e seu script de instalação, de modo que um novo dispositivo de borda que só alcança o appliance ainda pode ser registrado. Em Configurações do Projeto → Dispositivos → Novo Dispositivo, os comandos exibidos já apontam para o appliance — http://<appliance-host>:15002/dl/... no modo simples (IP), https://registry.<appliance-domain>/dl/... no modo domínio:

• Linux: o comando de uma linha tem a forma curl -fsSL <base>/device-init/install.sh | sudo IRONFLOCK_DL_BASE=<base> bash -s -- -c <arquivo>.flock. Copie antes o arquivo .flock do dispositivo para ele. O ironflock-init obtém a base de download do arquivo .flock; --download-base a sobrescreve.
• Windows: baixe o device-agent.exe de <base>/device-agent/windows/amd64/latest/device-agent.exe e instale o serviço conforme descrito em Conectar dispositivos.

Pré-requisito para um dispositivo sem acesso à internet: o Docker (Engine + plugin Compose) e os pacotes base já devem estar instalados. O appliance espelha os binários próprios do IronFlock, não os pacotes da distribuição — o ironflock-init só tenta acessar get.docker.com quando o Docker está ausente.

O repositório do instalador é atualizado junto com o espelho do agente — mesmo ciclo de 6 horas, mesmo botão Sincronizar agora.