Este é o projeto que utilizamos na Especialização em OpenTelemetry no Dose de Telemetria. Aqui temos uma aplicação relativamente simples, mas utilizando diversos aspectos de aplicações normais, como conexões HTTP e gRPC entre si, comunicação com banco de dados, envio e recebimento de mensagens via mensageria (message queue).
A aplicação não possui nenhuma instrumentação. Nada. Durante a especialização, vamos utilizar a aplicação para aprender diversos aspectos de observabilidade, com foco em OTel.
-
cmd/users:- Descrição: Este módulo contém a aplicação principal para gerenciar usuários. Ele lida com operações como criação, atualização e exclusão de usuários.
-
cmd/payments:- Descrição: Este módulo é responsável pelo processamento de pagamentos. Ele gerencia transações financeiras e integrações com gateways de pagamento. Ao receber uma requisição para um novo pagamento, coloca a requisição em uma fila de mensagens. Uma rotina na mesma aplicação recebe a mensagem e processa o pagamento, armazenando em um banco de dados SQLLite.
-
cmd/all-in-one:- Descrição: Este módulo combina todas as funcionalidades em uma única aplicação. Ele é útil para desenvolvimento e testes locais, permitindo executar todos os serviços em um único processo.
-
cmd/plans:- Descrição: Este módulo gerencia os planos de assinatura disponíveis. Ele lida com a criação, atualização e exclusão de planos. Aceita requisições tanto em HTTP quanto gRPC.
-
cmd/subscriptions:- Descrição: Este módulo gerencia as assinaturas dos usuários aos planos. Ele lida com a criação, atualização e cancelamento de assinaturas.
Por padrão, um arquivo de configuração não é necessário, especialmente ao rodar o "all-in-one". Ao fazer a aplicação rodar separadamente, a maioria dos serviços vai precisar de um arquivo de configuração específico, que segue o seguinte formato:
# yaml-language-server: $schema=./config-schema.yaml
payments:
subscriptions_endpoint: http://localhost:8080/subscriptions
sqlite:
dsn: file::memory:?cache=shared
nats:
endpoint: nats://localhost:4222
subject: payment.process
stream: payments
consumer_name: payments
subscriptions:
users_endpoint: http://localhost:8080/users
plans_endpoint: http://localhost:8080/plans
plans: {}
users: {}
server:
endpoint:
grpc: :8081
http: :8080- Os serviços "plans" e "users" não tem dependências com outros serviços. O serviço "subscriptions" precisa fazer conexões com "plans" e "users", enquanto que "payments" faz uma conexão com "subscriptions".
Instalação do nats-server e nats
## nats-server
brew install nats-server
## NATS Command Line Interface
brew tap nats-io/nats-tools
brew install nats-io/nats-tools/nats
Quer ajudar a melhorar este projeto? Veja como começar no arquivo CONTRIBUTING.md. O guia explica como criar Issues, enviar Pull Requests e seguir as melhores práticas para contribuir de forma eficiente.
Este projeto está licenciado sob a licença Apache v2. Veja o arquivo LICENSE para mais detalhes.