# Go Micro

Micro是一个可插拔的工具包和框架。内部功能都可以通过[go-plugins](https://github.com/micro/go-plugins)进行替换。

该工具包有一个单独的插件界面。[micro/plugin](https://github.com/micro/micro/tree/master/plugin)了解更多。

以下是关于go-micro插件的使用情况。

## 用法

可以通过以下方式将插件添加到go-micro中。通过这样做，他们可以通过命令行参数或环境变量进行设置。

### 导入插件

```
import (
    "github.com/micro/go-micro/cmd"
    _ "github.com/micro/go-plugins/broker/rabbitmq"
    _ "github.com/micro/go-plugins/registry/kubernetes"
    _ "github.com/micro/go-plugins/transport/nats"
)

func main() {
    // Parse CLI flags
    cmd.Init()
}
```

### 调用`service.Init`时也是一样

```
import (
    "github.com/micro/go-micro"
    _ "github.com/micro/go-plugins/broker/rabbitmq"
    _ "github.com/micro/go-plugins/registry/kubernetes"
    _ "github.com/micro/go-plugins/transport/nats"
)

func main() {
    service := micro.NewService(
        // Set service name
        micro.Name("my.service"),
    )

    // Parse CLI flags
    service.Init()
}
```

### 通过CLI标志使用

通过CLI标志激活

```
go run service.go --broker=rabbitmq --registry=kubernetes --transport=nats
```

### 直接使用插件

CLI标志提供了初始化插件的简单方法，但您可以自己做同样的事情。

```
import (
    "github.com/micro/go-micro"
    "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),
    )
}
```

## 构建模式

您可能想要使用自动化替换插件或将插件添加到micro工具包。一个简单的方法是通过为插件导入维护一个单独的文件并在构建过程中包含它。

创建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” 
)
```

构建plugins.go

```
shell go build -o service main.go plugins.go
```

运行plugins

```
shell service --broker=rabbitmq --registry=kubernetes --transport=nats
```

## 用插件重建工具包

如果你想集成插件，只需将它们链接到一个单独的文件并重建。

创建一个plugins.go文件

```
import (
        // etcd v3 registry
        _ "github.com/micro/go-plugins/registry/etcdv3"
        // nats transport
        _ "github.com/micro/go-plugins/transport/nats"
        // kafka broker
        _ "github.com/micro/go-plugins/broker/kafka"
)
```

构建二进制文件

```
// For local use
go build -i -o micro ./main.go ./plugins.go

// For docker image
CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -ldflags '-w' -i -o micro ./main.go ./plugins.go
```

插件标记的用法

```
micro --registry=etcdv3 --transport=nats --broker=kafka
```

## 仓库

go-micro插件可以在这里找到[github.com/micro/go-plugins](https://github.com/micro/go-plugins)。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://lixiangyun.gitbook.io/go-micro/plugins/gomicro.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.