Automatisch项目非Docker环境部署指南

前言

Automatisch是一款开源的工作流自动化工具，虽然官方推荐使用Docker进行部署，但许多开发者出于安全考虑或环境限制，更倾向于传统部署方式。本文将详细介绍如何在非Docker环境中部署Automatisch项目。

环境准备

数据库选择

Automatisch依赖PostgreSQL数据库，推荐使用14.5版本，这是经过验证最稳定的兼容版本。安装时需要注意：

1. 确保PostgreSQL服务正常运行
2. 创建专用数据库用户和数据库
3. 记录好数据库连接信息（主机、端口、用户名、密码、数据库名）

Redis缓存服务

项目还需要Redis作为缓存服务，建议安装最新稳定版Redis并确保服务正常运行。

Node.js环境

Automatisch基于Node.js开发，需要安装Node.js环境（建议LTS版本）和Yarn包管理器。

项目部署步骤

1. 获取项目代码

通过Git克隆项目仓库到本地工作目录。

2. 安装依赖

进入项目目录后执行：

yarn install

这将安装所有必要的Node.js依赖包。

3. 环境变量配置

复制.env-example文件为.env，并根据实际环境进行配置。关键配置项包括：

• 数据库连接参数
• Redis连接参数
• 应用密钥和加密设置
• 邮件服务配置（如需要邮件通知）
• 其他业务相关参数

4. 数据库初始化

根据项目文档执行数据库迁移命令，创建必要的表结构和初始数据。

5. 启动应用

使用Yarn启动开发服务器或生产环境服务：

yarn dev   # 开发模式
yarn start # 生产模式

常见问题解决

1. 数据库连接问题：检查PostgreSQL服务是否运行，连接字符串是否正确，用户权限是否足够
2. Redis连接问题：确认Redis服务状态和连接配置
3. 依赖安装失败：尝试清除缓存后重新安装，或检查Node.js版本兼容性
4. 环境变量未生效：确保.env文件位于项目根目录，且变量名拼写正确

生产环境建议

对于生产环境部署，建议：

1. 使用PM2等进程管理器保持应用稳定运行
2. 配置Nginx反向代理和HTTPS加密
3. 设置定期数据库备份
4. 监控服务运行状态和资源使用情况

安全注意事项

1. 妥善保管数据库凭证和应用密钥
2. 限制数据库和Redis服务的访问IP
3. 定期更新依赖包以修复已知问题
4. 避免在配置文件中存储明文密码

通过以上步骤，开发者可以在非Docker环境中成功部署Automatisch项目，享受其强大的工作流自动化功能。相比Docker部署，这种方式虽然步骤稍多，但提供了更高的可控性和透明度，适合对安全性要求较高的环境。