https://github.com/restuwahyu13/go-discovery-api
Discovery API for interaction with consul, this API useful if you have API with Microservices architecture.
https://github.com/restuwahyu13/go-discovery-api
api consul discovery-service golang registry-server
Last synced: 6 months ago
JSON representation
Discovery API for interaction with consul, this API useful if you have API with Microservices architecture.
- Host: GitHub
- URL: https://github.com/restuwahyu13/go-discovery-api
- Owner: restuwahyu13
- Created: 2024-09-22T12:38:29.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-12-07T13:17:09.000Z (10 months ago)
- Last Synced: 2025-02-07T21:32:37.565Z (8 months ago)
- Topics: api, consul, discovery-service, golang, registry-server
- Language: Go
- Homepage:
- Size: 49.8 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Golang Service Discovery
This is basic concept for `service registry` and `discovery` if you want more complex use case , you can check this [video tutorial](https://www.youtube.com/watch?v=s3I1kKKfjtQ) or you can buy this [e-book](https://www.amazon.com/Consul-Up-Running-Luke-Kysow-ebook/dp/B0B2ZHXLCV) from amazon.
## Benefit Using Consul
- [x] Monitoring service is health or unhealth
- [x] Auto failover with cross server when one of service is dead, you can using `pairing feature`
- [x] Network security communication using tls encryption
- [x] Discovery & Registry service, you can find service using id or name
- [x] Management access control using `acl feature`, like A allow connect to B and C deny connecto to A
- [x] You can use Load Balancing, Rate Limit, Circuit Bracker etc
- [x] Cross cloud platform support and container support like `docker` or `kubernetes` for complex use case, you can use `kubernetes` is recommended because most populer and many fiture
- [x] Etc
## Simple Sample Policy
```hcl
service_prefix "prod-service-" {
policy = "read"
}
node_prefix "" {
policy = "read"
}
```
## Full Sample Policy
```hcl
acl = "write"
operator = "write"
mesh = "write"
peering = "write"
keyring = "write"
agent_prefix "" {
policy = "write"
}
node_prefix "" {
policy = "write"
}
identity_prefix "" {
policy = "write"
}
key_prefix "" {
policy = "write"
}
service_prefix "" {
policy = "write"
intentions = "write"
}
event_prefix "" {
policy = "write"
}
session_prefix "" {
policy = "write"
}
query_prefix "" {
policy = "write"
}
```
## Example Use Service Discovery Direct Connect To Consul
```js
import ConsulHashicorp from 'consul'
import axios from 'axios'
class Consul {
static consul = new ConsulHashicorp({ host: 'localhost', port: '8500', secure: false })
static getKV(key) {
return Consul.consul.kv.get(key)
}
static async health(serviceName, options) {
try {
const list = await Consul.consul.agent.check.list(options)
if (!list[serviceName]) {
return
}
return list[serviceName]
} catch (e) {
throw new Error(e)
}
}
static async service(serviceName, options) {
try {
const list = await Consul.consul.agent.service.list(options)
if (!list[serviceName]) {
return
}
return list[serviceName]
} catch (e) {
throw new Error(e)
}
}
}
;(async () => {
const secretToken = '4cf4f739-e472-dfa5-280e-1c507d5ee326' // I use production secret token
const svcGreatday = await Consul.service('prod-service-greatday', { token: secretToken })
const svcMekari = await Consul.service('prod-service-mekari', { token: secretToken })
axios
.get(`http://${svcGreatday?.Address}:${svcGreatday?.Port}`)
.then(({ data }) => console.log(`\n${svcGreatday.Service} Data:\n`, data))
.catch((e) => console.error(`\n${svcGreatday?.Service} Error:\n`, e?.message || e.cause?.code))
axios
.get(`http://${svcMekari?.Address}:${svcMekari?.Port}`)
.then(({ data }) => console.log(`\n${svcMekari?.Service} Data:\n`, data))
.catch((e) => console.error(`\n${svcMekari?.Service} Error:\n`, e?.message || e.cause?.code))
})()
```