引言
本文主要结合自身项目构建经历,介绍如何通过使用ECS服务器与npm,结合云效DevOps的流水线服务,以仓库代码提交为触发方式进行基于Vue的Web网页部署。从而带来集成式开发部署的良好体验。如有不足之处,欢迎各位开发者指正。
0、前言
本文为参与飞天加速计划·高校学生在家实践的活动文章。本人为北京邮电大学软件工程专业的一名大三学生,通过本学期崔毅东老师的“云计算技术”课程了解到本活动。希望通过使用ECS云服务器来完成对云计算相关课程内容的学习,并希望结合阿里云云效服务,来更好地指导本学习实践课程的相关开发。
1、工件准备
本文中所使用到的工件有:
- 阿里云云效
- 阿里云ECS服务器
- Node.js
- 一个基于Vue的Web项目
2、配置步骤
2.1 准备工作
首先我们来介绍一下云效。云效是一个一站式DevOps平台,能够为开发者从需求分析、项目协作与文档管理、产品开发与跟踪、项目测试与交付的一整套完整开发环境。云效平台所提供的功能如下图所示,健全的功能体系属实为项目开发提供了更好的便捷性与更高的效率。
回到正题。首先需要注册一个阿里云的ECS服务器,并在云效上免费申请注册企业。这里不再进行赘述。
为了便于我们的主机部署,我们还需要在ECS服务器中安装Node.js:
(1)首先登录Node.js官网下载安装包:http://nodejs.cn/download/
(2)之后将安装包上传至服务器,解压缩后配置环境变量,具体内容可以参考这里
(3)为了便于我们部署页面,还需要安装serve插件:
npm install -g serve
2.2 配置云效代码管理仓库
为便于我们采用云效流水线工具进行自动化部署,在申请开通云效服务后,我们首先来到工作台,点击右上角的【代码管理】进入到我们企业的代码仓库添加我们的项目代码:
【代码管理】功能其实就相当于一个Git仓库。进入Codeup代码管理界面后,可以点击右上角的【添加库】,新建或导入我们的项目代码:
- 新建代码:可以像在Gitee或Github上新建代码仓库一样轻松构建我们的代码仓库:
- 导入代码库:支持多种导入方式,包括Gitee和Github:
完成项目代码的构建后,即可在项目内部配置部署流水线功能。
2.3 流水线的配置
来到相应的项目中,点击页面左侧的【流水线】,然后在页面中选择【新建流水线】:
在新建流水线界面,我们可以看到云效根据不同的开发环境,提供了多种流水线模板,这里大家可以根据自身需求,选择合适的模板:
在选定模板后,我们即可点击流水线上的项目,进行我们的流水线配置了。
2.3.1 添加流水线源
流水线源即为我们需要执行流水线源的项目代码。
点击【添加流水线源】后,我们便可以在页面右侧选择我们需要进行配置的相应代码仓库。
在这里,我们选择了已经在【Codeup(代码管理)】中部署好的项目。
2.3.2 配置主机部署
为了将构建好的项目制品部署在主机上,我们需要在流水线上点击【主机部署】,然后在右侧界面选择需要部署到的主机上:
如果是第一次部署,可以选择【新建主机组】,根据列表中情况选择相应的主机:
这里以阿里云ECS为例,我们可以在本页面添加服务连接,然后根据自己的ECS服务器所处地域对主机进行添加(如忘记ECS服务器的所在地域,可以在【控制台】-【云服务器ECS】中查看相应实例的地址):
2.3.3 配置代码提交自动运行流水线
流水线支持webhook方式触发流水线的运行。我们可以在流水线的编辑页面,选择上方的【触发设置】,复制触发器信息:
然后来到【代码管理】所需配置的项目界面,选择左下角的【设置】,然后选择【Webhooks】-【新建Webhook】,刚才复制的触发器链接填写至此,然后在触发器上勾选触发事件。这里我们选择【推送事件】。
经过上述的配置后,在每次通过Git推送Commit后,流水线便可自动运行。
2.3.4 配置流水线命令
为了便于我们自动化部署Web应用,我们还需要对流水线上的某些环节配置额外的命令:
(1)Node.js构建
由于我们需要通过npm的serve命令,将项目文件打包生成dist目录以便用于web页面启动,因此需要选中【Node.js构建】,在Node.js构建中添加如下命令:
npm install
npm run serve
注意:有时我们的项目使用到的插件无法从淘宝npm的镜像上下载到,从而可能导致构建出错的问题;建议将默认命令中的cnpm
替换为npm
。若项目中有使用到我们自定义的npm插件,配置方法可参考这里。
(2)主机构建
由于构建完成后,流水线会将我们的代码制品打包放置在指定的位置,这里我们可以根据自身需要更改部署配置的下载路径:
由于在本次项目中,我们需要使用制品文件中的dist目录进行Web页面部署,因此这里我们编写脚本,将生成的制品文件解压到需要的目录下:
tar -zxvf /home/admin/app/package.tgz /home/admin/app/
(3)额外命令
在解压完毕后,我们还需要在主机上使用serve命令启动我们的Web页面,这里我们建议在ECS服务器上新建一个简单的脚本,专门用于调用serve服务。(运行流水线的服务器并不是我们的ECS主机,直接在流水线上调用,可能会引起无法找到命令导致运行失败。运行失败可以删除该流水线任务,直接在ECS主机上使用该脚本即可)
以本项目为例,我们登录ECS服务器,在/opt目录下新建脚本文件flow.sh
,编写如下内容:
# 这里我们采用了绝对路径调用的方式,防止系统无法识别到serve命令# 如果不清楚serve所在的目录,可以通过which serve命令进行查看/etc/opt/node/bin/serve /home/admin/app/dist
之后使用chmod 777 /opt/flow.sh
将脚本转化为可执行文件。
然后来到流水线,在界面右侧选择新的任务,这里我们选择【执行命令】:
然后更改任务名称为【执行serve dist】(自定义名称即可),然后在执行命令中执行我们的脚本即可:
3、服务器安全组配置
我们可以看到,通过serve
命令部署的Web页面端口默认为3000,由于ECS服务器的安全组规则受限,我们无法通过外网直接访问,还需要开放该端口。
我们这里可以来到阿里云控制台,选择我们相应的ECS服务器,在侧边栏中选择【网络与安全】-【安全组】,在选择相关的实例后,在【入方向】中点击【手动添加】放行3000端口,这样即可在我们的主机上访问我们部署好的页面了。
效果如下:
4、使用收获
- 了解了ECS服务器在镜像、网络安全、存储等方面的功能以及基本的配置方法;
- 学会了通过远程连接ECS服务器,在ssh和sftp环境下执行基本的命令;
- 熟悉了如何使用ECS服务器,结合云效以及流水线工具进行自动化部署。