Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/micro/services
Real World Micro Services
https://github.com/micro/services
micro services
Last synced: about 6 hours ago
JSON representation
Real World Micro Services
- Host: GitHub
- URL: https://github.com/micro/services
- Owner: micro
- License: apache-2.0
- Created: 2020-10-02T10:14:01.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2024-04-25T07:50:17.000Z (8 months ago)
- Last Synced: 2024-12-06T02:08:59.258Z (7 days ago)
- Topics: micro, services
- Language: Go
- Homepage:
- Size: 3.98 MB
- Stars: 1,273
- Watchers: 17
- Forks: 139
- Open Issues: 44
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-go - Micro Services - reusable real world microservices. Micro Services provide the fundamental building blocks for any products, apps or services. They can be used in isolation or combined to create a powerful distributed system. The services are intended to be consumed by each other using RPC and from the external world through a Micro API. (Micro services frameworks)
README
# Micro Services [](https://pkg.go.dev/github.com/micro/services?tab=doc) [](https://opensource.org/licenses/Apache-2.0)
Real world Micro services
## Overview
Micro services provide the fundamental building blocks for any products, apps or services. They can be used in isolation
or combined to create powerful distributed systems. The services are intended to be consumed by each other using RPC
and externally through the Micro API.
## Rationale
Read more about the reason for Micro Services in [this blog post](https://micro.dev/blog/2022/09/27/real-world-micro-services.html).
## Interfaces
Every service starts with a protobuf interface definition, which is a standard used by Google and everyone else now that gRPC is so dominant. The idea is to define the API in protobuf, code generate and implement the handlers for it. The services can be called by other services on the platform using those code generated clients or an API Gateway, which Micro provides. External calls via the API use the same format but with HTTP/JSON endpoints.
## Services
Services available thus far:
- address - Address lookup by postcode
- analytics - Track and retrieve events
- answer - Instant answers to any question
- app - Serverless app deployment
- avatar - Generate an avatar
- bitcoin - Bitcoin price and transaction info
- cache - Fast access key-value storage
- carbon - Purchase carbon offsets
- chat - Instant messaging service
- comments - Add comments to any App
- contact - Store your contacts
- cron - Schedule cron jobs
- crypto - Cryptocurrency prices, quotes, and news
- currency - Exchange rates and currency conversion
- db - Serverless postgres database
- dns - DNS over HTTPS (DoH)
- email - Send emails in a flash
- emoji - All the emojis you need 🎉
- ethereum - Ethereum API explorer
- evchargers - Find electric vehicle (EV) chargers wherever you go
- event - Event stream processing
- file - Store, list, and retrieve text files
- forex - Foreign exchange (FX) rates
- function - Serverless lambda functions
- geocoding - Address geocoding and reverse lookup
- gifs - Quick and simple GIF search
- google - Google search service
- helloworld - Just saying hello world
- holidays - Find the holidays observed in a particular country
- id - Generate unique IDs (uuid, snowflake, etc)
- image - Upload, resize, and convert images
- ip - IP to geolocation lookup
- joke - Funny Jokes
- lists - Make a list
- location - Real time GPS location tracking and search
- memegen - Generate funny memes
- minecraft - Minecraft server ping
- movie - Search for movies
- mq - PubSub messaging
- news - Get the latest news
- nft - Explore NFT Assets
- notes - Store and retrieve notes
- otp - One time password generation
- password - Generate strong passwords
- ping - Ping any IP
- place - Search for places
- postcode - Fast UK postcode lookup
- prayer - Islamic prayer times
- price - Global commodities index
- qr - QR code generator
- quran - The Holy Quran
- routing - Etas, routes and turn by turn directions
- rss - RSS feed crawler and reader
- search - Indexing and full text search
- sentiment - Real time sentiment analysis
- sms - Send SMS messages
- space - Infinite cloud storage
- spam - Check if an email is spam
- stock - Live stock quotes and prices
- stream - Ephemeral message streams
- sunnah - Traditions and practices of the Islamic prophet, Muhammad (pbuh)
- thumbnail - Create website thumbnails
- time - Time, date, and timezone info
- translate - Language translation service
- tunnel - Tunnel HTTP requests
- twitter - Realtime twitter timeline & search
- url - URL shortening, sharing, and tracking
- user - Authenticate and manage users
- vehicle - UK vehicle lookup
- wallet - Virtual Wallet
- weather - Real time weather forecast
- wordle - Multiplayer wordle
- youtube - Search for YouTube videos
## Usage
Micro Services depend on [Micro](https://github.com/micro/micro)
### Run Micro
Install and run the server first
```
micro server
```
### Run a Service
Run a service from source
```
micro run github.com/micro/services/helloworld
```
### Call a Service
To call a service from another
```go
import "github.com/micro/services/helloworld/proto"
```
Call it through the API
```
curl "http://localhost:8080/helloworld/Call?name=Alice"
```
From the command line
```
micro helloworld call --name=Alice
```
Browse to
```
http://localhost:8082/helloworld/Call
```
## Contribute
We welcome contributions of additional services:
- Services must be built using the Micro platform
- Any dependency must be configured using the Micro Config
- All services must include a README.md and be well commented
## Config
Config for each service should be stored under the service key by name
E.g db postgres host address `db.address`