micro/micro

Micro ![License]([***]

Micro是一个API优先的云平台。

概述

Micro解决了云环境中服务构建的关键需求，采用微服务架构模式，提供作为平台构建块的服务集。它处理分布式系统的复杂性，并提供更简单的可编程抽象，便于在此基础上进行开发。

目录

• 简介 - Micro的高层级介绍
• 快速开始 - HelloWorld快速入门指南
• 升级指南 - 将go-micro项目更新为使用micro v3
• 架构 - 描述架构、设计和权衡
• 参考 - Micro CLI和服务的深入参考
• 资源 - 外部资源和贡献
• 路线图 - 长期规划内容
• 常见问题 - 常见问题解答

核心功能

以下是构成Micro的核心组件：

服务器（Server）

Micro基于微服务架构构建，抽象底层基础设施复杂性。对用户呈现为单个逻辑服务器，内部分解为可插入任何底层系统的构建块原语，包含以下服务：

• API：HTTP网关，通过基于路径的解析动态将http/json请求映射到RPC
• Auth：开箱即用的认证授权，使用JWT令牌和基于规则的访问控制
• Broker：临时发布订阅消息传递，用于异步通信和通知分发
• Config：动态配置和密钥管理，支持服务级配置无需重启
• Events：事件流，支持有序消息传递、从偏移量重放和持久化存储
• Network：服务间网络、隔离和路由平面，处理所有内部请求流量
• Proxy：身份感知代理，用于远程访问和外部gRPC请求流量
• Runtime：服务生命周期和进程管理，支持从源代码到运行的自动构建
• Registry：集中式服务发现和API端点探索器，附带丰富元数据
• Store：键值存储，支持TTL过期和持久化CRUD操作，保持微服务无状态
• Web：Web仪表板，提供动态表单用于在浏览器中描述和查询服务

框架（Framework）

内置Go框架简化服务开发，无需编写大量样板代码，默认自动配置和初始化，导入即可快速开始开发。

命令行（Command Line）

提供定制化CLI体验，支持动态命令映射（将服务转为CLI命令）、多环境切换（micro env set [environment]）、命名空间管理（micro user set [namespace]）、认证凭据自动刷新、服务状态监控和日志流等功能。

环境（Environments）

支持多租户，通过命名空间和环境概念，可在本地开发、云端 staging 和生产环境无缝切换，统一管理不同部署环境。

快速开始

安装Micro

sh
go install github.com/micro/micro/v3@latest

运行服务器

sh
micro server

登录系统

使用默认凭据登录（用户名：admin，密码：micro）：

sh
$ micro login
Enter username: admin
Enter password:
Successfully logged in.

查看运行服务

sh
$ micro services
api
auth
broker
config
events
network
proxy
registry
runtime
server
store

访问Web界面：localhost:8082

部署服务

sh
micro run github.com/micro/services/helloworld

查看服务状态

sh
$ micro status
NAME		VERSION	SOURCE					STATUS	BUILD	UPDATED	METADATA
helloworld	latest	github.com/micro/services/helloworld	running	n/a	4s ago	owner=admin, group=micro

查看服务日志

sh
$ micro logs helloworld
2020-10-06 17:52:21  file=service/service.go:195 level=info Starting [service] helloworld
2020-10-06 17:52:21  file=grpc/grpc.go:902 level=info Server [grpc] Listening on [::]:33975
2020-10-06 17:52:21  file=grpc/grpc.go:732 level=info Registry [service] Registering node: helloworld-67627b23-3336-4b92-a032-09d8d13ecf95

调用服务

sh
$ micro helloworld call --name=Jane
{
	"msg": "Hello Jane"
}

使用curl调用

sh
curl "http://localhost:8080/helloworld?name=John"

编写客户端代码

go
package main

import (
	"context"
	"fmt"
	"time"

	"github.com/micro/micro/v3/service"
	proto "github.com/micro/services/helloworld/proto"
)

func main() {
	// 创建并初始化新服务
	srv := service.New()

	// 创建helloworld的proto客户端
	client := proto.NewHelloworldService("helloworld", srv.Client())

	// 调用服务端点
	rsp, err := client.Call(context.Background(), &proto.CallRequest{
		Name: "John",
	})
	if err != nil {
		fmt.Println("调用helloworld出错: ", err)
		return
	}

	// 打印响应
	fmt.Println("响应: ", rsp.Message)
	
	// 延迟进程退出，原因如下文所述
	time.Sleep(time.Second * 5)
}

运行客户端

sh
micro run .

更多信息参见快速开始指南。

使用方法

有关架构、安装和使用的详细信息，请参见文档。

许可证

采用Apache 2.0许可证，详见LICENSE。