在Meteor开发者群里发现很多人在问如何部署Meteor项目,我自己也在部署Meteor项目时遇到了很多问题,所以在这整理一下Meteor部署的方法,虽然主要是针对CentOS系统,但里面涉及的一些问题和解决方法也适合于其他平台。
文章分为两部分,一部分说明部署的流程,二部分是介绍一个工具,一键部署。
第一部分,Meteor项目部署的步骤和坑点
首先说一下Meteor项目部署的步骤流程和一些细节点,这部分内容适合在任何平台上部署的情况。
1,项目打包
meteor build ../production --architecture os.linux.x86_64
这里 --architecture 参数非常重要,这个是指定你部署服务器的运行环境,打包的过程会根据这个环境来编码和打包源代码。
../production 代表打包好的包文件在../production 这个目录里,这个地址你可以任意指定。
2,将发布包上传到服务器
cd ../production
scp my-project.tar.gz root@192.168.0.100:/opt/www/
上传到服务器可以用任何合适的方法,我为了演示简便就使用scp的方式。
3,解压发布包
ssh root@192.168.0.100
cd /opt/www/
tar zxvf my-project.tar.gz
注意:这部分内容是在服务器上操作的
找到这个发布包,解压发布包
4,配置安装项目所需要的插件包
cd bundle/programs/server
npm install
my-project.tar.gz文件会解压出一个bundle目录,而bundle/programs/server目录就是项目server代码所在的目录。
所以进入这个目录,运行npm install,npm会自动安装所需的插件、组件。
5,运行meteor
cd ../../
node main.js
或者
export ROOT_URL=http://www.xxx.com
node main.js
虽然服务器代码在 bundle/programs/server 目录里,但入口文件在 bundle 目录下,所以退出来到 bundle,然后运行node main.js 启动服务。
在启动之前可以通过 export ROOT_URL=http://www.xxx.com 方式设置一些环境变量来配置meteor项目的运行。
6,服务器环境搭建和配置
如果在第五步发现你无法运行或者报错了,有可能是你没有安装nodejs,也有可能是你的nodejs版本不对。
meteor 1.3.2 所需要的 nodejs 版本是0.10.43,过高的nodejs版本也会导致meteor项目部署运行报错。
在这说一下nodejs的版本号的问题,不要看0.10.43版本号好像很小,怀疑它不是稳定的版本,之所以nodejs现在最大的版本号会有6.2.0这种很大的编号,是因为之前nodejs的开发团队分裂过,现在有合并在一起了,所以导致版本号比较混乱。6.2.0如果以之前的版本号演进的话大概也就是0.16.0。
不管你是否安装过nodejs或者版本不对,都先安装nvm,鉴于nodejs这么混乱的版本号所以需要一个nvm这样的工具来管理不同的nodejs版本。
安装nvm
curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.31.1/install.sh | bash
安装和使用 nodejs 0.10.43
nvm install 0.10.43
nvm use 0.10.43
通过这一系列的操作,你基本部署完成你的项目了,但每次开发一个新版本就要这样部署一下有些麻烦,所以就有人写了一些部署meteor项目的工具。
第二部分,一键部署工具介绍和使用
其中官方推荐的是mup,mup是将meteor项目部署到服务器主机上。mup还有一个版本mupx,可以将meteor项目部署到docker容器上。
但mup和mupx都只支持ubuntu/debian架构的服务器,而且在国内的网络环境下运行非常慢,因为它们都没有针对国内的网络环境优化npm pacakge服务器。
所以我在mupx的基础将服务器代码移植到CentOS平台上,项目地址在这 mup for centos,如果需要在CentOS上部署,可以到这里去下载使用。github的项目首页有详细的使用说明。在这里我简单的讲一下如何使用mup for centos一键部署Meteor项目到服务器。
1,下载、安装mup for centos
cd /usr/local
git clone https://github.com/romejiang/mupx.git
ln -s mupx/bin/mup bin/mup
mup
进入/usr/local/目录,一般的第三方工具都安装在这。
git下载工具源码,ln连接mup命令
然后执行 mup 命令,如果有显示帮助信息就说明安装完成了。
2,建立项目部署目录
cd ~/projects/myproject
mkdir .deploy
cd .deploy
mup init
进入你的meteor项目所在的目录,建立一个隐藏目录 .deploy,并进入目录,在目录里初始化部署脚本。
3,编辑部署脚本 mup.json
{
"servers": [
{
"host": "jcw", // 部署服务器的地址 ip 或者 域名
"username": "root", // 服务器用户名
// "password": "password", // 服务器密码
"pem": "~/.ssh/id_rsa", // 可以用ssh验证,就不需要配置密码了
"env": {} // 服务器需要的环境变量
}
],
"appName": "zhiq", // 项目的名称,这个很重要,如果是多个项目部署到一个服务器上,这个名字不能重复,否则会覆盖其他项目
"app": "/Users/rome/Projects/meteor/zhiq", // meteor项目在你本地的目录地址
"env": {
"PORT": 8181, // 端口,多个项目部署到同一个服务器,也需要修改为不同的端口
"ROOT_URL": "http://app.yijianapp.com/test" // 项目真实的访问地址
},
"dockerImage": "romejiang/meteor:v53" // 使用的 Docker 镜像
}
部署脚本里有很多参数,但上面这几个是你会用到的,其他的参数可以不用动,默认值就好。
4,初始化服务器环境
mup setup
mup会根据需要对服务器的配置部署环境,会自动安装docker,mongodb,更新一些包。
5,部署项目
mup deploy
部署项目,项目会部署到服务器的/opt/目录下。
6,再次部署
mup deploy
一次每次更新了代码再次部署是只需要运行 , mup deploy 即可。
网友评论