mirror of
https://github.com/kevin-DL/services.git
synced 2026-01-12 03:05:14 +00:00
59 lines
1.4 KiB
Markdown
59 lines
1.4 KiB
Markdown
# Micro Services
|
|
|
|
Programmable 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 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.
|
|
|
|
## Cloud
|
|
|
|
Find cloud hosted services on [m3o.com](https://m3o.com).
|
|
|
|
## Usage
|
|
|
|
Run a service from source
|
|
|
|
```
|
|
micro run github.com/micro/services/helloworld
|
|
```
|
|
|
|
To call a service from another
|
|
|
|
```
|
|
import (
|
|
pb "github.com/micro/services/helloworld/proto"
|
|
)
|
|
```
|
|
|
|
## Clients
|
|
|
|
API clients are generated in [clients](https://github.com/micro/services/tree/master/clients)
|
|
|
|
To call a service via the api client import as follows
|
|
|
|
```
|
|
import "github.com/micro/services/clients/go/db"
|
|
|
|
client := db.NewDbService($MICRO_API_TOKEN)
|
|
client.Create(...)
|
|
```
|
|
|
|
## Examples
|
|
|
|
See the [examples](https://github.com/micro/services/tree/master/examples) directory
|
|
|
|
## Contribute
|
|
|
|
We welcome contributions of additional services which are then hosted on [m3o.com](https://m3o.com).
|
|
|
|
- Services must be built using the Micro platform
|
|
- Any dependency must be configured using the Micro Config
|
|
- All services to be published must include a `publicapi.json` file
|
|
|
|
## License
|
|
|
|
[Polyform Shield](https://polyformproject.org/licenses/shield/1.0.0/)
|