plugin

package module
v2.0.1+incompatible Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Feb 2, 2020 License: Apache-2.0 Imports: 16 Imported by: 0

README

Plugins License GoDoc Travis CI Go Report Card

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.

Read the docs to learn more about how to use them.

Follow us on Twitter or join the Slack community.

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/micro/go-plugins/broker/rabbitmq"
	_ "github.com/micro/go-plugins/registry/kubernetes"
	_ "github.com/micro/go-plugins/transport/nats"
)

Create your service and ensure you call service.Init

package main

import (
	"github.com/micro/go-micro/v2"
)

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 (
	"github.com/micro/go-micro/v2"
	"github.com/micro/go-plugins/registry/kubernetes"
)

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/micro/go-plugins/broker/rabbitmq"
	_ "github.com/micro/go-plugins/registry/kubernetes"
	_ "github.com/micro/go-plugins/transport/nats"
)

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

Contributions

A few contributions by others

Feature Description Author
Registry/Kubernetes Service discovery via the Kubernetes API @nickjackson
Registry/Zookeeper Service discovery using Zookeeper @HeavyHorst

Documentation

Overview

Package plugin provides the ability to load plugins

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func Build

func Build(path string, p *Plugin) error

Build generates a dso plugin using the go command `go build -buildmode=plugin`

func Generate

func Generate(path string, p *Plugin) error

Generate creates a go file at the specified path. You must use `go build -buildmode=plugin`to build it.

func Init

func Init(p *Plugin) error

Init sets up the plugin

Types

type Plugin

type Plugin struct {
	// Name of the plugin e.g rabbitmq
	Name string
	// Type of the plugin e.g broker
	Type string
	// Path specifies the import path
	Path string
	// NewFunc creates an instance of the plugin
	NewFunc interface{}
}

Plugin is a plugin loaded from a file

func Load

func Load(path string) (*Plugin, error)

Load loads a plugin created with `go build -buildmode=plugin`

Directories

Path Synopsis
agent
api
auth Module
cors Module
gzip Module
header Module
index Module
metrics Module
router Module
broker
gocloud Module
googlepubsub Module
grpc Module
http Module
kafka Module
memory Module
mqtt Module
nats Module
nsq Module
proxy Module
rabbitmq Module
redis Module
segmentio Module
service Module
snssqs Module
sqs Module
stan Module
stomp Module
cache
redis Module
client
mock
Package mock provides a mock client for testing
Package mock provides a mock client for testing
http Module
codec
bsonrpc Module
json-iterator Module
jsonrpc2 Module
msgpackrpc Module
segmentio Module
config
encoder/cue Module
source/consul Module
source/etcd Module
source/grpc Module
source/mucp Module
source/pkger Module
source/url Module
source/vault Module
events
stream/nats Module
logger
apex Module
logrus Module
zap Module
zerolog Module
metrics
prometheus Module
micro
auth Module
cors Module
disable_rpc Module
gzip Module
header Module
index Module
ip_whitelist Module
metadata Module
metrics Module
router Module
stats_auth Module
trace/awsxray Module
trace/uuid Module
whitelist Module
proxy
http Module
registry
cache Module
consul Module
etcd Module
etcdv3 Module
eureka Module
gossip Module
kubernetes Module
mdns Module
memory Module
multi Module
nacos Module
nats Module
proxy Module
service Module
zookeeper Module
server
http Module
service
kubernetes Module
store
cockroach Module
consul Module
memcached Module
mysql Module
redis Module
sync
etcd Module
leader/consul Module
lock/consul Module
lock/redis Module
transport
grpc Module
http Module
memory Module
nats Module
quic Module
rabbitmq Module
tcp Module
utp Module
web
kubernetes Module
wrapper
endpoint Module
select/shard Module
service Module
trace/awsxray Module
trace/datadog Module
validator Module

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL