Desenvolvimento de Apps IoT
Os apps IronFlock são soluções IoT completas que você constrói e publica para outros usarem. Cada app combina um componente de borda que roda em dispositivos com um dashboard para visualização e controle.
O que os Desenvolvedores Constroem
Como desenvolvedor de apps, você cria:
- Código de borda — Lógica que roda em dispositivos IoT, coletando dados, controlando hardware e processando sinais
- Dashboard — Interface de usuário construída com widgets para monitoramento, controle e análise
- Data Backend — Esquema que define quais dados o app coleta e armazena
- Parâmetros — Configurações que instaladores de apps podem personalizar por dispositivo
Opcionalmente, você também pode incluir capacidades de IA para criar apps conversacionais que respondem a perguntas sobre os dados IoT.
Como Criar um App
Cada app tem um único repositório Git. A pasta raiz desse repositório contém o Dockerfile ou o docker-compose.yml que define o componente de borda, e a pasta .ironflock/ com o dashboard, o esquema de dados e os demais templates. O IronFlock constrói cada release do app a partir desse repositório.
Você cria o app no App Studio. Depois há três formas de preenchê-lo, conforme o que você já tem:
| Você tem | Repositório do app | Imagem do componente de borda |
|---|---|---|
| Nada ainda | Criado e gerenciado pelo IronFlock | Construída a partir do código no repositório |
| Um repositório de código | Seu próprio repositório, vinculado ao app | Construída a partir do código no repositório |
| Uma imagem Docker pronta | Criado pelo IronFlock, ou o seu | Sua imagem, referenciada a partir do repositório |
Começar no IronFlock
Um app novo recebe um repositório Git gerenciado pelo IronFlock, se você quiser com código de exemplo que já funciona. Você escreve o código no IDE na nuvem, no navegador, e de lá o executa nos seus dispositivos. Não é preciso configurar mais nada.
Veja Escrevendo Código de Borda e Crie Seu Primeiro App.
Vincular Seu Próprio Repositório de Código
Se o código do seu app está em um repositório no GitHub, GitLab ou Bitbucket, vincule esse repositório nas configurações do app. Ele passa a ser o repositório do app, e tudo é feito nele: o Dockerfile ou o docker-compose.yml na pasta raiz, a pasta .ironflock/ e todo o seu código.
Você mantém seu editor, seus branches e suas revisões. O IronFlock constrói os releases a partir do que você envia com push, e você ainda pode abrir o app no IDE na nuvem para executá-lo em um dispositivo.
Veja Integração Git para a configuração.
Importar uma Imagem Docker Pronta
Se o seu software já existe como imagem Docker, o código dele não precisa entrar no IronFlock. O app ainda precisa de um repositório: o que o IronFlock cria ou um que você vincula. Esse repositório contém então apenas a integração da sua imagem com o IronFlock: um Dockerfile ou um docker-compose.yml que referencia a imagem, e a pasta .ironflock/.
Referencie a imagem em um Dockerfile:
FROM registry.example.com/acme/machine-gateway:2.4.1Ou como serviço em um docker-compose.yml:
services:
gateway:
image: registry.example.com/acme/machine-gateway:2.4.1
restart: unless-stoppedSe a imagem está em um registro privado, vincule o registro ao app:
- Abra as Configurações do app no App Studio.
- Em Credenciais do Registro Docker, clique em Adicionar Registro Docker.
- Informe o host do registro exatamente como aparece na referência da imagem, aqui
registry.example.com. Para o Docker Hub, informedocker.io. - Informe o usuário e a senha do registro e salve.
Uma imagem pública não precisa de credenciais.
Quando você cria um release, o IronFlock baixa sua imagem com essas credenciais e a armazena com o release. Os dispositivos que instalam o release recebem a imagem do IronFlock. Eles não precisam de acesso ao seu registro nem das suas credenciais.
Para adicionar à imagem um dashboard, coleta de dados ou parâmetros, adicione os arquivos na pasta .ironflock/ como em qualquer outro app. Veja Docker & Compose para os detalhes dos dois arquivos.
Nesta Seção
- Estrutura do App — Como um app é organizado
- Blueprint do App — Como as partes de um app funcionam juntas: o estado em tabelas, o board como interface, as interfaces web dos dispositivos
- Escrevendo Código de Borda — Código que roda em dispositivos
- IronFlock SDK — A biblioteca com a qual seu código de borda grava e lê dados, para Python, JavaScript, Go e C#
- Desenvolva com o Claude Code — Deixe um agente de programação com IA escrever e verificar os templates do seu app
- Docker & Compose — Configuração de container para código de borda
- Data Backend — Armazenamento e streming de dados
- Construindo Dashboards — Criando a interface de usuário
- Parâmetros do App — Tornando apps configuráveis
- Integração Git — Conectando repositórios do seu código
- Releases e a App Store — Publicando novas versões
- Precificando Seu App — Monetize com preços por dispositivo
- IA: Definindo Agentes e Ferramentas — Adicione capacidades de IA