手动部署

部署Fireboom一般意味着要同时部署:Fireboom服务和钩子服务。

部署时需要将Fireboom服务依赖的配置文件和钩子服务(二进制或代码)上传到服务器。

目录介绍

Fireboom服务依赖的目录

Fireboom服务启动时需要依赖如下目录,详情见下文:

├─ .gitignore 
├─ .env # 环境变量,开发环境和部署环境一般不同
├─ custom-go # golang钩子目录,详情见下文
├─ custom-ts # Nodejs钩子目录,详情见下文
├─ log # 日志目录,无需上传
├─ exported # 部署时无需上传,可用./fireboom build 命令生成
├─ store # 必须上传
├─ template # 部署时若不上传,则fireboom启动时会自动下载
└─ upload # 必须上传

钩子服务依赖的目录

钩子服务依赖的目录,取决于钩子服务的语言类型。

  • 脚本语言:需要上传代码,例如:nodejs typescript

  • 编译语言:只需要上传二进制,例如:golang

├─ custom-go
│  ├─ main # golang 钩子的二进制
│  ├─ helix.html # 钩子中graphql服务的面板静态文件
│  ├─ generated # 部署时无需上传,可用./fireboom build 命令生成

golang可跨平台编译,可在开发环境编译出对应版本直接上传!

同步目录

同步上述目录有两种方案:github(推荐)和工具同步。

github(推荐)

推荐使用github管理项目,支持版本控制与多人协作。

部分文件不需要上传到开发环境,可以用.gitignore忽略,参考如下:

.gitignore
# bin file
fireboom
# hook
node_modules
yarn.lock
package-lock.json
pnpm-lock.yaml

# log
log/*

在生产服务器上用 git 命令拉取项目即可。

工具同步

使用IDE或rsync将文件同步到服务器,例如:

rsync -avr  --exclude 'node_modules' --exclude 'fireboom' ./* [email protected]:/path/to/publish

环境准备

钩子启动环境

不同语言的钩子服务有不同的环境,需要参考各编程语言进行准备:

‌curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash
nvm install stable
node -v
  • golang钩子:无需准备环境

环境变量

Fireboom的环境变量存储在根目录下的.env文件中,生产环境需要根据实际情况修改。

FB_API_PUBLIC_URL="http://localhost:9991" # 修改为公网IP
FB_API_LISTEN_HOST="localhost" # 用IP访问,请修改为 0.0.0.0
FB_API_LISTEN_PORT="9991" # 用IP访问,请放开防火墙
FB_API_INTERNAL_URL="http://localhost:9991" 
FB_SERVER_URL="http://localhost:9992"
FB_SERVER_LISTEN_HOST="localhost"
FB_SERVER_LISTEN_PORT="9992"

其他环境变量,如数据库URL等,请按照实际情况修改。

启动服务

构建依赖

启动钩子服务前,需要先执行Fireboom构建命令:

# cd‌ [project-name] 进入项目根目录
./fireboom build 

它会生成两类产物:

  • Fireboom服务生产模式依赖的产物,如exported目录下的文件

  • 钩子服务依赖的文件

    • 所有钩子都依赖的配置,包括custom-x/generated/目录下的 fireboom.config.json和fireboom.operations.json

    • 脚本钩子依赖的代码,例如 nodejs依赖的custom-ts/generated/*.ts

启动钩子

根据钩子服务产物的类型执行不同命令,启动钩子服务。

对于编译语言,直接执行二进制即可,例如golang钩子:

cd custom-go
./main # 启动服务

对于脚本语言,一般需要先安装依赖,然后再启动,例如 typescript钩子:

‌cd custom-ts
# 安装依赖
npm install
# 构建产物
npm run build
# 安装pm2
npm i -g pm2
# 以上命令都只需要执行一次
pm2 start
# 查看启动日志
pm2 logs 0
# 后续重启使用
pm2 restart 0
# 更多pm2使用方法请参考 https://pm2.keymetrics.io/docs/usage/quick-start/

启动Fireboom

为保障安全,需要用生成模式启动Fireboom:

# cd‌ [project-name] 进入项目根目录
# 以生产模式启动服务
./fireboom start 

该方式将挂起命令行,可以用其他命令来作为守护进程。

systemctl守护

/usr/lib/systemd/system/ 目录中新建fb.service ,内容如下

‌[Unit]
Description=Fireboom server
After=syslog.target network.target

[Service]
Type=simple
# 根据实际路径来修改
WorkingDirectory=[project-name]
# 根据实际路径来修改
ExecStart=[project-name]/fireboom start
Restart=on-failure

[Install]
WantedBy=multi-user.target

然后执行

# 重新加载
systemctl daemon-reload
# 开机自启
systemctl enable fb
# 启动
systemctl start fb
# 查看日志
systemctl status fb

PM2守护

cd [project-name]
pm2 start ./fireboom start
cd custom-ts
pm2 start
# cd custom-go
# pm2 start ./main

最后更新于