通过命令行模式与 Go Micro 微服务进行交互

除了前面介绍的 Web 仪表盘之外，Micro 生态系统还提供了命令行接口与 Go Micro 微服务进行交互。

启动命令行

启动命令行模式很简单，运行如下命令即可：

micro cli

然后我们可以通过 help 指令查看命令行模式支持的所有指令：

其中的部分指令在 Micro Web 的 CLI 界面中也可以执行，或者通过 Registry、Call 这两个可视化的页面查看、测试，但是显然 Micro CLI 模式支持的指令更多，包括服务的注册和反注册、所有服务的列举、单个服务接口信息查看和调用、服务接口健康检测和状态查看等，下面我们就来简单演示下这些指令的执行。

常用指令示例

首先我们演示下服务的注册与反注册（除了在命令行交互模式中运行指定指令外，还可以在外部直接通过 micro + 命令的方式调用它们）：

返回 ok 表示操作成功，然后我们来看看某个服务接口的查看、调用、健康、状态指令的执行：

我们可以看到 go.micro.srv.greeter 服务节点的注册信息，以及服务接口的端点、请求和响应数据结构，下面我们根据这些接口信息通过 micro call 指令来调用这个服务：

返回结果与接口文档描述一致，我们还可以通过 health 和 stats 来查看服务的健康、状态信息：

health 主要用于检查服务节点是否可用（是否健康），stats 主要用于检查服务节点的状态信息（启动时间、内存占用、进程及 gc 等信息）。

底层源码分析

micro cli 命令行模式支持的指令对应的底层源码位于 github.com/micro/micro/cli/cli.go 中：

var (
	prompt = "micro> "

	commands = map[string]*command{
		"quit":       &command{"quit", "Exit the CLI", quit},
		"exit":       &command{"exit", "Exit the CLI", quit},
		"call":       &command{"call", "Call a service", callService},
		"list":       &command{"list", "List services", listServices},
		"get":        &command{"get", "Get service info", getService},
		"stream":     &command{"stream", "Stream a call to a service", streamService},
		"publish":    &command{"publish", "Publish a message to a topic", publish},
		"health":     &command{"health", "Get service health", queryHealth},
		"stats":      &command{"stats", "Get service stats", queryStats},
		"register":   &command{"register", "Register a service", registerService},
		"deregister": &command{"deregister", "Deregister a service", deregisterService},
	}
)

type command struct {
	name  string
	usage string
	exec  exec
}

func runc(c *cli.Context) {
	commands["help"] = &command{"help", "CLI usage", help}
	...

micro cli 启动后，会开启一个无限循环读取用户输入，然后通过与 commands 字典的映射来执行对应的指令：

for {
	args, err := r.Readline()
	if err != nil {
		fmt.Fprint(os.Stdout, err)
		return
	}

	args = strings.TrimSpace(args)

	// skip no args
	if len(args) == 0 {
		continue
	}

	parts := strings.Split(args, " ")
	if len(parts) == 0 {
		continue
	}

	name := parts[0]

	// get alias
	if n, ok := alias[name]; ok {
		name = n
	}

	if cmd, ok := commands[name]; ok {
		rsp, err := cmd.exec(c, parts[1:])
		if err != nil {
			println(err.Error())
			continue
		}
		println(string(rsp))
	} else {
		println("unknown command")
	}
}

exec 是一个函数类型，对应的函数已经在上面初始化 commands 字典的时候指定好了，每个指令对应的函数定义在 github.com/micro/micro/cli/helpers.go 中（help 和 quit 指令函数定义在 github.com/micro/micro/cli/commands.go 中），最终调用的代码位于 github.com/micro/micro/internal/command/cli/command.go 里面，具体实现逻辑感兴趣的同学可以自己去看看。

如果是通过 micro + 命令的方式直接调用，而不是通过命令行模式交互的话，底层最终调用的函数也是一样的，只是这些指令注册的方式不同，但还是在 github.com/micro/micro/cli/cli.go 中：

func registryCommands() []cli.Command {
	return []cli.Command{
		{
			Name:  "list",
			Usage: "List items in registry",
			Subcommands: []cli.Command{
				{
					Name:   "services",
					Usage:  "List services in registry",
					Action: printer(listServices),
				},
			},
		},
		...
	}
}

func Commands() []cli.Command {
	commands := []cli.Command{
		...
		{
			Name:   "call",
			Usage:  "Call a service",
			Action: printer(callService),
		},
		...
		{
			Name:   "health",
			Usage:  "Query the health of a service",
			Action: printer(queryHealth),
		},
		{
			Name:   "stats",
			Usage:  "Query the stats of a service",
			Action: printer(queryStats),
		},
	}

	return append(commands, registryCommands()...)
}

并且在注册时，通过 Action 参数指定对应的底层执行函数，这些函数的定义和命令行交互模式一样，定义在 github.com/micro/micro/cli/helpers.go 中，然后当我们在命令行执行某个命令，比如 micro call，则 Micro 底层会执行 Action 对应的函数来处理该命令。