跳到主要内容
版本:4.7.1

源码部署 Zealot 指南

如下整理了不同操作系统的本地部署开发教程。

准备部署环境

macOS

安装 homebrew

首先需要安装 Xcode Command tools:

$ xcode-select --install

如果提示安装失败,需要从 https://developer.apple.com/downloads 下载安装。

之后安装 macOS 的包管理工具 Homebrew

$ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

安装依赖

之后开始安装环境依赖

$ brew install redis postgresql webp imagemagick node git

M1 用户需要设置依赖编译路径到 SHELL 的配置文件中:

export CPATH=/opt/homebrew/include/
export LIBRARY_PATH=$LIBRARY_PATH:/opt/homebrew/lib/

配置 Postgres 和 Redis

运行 postgresql 和 redis 服务

$ brew services start postgresql
$ brew services start redis

Postgresql 还需要创建默认用户名:

$ createuser --superuser zealot

# 如果担心权限过高可以只开启创建数据库权限
$ createuser --createdb zealot

yarn

$ npm install -g yarn

运行起来后使用浏览器访问 http://localhost:3000

疑难杂症

M1 芯片 MacOS 问题
aarch64-darwin/libwebp_ffi.bundle => aarch64-darwin/jpegdec.o

使用 bundle install 会遇到如上问题这个是因为 homebrew 安装 webp 依赖之后编译路径无法被找到,上面有解决办法。

Debian (Ubuntu)

安装环境依赖

$ apt update
$ apt install -y libssl-dev tar tzdata git imagemagick libjpeg-dev libpng-dev libtiff-dev libwebp-dev

安装依赖

$ apt install -y redis postgresql-client node

配置 Postgres 和 Redis

运行 postgresql 和 redis 服务

$ systemctl postgres start
$ systemctl redis start

Postgresql 还需要创建默认用户名:

$ initdb -D /var/lib/postgresql/data
$ createuser --superuser zealot

# If you are worried about the high privilege, you can only enable the create database privilege
$ createuser --createdb zealot

node

$ npm install -g yarn

Alpine Linux

安装环境依赖

$ apk --update --no-cache add build-base libxml2 libxslt git \
libxml2-dev libxslt-dev yaml-dev postgresql-dev nodejs npm yarn libwebp-dev libpng-dev tiff-dev \
tzdata

如果是在 arm 架构安装还需要额外安装 gcompat glib 兼容层,否则会报 "Error loading shared library" 异常错误。

安装依赖

$ apk --update --no-cache redis postgresql node

配置 Postgres 和 Redis

运行 postgresql 和 redis 服务

$ rc-service postgres start
$ rc-service redis start

Postgresql 还需要创建默认用户名:

$ initdb -D /var/lib/postgresql/data
$ createuser --superuser zealot

# 如果担心数据库用户权限,可仅开启创建数据库权限
$ createuser --createdb zealot

yarn

$ npm install -g yarn

安装 Ruby

可以通过 asdf、rvm 任意一种方式安装。

一个支持主流开发语言版本切换的工具,请按照官方安装教程好之后安装 ruby:

# 开启 Ruby 3.2.0 YJIT 新特性需要安装 Rust 1.58+
# 可选安装:
asdf plugin add rust
asdf install rust latest
asdf global rust latest
export RUBY_CONFIGURE_OPTS=--enable-yjit

# 必须安装
asdf plugin add ruby
asdf install ruby 3.2.0
asdf global ruby 3.2.0

克隆源代码

git clone https://github.com/tryzealot/zealot.git

初始化

以下步骤均需要在 zealot 根目录执行。

bundler

安装 Ruby gems 第三方类库

$ [sudo] gem install bundler
$ bundle install

yarn

安装前端第三方类库

$ yarn install

初始化数据库

确保连接数据库信息没有问题,后将会创建数据库表并创建表结构

$ rails db:create
$ rails db:migrate

配置数据库连接参数可通过环境变量或更改 config/database.yml 文件。

初始化预制数据

初始化管理员账号和应用样例

$ rails db:seed

运行 Zealot 服务

$ bin/dev

打开浏览器访问 http://localhost:3000