Browse Source

支持Docker部署

master
hole-thu 3 years ago
parent
commit
4c4ddca82b
  1. 6
      .dockerignore
  2. 19
      Dockerfile
  3. 94
      README.md
  4. 27
      docker-compose.yml
  5. 5
      psql-docker-init/add_pg_trgm.sh

6
.dockerignore

@ -0,0 +1,6 @@
/target
Cargo.lock
rust-toolchain
/user_files
*.db
.env

19
Dockerfile

@ -0,0 +1,19 @@
FROM rust:1-bullseye as builder
WORKDIR /usr/src/
RUN cargo new myapp --vcs none
WORKDIR /usr/src/myapp
COPY Cargo.toml ./
RUN cargo build --release
# 为了充分利用docker的缓存
COPY src ./src
COPY migrations ./migrations
RUN touch src/main.rs && cargo build --release
FROM debian:bullseye-slim
RUN apt-get update && apt-get install libpq5 -y
COPY --from=builder /usr/src/myapp/target/release/hole-thu /usr/local/bin/hole-thu
COPY Rocket.toml /usr/local/bin/
CMD ["hole-thu"]

94
README.md

@ -3,23 +3,72 @@
## 部署 ## 部署
### 使用docker
+ 安装docker-compose
+ 执行
```shell
mkdir hole
cd hole
# 下载docker-compose.yml
wget https://git.thu.monster/newthuhole/hole-backend-rust/raw/branch/master/docker-compose.yml
# 下载add_pg_trgm.sh
mkdir psql-docker-init
wget https://git.thu.monster/newthuhole/hole-backend-rust/raw/branch/master/psql-docker-init/add_pg_trgm.sh -O psql-docker-init/add_pg_trgm.sh
#下载镜像
docker-compose pull
# 初始化postgres
docker-compose up -d postgres
#建表
docker-compose run --rm hole-thu hole-thu --init-database
# 全部跑起来
docker-compose up -d
```
现在树洞后端应该已经运行在8000端口了
停止运行:
```shell
docker-compose stop
```
可能需要修改`docker-compose.yml`的情况:
+ 如果希望使用其他端口而非8000,编辑services.hole-thu.ports
+ 你可能需要映射postgres的5432端口用于在宿主机上连接以创建管理员账号,但也可以在`add_pg_trgm.sh`中添加创建管理员账号的sql语句或新增加一个`create_admin.sh`
+ 如果需要使用闭社登陆,请在services.hole-thu.environment中添加需要用到的更多环境变量(参考`.env.sample`)
### 使用源码编译
*以下内容假设你使用 Ubuntu 20.04* *以下内容假设你使用 Ubuntu 20.04*
目前只支持postgresql,对支持sqlite的追踪见 issue #1 安装rust与cargo环境 (略)
clone 代码 (略)
安装postgresql (略) 安装postgresql (略)
安装redis (略) 安装redis (略)
### 准备数据库 #### 准备数据库
进入: 进入:
``` ```shell
sudo -u postgres psql sudo -u postgres psql
``` ```
执行 (替换`'hole_pass'`为实际希望使用的密码): 执行 (替换`hole_pass`为实际希望使用的密码):
```postgresql ```postgresql
postgres=# CREATE USER hole WITH PASSWORD 'hole_pass'; postgres=# CREATE USER hole WITH PASSWORD 'hole_pass';
@ -32,39 +81,36 @@ hole_v2=# CREATE EXTENSION pg_trgm;
CREATE EXTENSION CREATE EXTENSION
hole_v2=# \q hole_v2=# \q
``` ```
### 运行 #### 编译&运行
创建 .env 文件,写入必要的环境变量。可参考 .env.sample。 创建 .env 文件,写入必要的环境变量。可参考 .env.sample。
#### 基于二进制文件 ```shell
从[release](https://git.thu.monster/newthuhole/hole-backend-rust/releases)直接下载二进制文件
```
./hole-thu --init-database
./hole-thu
```
#### 基于源码
安装rust与cargo环境 (略)
clone 代码 (略)
```
cargo run --release -- --init-database cargo run --release -- --init-database
cargo run --release cargo run --release
``` ```
或安装`diesel_cli`后 或安装`diesel_cli`后
``` ```shell
diesel migration run diesel migration run
cargo run --release cargo run --release
``` ```
### 关于账号系统 ### 基于二进制文件
安装与准备数据库同
从[release](https://git.thu.monster/newthuhole/hole-backend-rust/releases)直接下载二进制文件
```shell
./hole-thu --init-database
./hole-thu
```
## 关于账号系统
+ 如果你希望使用自己的登录系统,将 `/_login/` 路径交由另外的后端处理,只需最终将用户名和token写入users表,并跳转到 `/?token=<token>` + 如果你希望使用自己的登录系统,在Nginx或Apache中`/_login/` 路径交由另外的后端处理,只需最终将用户名和token写入users表,并跳转到 `/###token=<token>`
+ 如果你希望也使用闭社提供的授权来维护账号系统,使用 `https://thu.closed.social/api/v1/apps` 接口创建应用,并在.env或环境变量中填入client与secret。此操作不需要闭社账号。详情见[文档](https://docs.joinmastodon.org/client/token/#app)。编译运行时,增加`--features mastlogin`: `cargo run --release --features mastlogin` + 如果你希望也使用闭社提供的授权来维护账号系统,使用 `https://thu.closed.social/api/v1/apps` 接口创建应用,并在.env或环境变量中填入client与secret。此操作不需要闭社账号。详情见[文档](https://docs.joinmastodon.org/client/token/#app)。编译运行时,增加`--features mastlogin`: `cargo run --release --features mastlogin`

27
docker-compose.yml

@ -0,0 +1,27 @@
version: '1'
services:
postgres:
image: postgres:14.3
restart: unless-stopped
volumes:
- "./data/postgres:/var/lib/postgresql/data"
- "./psql-docker-init:/docker-entrypoint-initdb.d"
environment:
POSTGRES_PASSWORD: hole_pass
POSTGRES_USER: hole
POSTGRES_DB: hole_v2
redis:
image: redis:7.0.2
restart: unless-stopped
hole-thu:
image: holethu/hole-backend-rust:1.2.0
restart: unless-stopped
ports:
- "127.0.0.1:8000:8863"
environment:
DATABASE_URL: "postgres://hole:hole_pass@postgres/hole_v2"
REDIS_URL: "redis://redis:6379"
ROCKET_DATABASES: '{pg_v2={url="postgres://hole:hole_pass@postgres/hole_v2"}}'
ROCKET_ADDRESS: "0.0.0.0"
ROCKET_PORT: 8863

5
psql-docker-init/add_pg_trgm.sh

@ -0,0 +1,5 @@
#!/bin/bash
psql -v ON_ERROR_STOP=1 --username "$POSTGRES_USER" --dbname "$POSTGRES_DB" <<-EOSQL
create extension pg_trgm;
EOSQL
Loading…
Cancel
Save