diff --git a/src/.vitepress/config.mts b/src/.vitepress/config.mts index 7057490..27d17ea 100644 --- a/src/.vitepress/config.mts +++ b/src/.vitepress/config.mts @@ -17,7 +17,7 @@ export default defineConfig({ nav: [ { text: 'Home', link: '/' }, { text: '概述', link: '/overview/micro-service' }, - { text: '基础组件', link: '/infra' }, + { text: '安装', link: '/install/os' }, { text: '基础服务', link: '/base' }, { text: '应用服务', link: '/app' }, { @@ -43,6 +43,14 @@ export default defineConfig({ { text: 'Service Mesh 概述', link: '/overview/service-mesh' }, { text: 'Blocks Service Mesh 概述', link: '/overview/blocks-service-mesh' } ] + }, + { + text: '安装', + items: [ + { text: '部署环境', link: '/install/os' }, + { text: '系统变量', link: '/install/env' }, + { text: 'bsm 命令', link: '/install/bsm' } + ] } ], diff --git a/src/install/bsm.md b/src/install/bsm.md new file mode 100644 index 0000000..9bc86fe --- /dev/null +++ b/src/install/bsm.md @@ -0,0 +1,14 @@ +# Blocks Service Mesh 管理命令 + + 为了更好的管理系统系统,BSM提供了命令行管理工具 + +## 安装 +``` +curl +``` + +## 参数说明 +``` +bsm help + +``` \ No newline at end of file diff --git a/src/install/env.md b/src/install/env.md new file mode 100644 index 0000000..32f28d5 --- /dev/null +++ b/src/install/env.md @@ -0,0 +1,29 @@ +# 系统变量 + +## 网关组件 系统变量 +``` +# BSM安装目录,默认:/usr/local/bsm/ +BlocksMesh_Prefix=/usr/local/bsm/ + +# 运行模式:dev/test/prod,默认:dev +BlocksMesh_RuntimeMode=test + +# 微服务仓库URL,默认官方仓库 +BlocksMesh_Registry=http://registry.apinb.com +``` + + +## 微服务 系统变量 +``` +# BSM安装目录,默认:/usr/local/bsm/ +BlocksMesh_Prefix=/usr/local/bsm/ + +# 工作区,每个工作空间采用一个容器运行 +BlocksMesh_Workspace=heqi + +# 运行模式:dev/test/prod,默认:dev +BlocksMesh_RuntimeMode=test + +# 微服务仓库URL,默认官方仓库 +BlocksMesh_Registry=http://registry.apinb.com +``` \ No newline at end of file diff --git a/src/install/os.md b/src/install/os.md new file mode 100644 index 0000000..07b970c --- /dev/null +++ b/src/install/os.md @@ -0,0 +1,18 @@ +# 部署系统环境 + + blocks service mesh 需要部署相关的中间件来支撑整个系统的运行,我们主要说明服务器部署方式。 + +## 所需中间件 + +| 名称 | 是否必须 | 说明 | +|:------|:-------:|:------| +| Redis | 必须 | db数量设置为:256 | +| Etcd | 必须 | 服务发现,注册服务 | +| NATS | 必须 | 云原生,轻量MQ服务 | +| PostgreSQL | 必须 | 数据库服务,需要安装gis插件 | +| Prometheus | 可选 | 性能监控,也可以使用bsm的state轻量化组件 | +| Jaeger | 可选 | 链路监控软件 | +| ElasticSearch | 可选 | 可以使用轻量极的:ParadeDB 替代 | +| Pulsar | 可选 | 即时通讯微服务时,必须安装 | +| ScyllaDB | 可选 | 即时通讯微服务时,必须安装 | +