【分享】ONCE —— 统一管理 VPS 自部署服务

https://once.com/

如上所述，作者是 37signal 公司，就是前两个月大火的Omarchy那家

基本使用

下面我用虚拟机来演示一下

为了演示方便，把防火墙关掉

直接执行

curl -fsSL get.once.com | sh

如果是普通用户执行，会提醒你输 sudo 密码；没有安装 Docker，它会给你自动安装

这边自带三个应用

1. Campfire: 邀请制聊天室，适合公司 / 组织内部沟通
2. Writebook: 写文档，在线成书
3. Fizzy: 日程看板，需要配置 smtp 服务器

这里选择 Campfire，回车

提示输入一个域名，ONCE 会在健康检查期间用这个域名检查，并上 HTTPS 证书；由于我是用的虚拟机，没有上公网，所以填一个 .localhost 结尾的域名来跳过检查与 TLS，这里我用 campfire.localhost

部署完成，在这里可以直接看到内存、CPU 占用与流量

为了在主机上访问 Campfire，修改 C:\Windows\System32\drivers\etc\hosts

# 我的虚拟机 IP
192.168.182.141 campfire.localhost
192.168.182.141 flarum.localhost # 接下来要用

然后就可以用这个域名来使用部署好的服务了

部署自定义服务

ONCE 对自定义服务的要求是：

• 用一个 Docker 容器把所有服务本体及其依赖（如数据库）全部打包（all in one）
• 在 80 端口暴露纯 HTTP 服务
• 所有持久化数据（数据库、日志、附件、配置……）放容器内的 /storage
• 对 GET /up 返回 200，如果做成实际的健康检查更好
• 如果应用支持相应配置，要透传以下环境变量：
  • SECRET_KEY_BASE（Rails 生态的密钥）
  • DISABLE_SSL
  • BASE_URL
  • VAPID_PUBLIC_KEY/VAPID_PRIVATE_KEY （需要 webpush 的应用）
  • SMTP_ADDRESS/SMTP_PORT/SMTP_USERNAME/SMTP_PASSWORD/MAILER_FROM_ADDRESS（需要邮件功能的应用）
  • NUM_CPUS
  • 也可以引入额外的环境变量，并在 ONCE 中手动添加

上述要求是对Ruby on Rails框架定制的，如果你用 rails new新建一个 Rails 项目，就已经自动符合以上要求；但是大量应用不是用 Rails 编写的，怎么办呢？请大肥鱼帮你改

https://github.com/crazy-max/docker-flarum
https://github.com/shinsenter/php/tree/main/src/webapps/flarum
https://docs.flarum.org/install/

研究上述链接，为Flarum 2.0写一个Dockerfile，要求兼容ONCE部署工具（https://github.com/basecamp/once）：
 - 单Docker容器提供本体+数据库的所有服务
 - 在80端口暴露http服务，不要求https
 - 对GET /up响应200，尽量做成健康检查端点，如果没有检查机制也要固定返回200
 - 持久化数据（db）放在容器中的/storage下，ONCE会固定挂载它做volume
 - 能从以下环境变量中自动为Flarum配置相关项：SECRET_KEY_BASE（Rails/Laravel生态的密钥种子）、BASE_URL、SMTP_ADDRESS、SMTP_PORT、SMTP_USERNAME、SMTP_PASSWORD、MAILER_FROM_ADDRESS
 - 完整要求请看https://github.com/basecamp/once#making-a-once-compatible-application，以及仓库源码
 
完成后，把镜像推送到dockerhub

我的成品在 ratherbeafish/flarum-allinone:latest

重新回到 ONCE（直接在终端中输入 once 命令），按 <kbd>n</kbd>

选择 custom

就这样~