crow-han（基于go-micro框架的微服务脚手架）-01-快速启动（简介、快速启动、接口测试）

1. 简介

一个基于go-micro框架的微服务脚手架。用于轻松开发接入自己的微服务系统。

1.1 包含内容

• 用户系统
• 日志处理
• swagger接口文档
• 数据库链接
• redis链接
• Makefile
• 容器化
  • DokerFile
  • docker-compose.yml文件

1.2 swagger展示

• admin：
  管理员用户接口
• system：
  系统接口
• user
  普通用户接口

2. 快速启动

2.1 下载

https://gitee.com/xingzuo_1840/crow-han 下载最新的tag。

2.2 环境变量配置

• mysql

export CROW_MYSQL_IP="10.10.xxx.xxx"
export CROW_MYSQL_PORT="3306"
export CROW_DB_NAME="crow"
export CROW_MYSQL_USER="root"
export CROW_MYSQL_PASSWORD="xxxxxxx"

• redis

export CROW_RIDES_IP="10.10.xxx.xxx"
export CROW_RIDES_PORT="6379"
export CROW_RIDES_DB_NUM=2
export CROW_RIDES_PASSWORD="xxxxxxx" //如果没有密码不设置

• consul

export CROW_CONSUL_ADDR="10.10.xxx.xxx:8500"

能读到变量即可，可以在系统里设置，也可以在goland里设置。

2.3 goland配置

上文环境变量可以设置到各服务的 Environment 中。

• gateway
  
• auth
  
• user
  

2.5 启动

分别启动gate-way、auth、user三个服务

2.6 查看结果

• consul
  

如上可见，三个服务都上来了。

3. swagger 接口测试

3.1 url

http://127.0.0.1:1840/swagger/index.html

3.2 认证

采用了Bearer认证

3.2.1 获取token

• 找到登录接口，用默认管理员用户登录，填写如下：

默认用户 admin/liubei@161

• 确认后生产token如下：
  

3.2.2 Bearer 认证

• 点击页面顶部的Authorize按钮或各接口的锁标志。

• 输入Bearer + 前边获取到的token

Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2ODM4NzI2OTgsImlhdCI6MTY4Mzc4NjI5OCwidXNlcl9pZCI6MSwicGFzc3dvcmQiOiJsaXViZWlAMTYxIiwidXNlcm5hbWUiOiJhZG1pbiIsImZ1bGxfbmFtZSI6ImFkbWluIiwicGVybWlzc2lvbnMiOltdfQ.y0N-yGqNQzfpeA4YrFYYLJ-X4tNLl0x_B-9URpVcteA

注意空格

• 确认后结果如下
  
• 关闭后锁标识变成锁住的样子

3.3 测试接口（已创建用户为例）

• 在admin组中找到创建用户的接口，填写信息如：

{
  "email": "liubei@xishu.com",
  "password": "liubei@161",
  "phone": "13518888888",
  "role": "standerd",
  "user_name": "liuBei"
}

• 确认后结果如下

如上图，返回了创建用户的用户id。

• 根据刚才的id 查询创建结果
  
  结果如下
  

其他接口就不一 一演示了。

了解快速启动之后，我们就可以开始开发了。

---