docs: update quickstart

pull/56/head
moonrailgun 3 years ago
parent 1a14967d9e
commit 4e2ee6b288

@ -1,6 +1,6 @@
---
sidebar_position: 3
title: 架构
title: 系统架构
---
## 服务端架构

@ -1,4 +1,4 @@
{
"label": "部署",
"label": "应用部署",
"position": 10
}

@ -9,7 +9,7 @@ title: Docker Compose 部署
首先需要确保有 `Docker / Docker Compose` 环境
安装方式可参考 : [安装 Docker 环境](./install-docker.md)
安装方式可参考: [安装 Docker 环境](./install-docker.md)
## 拉取镜像
@ -101,3 +101,7 @@ docker-compose up -d
```
docker volume ls | grep "tailchat-server"
```
:::info
完整的环境变量可以查询 [环境变量](./environment.md)
:::

@ -24,10 +24,10 @@ title: 环境变量
### 使用文件进行配置环境变量
如果是本地方式启动,请复制 `.env.example``.env` 然后进行编辑
```bash
mv .env.example .env
vi .env
```
- 如果是本地方式启动,请复制 `.env.example``.env` 然后进行编辑
```bash
mv .env.example .env
vi .env
```
如果是 `docker-compose` 启动,可以直接编辑 `docker-compose.env`, 改动后直接使用 `docker-compose up -d` 即可生效
- 如果是 `docker-compose` 启动,可以直接编辑 `docker-compose.env`, 改动后直接使用 `docker-compose up -d` 即可生效

@ -3,150 +3,18 @@ sidebar_position: 1
title: 快速开始
---
<iframe src="//player.bilibili.com/player.html?aid=853731563&bvid=BV1aL4y1c7QM&cid=710880091&page=1" scrolling="no" border="0" frameborder="no" framespacing="0" allowfullscreen="true" />
## 演示环境
[在B站观看](https://www.bilibili.com/video/BV1aL4y1c7QM)
演示环境会持续部署最新前端代码和不定期更新后端代码
## 前端代码
[https://nightly.paw.msgbyte.com/](https://nightly.paw.msgbyte.com/)
拉取前端源码:
## 部署方式
```bash
git clone https://github.com/msgbyte/tailchat
强烈推荐使用 `docker-compose` 部署 `tailchat`
cd tailchat
```
教程请翻阅: [Docker Compose 部署](./docker-compose.md)
### 方法一: 使用预编译好的镜像 使用docker-compose 一键启动
## 系统架构
请确保已经安装了:
- docker
- docker-compose
*如果不会安装docker可以查看 [安装教程](./install-docker.md) *
```bash
docker pull moonrailgun/tailchat:latest
docker tag moonrailgun/tailchat:latest tailchat-web
SERVICE_URL=http://[Server IP]:11000 docker-compose up -d
```
访问 `http://[Server IP]:11011` 即可访问到Tailchat的前端页面
**`[Server IP]`请换成服务端的ip或者绑定的域名, 11000为服务端默认端口号**
**如果有条件的建议使用https协议在此不进行赘述**
### 方法二: 使用 docker-compose 一键编译并部署
请确保已经安装了:
- docker
- docker-compose
*如果不会安装docker可以查看 [安装教程](./install-docker.md) *
```bash
docker-compose build
SERVICE_URL=http://[Server IP]:11000 docker-compose up -d
```
访问 `http://[Server IP]:11011` 即可访问到Tailchat的前端页面
**`[Server IP]`请换成服务端的ip或者绑定的域名, 11000为服务端默认端口号**
**如果有条件的建议使用https协议在此不进行赘述**
### 方法三: 手动编译
**请确保安装了node环境建议node版本大于 16.x**
编译服务依赖 `pnpm` 进行依赖管理
> pnpm 是 npm 的替代品, 更多信息可见 [https://pnpm.io/](https://pnpm.io/)
```bash
npm install -g pnpm # 如果在此之前没有安装过pnpm
pnpm install
cd web # 切换到web目录
```
创建/修改 `.env` 设置环境变量
```ini
SERVICE_URL=http://127.0.0.1:11000
```
环境变量:
- `SERVICE_URL`: 后端服务的地址
- `PORT`: 前端开发环境的端口(`pnpm dev`)
编译代码
```
pnpm build
```
使用任意http代理 `web/dist` 目录即可注意需要支持spa的fallback机制
- 使用 `http-server-spa` 进行前端文件代理: `npx http-server-spa ./web/dist index.html 11011`
- `11011``Tailchat` 的默认端口号,可以改成任意想要的端口
## 后端服务
拉取后端源码:
```bash
git clone https://github.com/msgbyte/tailchat-server
cd tailchat-server
```
### 单节点部署
#### 方法一: docker-compose 拉取预编译好的镜像并部署 (推荐)
请确保已经安装了:
- docker
- docker-compose
*如果不会安装docker可以查看 [安装教程](./install-docker.md) *
修改 `docker-compose.env` 中的 `API_URL` 配置将其改为服务端可访问的url
在项目根目录下执行
```bash
docker pull moonrailgun/tailchat-server:latest
docker tag moonrailgun/tailchat-server:latest tailchat-server
docker-compose up -d
```
#### 方法二: docker-compose 一键构建并部署
请确保已经安装了:
- docker
- docker-compose
*如果不会安装docker可以查看 [安装教程](./install-docker.md) *
修改 `docker-compose.env` 中的 `API_URL` 配置将其改为服务端可访问的url
在项目根目录下执行
```bash
docker-compose build # 需要编译
docker-compose up -d
```
### k8s集群部署
TODO
### 服务端插件安装方式
安装所有插件
```
pnpm plugin:install all
```
安装单个插件
```
pnpm plugin:install com.msgbyte.tasks
```
见 [系统架构](../architecture.md)

Loading…
Cancel
Save