{"id":34836321,"url":"https://github.com/larsid/soft-iot-dlt-architecture","last_synced_at":"2026-03-18T00:04:08.347Z","repository":{"id":75339480,"uuid":"386735585","full_name":"larsid/soft-iot-dlt-architecture","owner":"larsid","description":"Especificação, requisitos básicos e passos gerais para instalação da plataforma de balanceamento de carga distribuído soft-iot-dlt.","archived":false,"fork":false,"pushed_at":"2022-08-23T17:57:57.000Z","size":294,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-27T01:37:46.329Z","etag":null,"topics":["architecture","dlt","soft-iot","soft-iot-dlt","tangle"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/larsid.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-07-16T18:53:34.000Z","updated_at":"2022-08-15T23:22:46.000Z","dependencies_parsed_at":"2023-04-07T11:31:02.147Z","dependency_job_id":null,"html_url":"https://github.com/larsid/soft-iot-dlt-architecture","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/larsid/soft-iot-dlt-architecture","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/larsid%2Fsoft-iot-dlt-architecture","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/larsid%2Fsoft-iot-dlt-architecture/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/larsid%2Fsoft-iot-dlt-architecture/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/larsid%2Fsoft-iot-dlt-architecture/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/larsid","download_url":"https://codeload.github.com/larsid/soft-iot-dlt-architecture/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/larsid%2Fsoft-iot-dlt-architecture/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30636705,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-17T23:56:54.546Z","status":"ssl_error","status_checked_at":"2026-03-17T23:56:28.952Z","response_time":56,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["architecture","dlt","soft-iot","soft-iot-dlt","tangle"],"created_at":"2025-12-25T16:01:41.640Z","updated_at":"2026-03-18T00:04:08.339Z","avatar_url":"https://github.com/larsid.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# soft-iot-dlt-architecture\n\n## 1 - Pré-requisitos\n\n- Java Developer Kit (JDK) 1.8\n- Maven 3.0.4 ou superior\n- ServiceMix\n\n## 2 - Instalação do ServiceMix\n\n- Baixe o servicemix no [site oficial](http://servicemix.apache.org/downloads/servicemix-7.0.0.html).\n\n- [Manual de instalação](http://servicemix.apache.org/docs/7.x/quickstart/installation.html)\n\n## 3 - Configurações iniciais\n\nCom o servicemix instalado podemos inicar as configurações básicas necessárias para acompanhar os passos de instalação de cada _bundle_ da arquitetura soft-iot-dlt.\n\n### 3.1 - Adicionar ServiceMix como variável de ambiente\n\nApós baixar e descompactar o Apache ServiceMix é recomendado que ele seja configurado como variável de ambiente. Afim de facilitar o acesso do mesmo em qualquer diretório através do comando `servicemix`.\n\n#### 3.1.1 - Linux\n\nPara fazer isso linux será necessário executar o seguinte comando.\n\n```\necho \"export PATH=$PATH:SERVICEMIX_HOME/bin\" \u003e\u003e ~/.bashrc\n```\n\nAtenção: SERVICEMIX_HOME deve ser substituido pelo caminho do diretório onde você descompatou o Apache ServiceMix.\n\nExemplo:\n\nCaso tenha descompactado o servicemix na pasta `/opt/servicemix`\nentão o comando comando ficará:\n\n```\necho \"export PATH=$PATH:/opt/servicemix/bin\" \u003e\u003e ~/.bashrc\n```\n\nReinicie terminal e em seguida execute o comando `servicemix` para executar o terminal do servicemix.\n\n#### 3.1.2 - Windows\n\n...\n\n### 3.2 - Repositório fonte\n\nEsse passo é importante pois é graças a ele que será possivel utilizar os comandos de instalação dos bundles\npertencentes a arquitetura `soft-iot-dlt`.\n\n```\nconfig:edit org.ops4j.pax.url.mvn\nconfig:property-append org.ops4j.pax.url.mvn.repositories \", https://jitpack.io@jitpack.io\"\nconfig:update\n```\n\n### 3.3 - Gerencia de bundles OSGI\n\nTutorial de [como fazer um _bundle_ OSGI com o framework blueprint](https://github.com/larsid/osgi-blueprint-bundle-archetypes#readme).\n\n\u003c!-- TODO:\n  Explicar o que é um bundle OSGI\n  Como criar um bundle OSGI utilizando blueprint.\n--\u003e\n\n#### 3.3.1 - Terminal\n\nÉ possível gerenciar os bundles OSGI utilizando o terminal para fazer isso utilize os comandos com préfixo `bundle`, caso tenha dúvidas utilize o comando `bundle --help` para visualizar a lista de comandos disponíveis. Segue abaixo uma tabela com os comandos mais utilizados.\n\n| Comando         | Ação                                                                      | Exemplo                                         |\n| --------------- | ------------------------------------------------------------------------- | ----------------------------------------------- |\n| bundle:list     | Lista todos os bundles instalados.                                        | bundle:list                                     |\n| bundle:install  | Instala um novo bundle.                                                   | bundle:install mvn:group-id/artifact-id/version |\n| bundle:unistall | Desistala um bundle.                                                      | bundle:unistall `\u003cID\u003e`                          |\n| bundle:start    | Inicia a execução de um bundle.                                           | bundle:start `\u003cID\u003e`                             |\n| bundle:stop     | Para a execução de um bundle.                                             | bundle:stop `\u003cID\u003e`                              |\n| bundle:restart  | Reinicia um bundle.                                                       | bundle:restart `\u003cID\u003e`                           |\n| bundle:diag     | Exibe informações que justificam o por que o bundle não está inicalizando | bundle:diag                                     |\n\n\u003e Dica: Utilize o webconsole para instalar ou atualizar um bundle recém construido.\n\n#### 3.3.2 - WebConsole\n\nO `webconsole` é uma interface gráfica web que permite gerenciar os bundles de forma simples. Com ele é possível instalar, remover, iniciar, parar e atualizar _bundles_.\n\nO processo de instalação do webconsole é simples, bastando apenas Executar o comando abaixo no terminal do ServiceMix.\n\n```\nfeature:install webconsole\n```\n\nPara visualizar o webconsole do karaf é necessário acessar a URL abaixo.\n\n```\nhttp://localhost:8181/system/console/bundles\n```\n\n\u003e :warning: O usuário e senha é \"karaf\" :warning:\n\n## 4 - Visão geral\n\n\u003c!-- Por que da arquitetura soft-iot-dlt --\u003e\n\nA `soft-iot-dlt` é uma arquitetura inspirada e totalmente compatível com a [soft-iot](http://www.wiser.ufba.br/prazeres/pdfs/soft-iot.pdf) ([código fonte](https://github.com/WiserUFBA)). Ela surge a partir da ideia de balancear a carga dos _gateways_\nutilizando um algoritimo de balanceamendo distribuido e seguro.\n\nA `soft-iot-dlt` é composta por 5 _bundles_ especificos da arquitetura e uma [implementação](https://github.com/larsid/soft-iot-mapping-devices) baseada no [soft-iot-mapping-devices](https://github.com/WiserUFBA/soft-iot-mapping-devices) utilizado na plataforma `soft-iot` como demonstrada na imagem abaixo.\n\n\u003cfigure\u003e\n  \u003cimg src=\"images/soft-iot-dlt-arch-flow-arch-flow-2.1.png\" alt=\"Fluxo dos dados na arquitetura soft-iot-dlt\"/\u003e\n  \u003cfigcaption\u003eImagem 1 - Fluxo dos dados na arquitetura soft-iot-dlt.\u003c/figcaption\u003e\n\u003c/figure\u003e\n\n## 5 - Instalação da soft-iot-dlt\n\nApós ter executado o [passo 3.2](#32---repositório-fonte) será possível utilizar o comando abaixo para instalar qualquer bundle da arquitetura.\n\n    bundle:install mvn:com.github.larsid/\u003cNOME_BUNDLE\u003e/\u003cVERSION\u003e\n\nExemplo:\n\nCaso queira instalar a versão `master` do `soft-iot-dlt-client-tangle` então o comando a ser executado deverá ser:\n\n    bundle:intall mvn:com.github.larsid/soft-iot-dlt-client-tangle/master\n\n:warning: Caso tente instalar apartir de um _group-id_, _arctifact-id_ e/ou versão que não existe o erro abaixo será exibido. :warning:\n\n![Print do erro gerado ao inserir um group-id, arctifact-id ou branch inexistente no comando de instalação de bundle.](images/erro-instalar-bundle-branch.png)\n\nAlguns _bundles_ possuem dependências de serviços e isso significa que o _bundle_ não será inicializado o serviço que ele precisa não estiver disponivel. Por esse motivo é recomendado os que instale os _bundles_ da `soft-iot-dlt` na ordem demonstrada pelo ID da tabela de dependências abaixo.\n\n| ID  | Bundle                                                                             | Dependência ID |\n| :-: | ---------------------------------------------------------------------------------- | :------------: |\n|  0  | [soft-iot-mapping-devices](https://github.com/larsid/soft-iot-mapping-devices)     |       -        |\n|  1  | [soft-iot-dlt-id-manager](https://github.com/larsid/soft-iot-dlt-id-manager)       |       -        |\n|  2  | [soft-iot-dlt-client-tangle](https://github.com/larsid/soft-iot-dlt-client-tangle) |       -        |\n|  3  | [soft-iot-dlt-auth](https://github.com/larsid/soft-iot-dlt-auth)                   |       0        |\n|  4  | [soft-iot-dlt-load-balancer](https://github.com/larsid/soft-iot-dlt-load-balancer) |   0, 1, e 2    |\n|  5  | [soft-iot-dlt-load-monitor](https://github.com/larsid/soft-iot-dlt-load-monitor)   |   0, 1, e 2    |\n\n_Tabela de dependências entre bundles_\n\n## 5.1 - Docker\n\nAs imagens Docker estão disponibilizadas no Docker Hub, clique em um dos links abaixo para acessá-las.\n\n### 5.1.1 - [soft-iot-base](https://hub.docker.com/repository/docker/larsid/soft-iot-base)\n\nImagem com os *bundles* básicos, utilize o seguinte comando para executá-la:\n```powershell\ndocker run -i -t -p 1883:1883 -p 8181:8181 -p 1099:1099 -p 8101:8101 -p 61616:61616 -p 44444:44444 larsid/soft-iot-base:\u003ctagname\u003e\n```\n\n[Clique aqui](https://hub.docker.com/repository/docker/larsid/soft-iot-base) para obter mais informações sobre a imagem.\n\n### 5.1.2 [load-balancer](https://hub.docker.com/repository/docker/larsid/load-balancer)\n\nImagem com os *bundles* necessários para executar o balancemento de carga. Utilize o seguinte comando para executá-la:\n```powershell\ndocker run -i -t -p 1883:1883 -p 8181:8181 -p 1099:1099 -p 8101:8101 -p 61616:61616 -p 44444:44444  larsid/load-balancer:\u003ctagname\u003e\n```\n\n[Clique aqui](https://hub.docker.com/repository/docker/larsid/load-balancer) para obter mais informações sobre a imagem.\n\n\u003c!-- Todo:\n    Fazer tutorial ensinando como rodar várias instânias.\n --\u003e\n\n## 6 - Próximo passo\n\nCaso tenha se interessado pela arquitetura soft-iot-dlt e queria saber mais detalhes sobre a implementação [clique aqui](https://github.com/larsid/soft-iot-dlt-auth) e conheça o `soft-iot-dlt-auth` ponto de entrada de toda à arquitetura.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flarsid%2Fsoft-iot-dlt-architecture","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flarsid%2Fsoft-iot-dlt-architecture","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flarsid%2Fsoft-iot-dlt-architecture/lists"}