supermq

Supermq

O SuperMQ é plataforma de nuvem moderna, escalável, segura, de código aberto e sem patentes para mensagens e arquitetura orientada a eventos (EDA) escrita em Go.

Ele aceita conexões de usuário e cliente (dispositivo, usuário, aplicativo) em vários protocolos de rede (ou seja, http, mqtt, websocket, coap), criando uma ponte perfeita entre eles. É usado como backbone da arquitetura para construir soluções distribuídas complexas.

Para mais detalhes, consulte a documentação oficial. Para bits e serviços extras, consulte nosso repositório contribuinte.

Características

• Conectividade e ponte multiprotocolo (HTTP, MQTT, WebSocket e ROAP; consulte o Repositório de Contrib para Lora e OPC UA)
• Gerenciamento e provisionamento de dispositivos (provisionamento de toque zero)
• Autenticação TLS mútua (MTLS) usando certificados X.509
• Controle de acesso de granulação fina (Políticas, ABAC/RBAC)
• Persistência de mensagens (escala de tempo e postgressql - veja o repositório contribuinte para suporte de Cassandra, InfluxDB e MongoDB)
• Montagem de plataforma e suporte de instrumentação (Prometheus e Opentelemetria)
• Fornecimento de eventos
• Implantação baseada em contêineres usando o Docker e Kubernetes
• Agente de borda e serviços de exportação para gerenciamento remoto de gateway e computação de borda
• Sdk
• CLI
• Pegada de memória pequena e execução rápida
• Arquitetura de design orientada por domínio, código de alta qualidade e cobertura de teste

Pré -requisitos

Os seguintes são necessários para executar o SuperMQ:

• Docker (versão 26.0.0)

O desenvolvimento do SuperMQ também exigirá:

• GO (versão 1.21)
• Protobuf (versão 25.1)

Instalar

Depois que os pré -requisitos forem instalados, execute os seguintes comandos da raiz do projeto:

docker compose -f docker/docker-compose.yml --env-file docker/.env -p git_github_com_absmach_supermq_git_  up

Isso trará os serviços do SuperMQ Docker e os interconectará. Este comando também pode ser executado usando o projeto incluído do projeto:

make run

Se você deseja executar serviços a partir de um código de checkout de lançamento específico do Github e verifique se SMQ_RELEASE_TAG em .env está sendo definido para corresponder à versão de liberação

git checkout tags/ < release_number > -b < release_number >
# e.g. `git checkout tags/0.13.0 -b 0.13.0`

Verifique se o arquivo .env contém:

SMQ_RELEASE_TAG= < release_number >

docker-compose deve ser usado para desenvolvimento e teste de implantações. Para produção, sugerimos o uso de Kubernetes.

Uso

A maneira mais rápida de começar a usar o SuperMQ é através da CLI. A versão mais recente pode ser baixada na página oficial de lançamentos.

Também pode ser construído e usado a partir do diretório raiz do projeto:

make cli
./build/cli version

Detalhes adicionais sobre o uso da CLI podem ser encontrados na documentação da CLI.

Documentação

A documentação oficial está hospedada na página oficial do SuperMQ. A documentação é gerada automaticamente, consulte as instruções sobre o repositório oficial do DOCS:

Se você encontrar um erro ou uma necessidade de correções, informe -nos - ou até melhor: envie -nos um PR.

Autores

O arquiteto principal e o projeto BDFL do SuperMQ é @drasko.

Além disso, o @NMarcetic e o @Janko-Isidorovic garantiram arquitetura e design gerais, enquanto @manuio e @darkodraskovic ajudaram a criar implementação inicial e trabalharam continuamente nas evoluções do projeto.

Além deles, o SuperMQ é constantemente melhorado e desenvolvido ativamente por @Anovakovic01, @DusanB94, @srados, @gsaleh, @blokovi, @chombium, @mteodor, @rodneyosodo e um grande conjunto de contribuidores.

Os mantenedores estão listados no arquivo de mantenedores.

A equipe do SuperMQ gostaria de agradecer ao @Mijicd por seu trabalho monumental sobre o design e a implementação de uma versão altamente aprimorada e otimizada da plataforma, e @Malidukica por seu esforço na implementação da interface inicial do usuário.

Apoio profissional

Existem muitas empresas que oferecem suporte profissional para o sistema SuperMQ.

Se você precisar desse tipo de apoio, o melhor é entrar em contato diretamente com @drasko, e ele apontará você para a equipe de suporte com melhor correspondência.

Contribuindo

Obrigado pelo seu interesse no SuperMQ e pelo desejo de contribuir!

1. Dê uma olhada em nossos problemas abertos. O rótulo de bom primeiro de emissão é especificamente para problemas que são ótimos para começar.
2. Confira o guia de contribuição para saber mais sobre nosso estilo e convenções.
3. Torne suas alterações compatíveis com o nosso fluxo de trabalho.

Além disso, explore nosso repositório contribuinte para serviços extras como Cassandra, InfluxDB, leitores e escritores do MongoDB, Lora, OPC UA Suporte, Twins Digital e muito mais. Se você tem uma contribuição que não é uma boa opção para o Monorepo Core (é específico para o seu caso de uso, é um recurso adicional ou um novo serviço, é opcional ou um complemento), este é um ótimo local para enviar a solicitação de tração.

Estamos contratando

Você gosta do SuperMQ e gostaria de fazer o seu trabalho diário? Estamos sempre procurando engenheiros talentosos interessados ​​em sistemas de código aberto, IoT e distribuídos. Se você se reconhecer, entre em contato com @drasko - ele entrará em contato com você de volta.

A melhor maneira de chamar nossa atenção é, é claro, enviando PRs?

Comunidade

• Grupo do Google
• Gitter
• Twitter

Licença

Apache-2.0

Coleta de dados para SuperMQ

O SuperMQ está comprometido em melhorar continuamente seus serviços e garantir uma experiência perfeita para seus usuários. Para conseguir isso, coletamos certos dados de suas implantações. Tenha certeza, esses dados são coletados apenas com o objetivo de melhorar o SuperMQ e não são usados ​​com nenhuma intenção maliciosa. O resumo da implantação pode ser encontrado em nosso site.

Os dados coletados incluem:

• Endereço IP - usado para obter informações de localização aproximadas sobre implantações.
• Serviços usados ​​- para entender quais recursos são populares e priorizar desenvolvimentos futuros.
• Último tempo visto - para garantir a estabilidade e a disponibilidade do SuperMQ.
• Versão SuperMQ - para rastrear a versão do software e entregar atualizações relevantes.

Levamos a sua privacidade e segurança de dados a sério. Todos os dados coletados são tratados de acordo com nossas rigorosas políticas de privacidade e melhores práticas do setor.

A coleta de dados está ligada por padrão e pode ser desativada definindo a variável Env: SMQ_SEND_TELEMETRY=false

Ao utilizar o SuperMQ, você contribui ativamente para sua melhoria. Juntos, podemos construir uma plataforma mais robusta e eficiente. Obrigado por sua confiança no SuperMQ!