云效流水线+ECS服务器,自动化部署Web页面

上云课代表
  • 收获赞:68
  • 擅长领域:实战派常驻搬运工,为您搜寻有用好玩的阿里云产品实践

本文主要介绍如何通过使用ECS服务器与npm,结合云效的流水线服务以仓库代码提交为触发方式,进行了基于Vue的Web网页部署。

引言

本文主要结合自身项目构建经历,介绍如何通过使用ECS服务器与npm,结合云效DevOps的流水线服务,以仓库代码提交为触发方式进行基于Vue的Web网页部署,从而带来集成式开发部署的良好体验。

1、工件准备

本文中所使用到的工件有:

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上新建代码仓库一样轻松构建我们的代码仓库:

  • 导入代码库:支持多种导入方式,包括GiteeGithub

完成项目代码的构建后,即可在项目内部配置部署流水线功能。

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,编写如下内容:

#!bin/bash
# 这里我们采用了绝对路径调用的方式,防止系统无法识别到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端口,这样即可在我们的主机上访问我们部署好的页面了。

效果如下:

本文转载自飞天加速计划,作者为北京邮电大学软件工程专业的一名大三学生。https://developer.aliyun.com/article/883507