8293988499
* Support direct generation of grpc method when package and service names of proto files are different. * fix req.Interface() return nil. * Get rid of dependence on 'Micro-Topic' * Revert "Get rid of dependence on 'Micro-Topic'" This reverts commit 3ff69443364d39f5fda3a32fc2249826e2d207dd. * Revert "fix req.Interface() return nil." This reverts commit 90a1b34195e07772fa6f2074e1cf22237ac2a87f. * Revert "Revert "fix req.Interface() return nil."" This reverts commit e64737b7da8d1767c4456881f6730f1c196cea60. * Revert "Revert "Get rid of dependence on 'Micro-Topic'"" This reverts commit 141bb0a557c81cb6d1c651b085b3e65483d5e681. * fix: consume and publish blocked after reconnecting Co-authored-by: maxinglun <maxinglun@zhijiaxing.net>
Plugins 
Go plugins is a place for community maintained plugins.
Overview
Micro tooling is built on a powerful pluggable architecture. Plugins can be swapped out with zero code changes. This repository contains plugins for all micro related tools. Read on for further info.
Getting Started
Contents
Contents of this repository:
| Directory | Description |
|---|---|
| Broker | PubSub messaging; NATS, NSQ, RabbitMQ, Kafka |
| Client | RPC Clients; gRPC, HTTP |
| Codec | Message Encoding; BSON, Mercury |
| Micro | Micro Toolkit Plugins |
| Registry | Service Discovery; Etcd, Gossip, NATS |
| Selector | Load balancing; Label, Cache, Static |
| Server | RPC Servers; gRPC, HTTP |
| Transport | Bidirectional Streaming; NATS, RabbitMQ |
| Wrapper | Middleware; Circuit Breakers, Rate Limiting, Tracing, Monitoring |
Usage
Plugins can be added to go-micro in the following ways. By doing so they'll be available to set via command line args or environment variables.
Import the plugins in a plugins.go file
package main
import (
_ "github.com/asim/go-micro/plugins/broker/rabbitmq/v4"
_ "github.com/asim/go-micro/plugins/registry/kubernetes/v4"
_ "github.com/asim/go-micro/plugins/transport/nats/v4"
)
Create your service and ensure you call service.Init
package main
import (
"go-micro.dev/v4"
)
func main() {
service := micro.NewService(
// Set service name
micro.Name("my.service"),
)
// Parse CLI flags
service.Init()
}
Build your service
go build -o service ./main.go ./plugins.go
Env
Use environment variables to set the
MICRO_BROKER=rabbitmq \
MICRO_REGISTRY=kubernetes \
MICRO_TRANSPORT=nats \
./service
Flags
Or use command line flags to enable them
./service --broker=rabbitmq --registry=kubernetes --transport=nats
Options
Import and set as options when creating a new service
import (
"go-micro.dev/v4"
"github.com/asim/go-micro/plugins/registry/kubernetes/v4"
)
func main() {
registry := kubernetes.NewRegistry() //a default to using env vars for master API
service := micro.NewService(
// Set service name
micro.Name("my.service"),
// Set service registry
micro.Registry(registry),
)
}
Build
An anti-pattern is modifying the main.go file to include plugins. Best practice recommendation is to include
plugins in a separate file and rebuild with it included. This allows for automation of building plugins and
clean separation of concerns.
Create file plugins.go
package main
import (
_ "github.com/asim/go-micro/plugins/broker/rabbitmq/v4"
_ "github.com/asim/go-micro/plugins/registry/kubernetes/v4"
_ "github.com/asim/go-micro/plugins/transport/nats/v4"
)
Build with plugins.go
go build -o service main.go plugins.go
Run with plugins
MICRO_BROKER=rabbitmq \
MICRO_REGISTRY=kubernetes \
MICRO_TRANSPORT=nats \
service