关键术语

简要概述

约束生成微服务所依赖的几个公共名称

内部变量

变量名中文名取值范围示例描述
CLI_VERSION工具版本[0-9].\d.\d0.3.0生成该模版所使用的 grpc-kit-cli 版本
ORGANIZATION组织代码见变量组合grpc-kit产品所在的公司或部门
PRODUCT_CODE产品代码^([a-z0-9]){4,}$opsaid同一产品使用相同代码,使用单个词
SHORT_NAME应用短名^([a-z0-9]){4,}$test1同一产品使用不同短名,使用单个词
API_VERSION接口版本v[1-9]+v1微服务主接口版本
APPNAME应用名称见变量组合opsaid-test1-v1xx
PROTO_PACKAGE服务包名见变量组合grpc_kit.api.opsaid.test1.v1x
SERVICE_CODE服务代码见变量组合test1.v1.opsaidxx
SERVICE_TITLE服务标题见变量组合OpsaidTest1xx
SERVICE_NAME服务全名见变量组合test1.v1.opsaid.api.grpc-kit.comxx

变量组合

变量名组合格式
APPNAME${PRODUCT_CODE}-${SHORT_NAME}-${API_VERSION}
PROTO_PACKAGE${ORGANIZATION}.api.${PRODUCT_CODE}.${SHORT_NAME}.${API_VERSION}
SERVICE_CODE${SHORT_NAME}.${API_VERSION}.${PRODUCT_CODE}
SERVICE_TITLE${PRODUCT_CODE}${SHORT_NAME}
SERVICE_NAME${SHORT_NAME}.${API_VERSION}.${PRODUCT_CODE}.${API_GATEWAY}

注意:

  1. 在 “PROTO_PACKAGE” 中,如果变量 “ORGANIZATION” 存在中化线"-",则需转化为下划线"_";
  2. 在 “SERVICE_TITLE” 中,变量 “PRODUCT_CODE” 与 “SHORT_NAME” 首字母均大写;