Hydro框架开发环境部署总结

一、 部署环境要求：

• 项目必须在Linux系统下运行，这里我是Windows系统上使用了虚拟机，也可以使用WSL2
• 安装Node.JS>=18版本
• 安装Yarn
• 安装Git

小提示：网络环境一定好，最好能够访问外网，不然安装依赖的时候包都是拉取github上面的，网络不好会导致安装依赖失败

二、 安装配置环境步骤

1. 安装Node18步骤

• 打开终端，输入以下命令来更新系统的包管理器：

sudo apt update

• 使用 curl 命令下载安装脚本，并通过 bash 执行该脚本来安装 Node.js v18

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

• 确认安装成功

node -v

安装Node18遇到的问题：本来按照上面步骤就可以安装Node18版本,但是无论选择版本是18，安装完成时查看是都是16版本
原因：因为包管理器里面Node安装包最高只有16所以安装18也会安装16
解决方法：更换软件包源，这里我选择使用阿里的镜像源，然后更新系统包管理器重新执行上面安装步骤就可以了

2. 安装Yarn步骤

• 导入Yarn的GPG密钥并添加存储库：

curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list

• 更新软件包列表并安装Yarn:

sudo apt update
sudo apt install yarn

• 确认安装成功

yarn --version

3.安装Git并验证是否安装

sudo apt install git
sudo apt install git

4.安装Mongodb（参考了菜鸟教程安装步骤和https://www.morfans.cn/archives/3344#/）

• 导入Yarn的GPG密钥并添加存储库：

wget -qO - https://www.mongodb.org/static/pgp/server-5.0.asc | sudo apt-key add -  #添加证书
echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/5.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-5.0.list #添加mongodb安装源

• 更新包管理器和安装Mongodb：

apt-get update
sudo apt-get install -y mongodb-org

• 我们在启动前可以先创建这两个目录并设置当前用户有读写权限：
  

sudo mkdir -p /var/lib/mongo
sudo mkdir -p /var/log/mongodb
sudo chown `whoami` /var/lib/mongo     # 设置权限
sudo chown `whoami` /var/log/mongodb   # 设置权限

• 接下来启动 Mongodb 服务并查看服务是否启动成功：

mongod --dbpath /var/lib/mongo --logpath /var/log/mongodb/mongod.log --fork
ps aux | grep mongod

安装前面的几个环境几乎问题不大，但是安装Mongodb的时候遇到了很多问题，就是安装启动数据库启动失败，我一直在这个问题上花了很多时间解决。如：etc/mongodb.conf配置文件路径不对、文件访问权限不足、删除数据库/var/lib/mongodb文件夹下.lock文件、卸载重新安装更换版本、甚至我换成WSL2都用上了也没解决。很莫名其妙感觉版本不兼容的问题，使用Ubuntu18的时候安装环境老是出现 version >=`GLIBC_2.28‘,后面怎么解决呢就是把Linux发行版Ubuntu18升级到Ubuntu20就能运行成功了。

三、GitHub拉取Hydro项目安装运行（官方文档https://hydro.js.org/dev）

1.安装 Hydro

git clone https://github.com/hydro-dev/Hydro.git /root/Hydro --recursive # 下载至 /root/Hydro 文件夹
cd /root/Hydro # 进入工作目录
yarn # 安装依赖包
yarn build:ui:production # 编译前端

yarn 安装依赖期间一定保持网络通畅，不然很容易失败

2. 启动Hydro

yarn debug --port=2333 --watch
yarn build:ui:dev

问题：在启动后又出现问题了，本地数据库一直连接不上项目，然后去项目里面寻找配置数据库文件./hydro/config.json找了一遍找不到该文件
原因：经过项目研究这个配置文件是运行的时候如果手动配置环境是不会启动创建脚本的，需要你通过使用 Gitpod 快速打开配置完成的开发环境但需要外网访问。
解决方法：因为我是手动配置所以就照着脚本中生成的路径下自己创建./hydro/config.json文件

3. 测试是否启动成功Hydro

浏览器运行：127.0.0.1：2333

四、总结

通过这次hydro环境配置我学到了Linux系统中版本环境的差异和兼容性，对于Linux系统的命令更加熟悉。了解到了WSL2这个工具是一个在Windows操作系统上运行的Linux兼容子系统，但是WSL 1 和WSL 2版本差异特别大，WSL 1 和 WSL 2 之间的主要区别在于，在托管 VM 内使用实际的 Linux 内核、支持完整的系统调用兼容性以及跨 Linux 和 Windows 操作系统的性能。也是因为这个版本问题，安装环境时候很多功能用不了启动不了数据库，让我最后选择使用VM虚拟机。