Skip to content

koala-coding/create-bff-service-cli

Repository files navigation

create-bff-service-cli

介绍

快速搭建一个基于 egg框架 的 bff-service cli工具。

  • 服务模版多种语言可选模 typescript/javascript (建议选择 typescript,目前只添加了typescript 模版)
  • 模版内容支持根据交互动态配置,具体可配置内容请看下文参数说明
  • 服务模版编码规范已完善,已添加 eslintprettiertsconfig 配置等,并且支持自动保存校验,.vscodesettings.json 已配置 。
  • 提供了基本项目结构 routercontrollerserviceconfig 配置等,可直接测试template中提供的基础接口。

快速开始

使用前的准备工作

  1. 安装 node.js

    node.js安装可以官网下载安装,https://nodejs.org/

    也可以使用 nvs安装,方便切换版本,https://github.com/jasongin/nvs

  2. 安装 yarn

    > npm install -g yarn
    
  3. 安装 nrm nrm 作用是修改 npm 的镜像源 安装 nrm

    > npm install -g nrm

    设置 npm 源为私服地址:

    > nrm add me http://*.*.*.*:78900
    > nrm use me
  4. 建议 IDE vscode

  5. vscode必装插件 ESLint

    Prettier - Code formatter

    通过这两个插件,配合项目中的规则配置文件,可以使团队中的代码格式化规则一致

安装 create-bff-service-cli

> npm install -g create-bff-service-cli

安装之后就可以使用 cli 命令: create-bff-service

cli 执行命令说明

在命令行执行命令

create-bff-service init

然后会出现交互提示,按照交互提示输入各项参数。

参数项说明
  1. 服务名称 serviceName: 服务的英文名称,例如: xxx-bff-service
  2. 作者 author: 作者的英文名称,例如:xiaoming
  3. 服务端口号 port: 找运维申请的服务端口号,例如:7001
  4. 版本号 version: 服务的版本号,例如:0.0.1
  5. 介绍 description: 服务的介绍 例如:某业务线的 BFF 服务
  6. 模版 template: 选择模版 例如:选择 typescript 模版
  7. 项目版本管理 git: 选择是否 git 初始化项目 例如: yes git 初始化项目
  8. 项目依赖安装 install: 选择是否安装依赖 例如: yes install 所有依赖
使用调试模式启动 cli 创建的 bff-service
> yarn debug
模版接口测试

接口访问测试:调用 demo/demo1 路由,获取服务返回数据。

curl http://127.0.0.1:7890/demo/demo1

// 返回结果
{"status":200,"data":{"r":"hello word"}}    
模版代码保存自动格式化配置

该功能正常使用前提需要安装前文提到的 vscode 插件

About

快速搭建一个基于 egg 的,规范的 bff-service

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published