云效创建项目应用以及流水线的说明文档

云效创建项目应用以及流水线主要有以下三个步骤：

1. 创建项目
2. 创建应用
3. 创建流水线

以下分别有截图与说明

一 创建项目

1. 准备本地code

在云效上面创建项目之前，你本地的项目代码准备好，起码有个基本的框架，或者脚手架。

2.进入项目组

进入云效，需要建流水线的项目组

3.创建项目

点击如上图项目组，进入该项目，并点击“创建项目”

4.关联项目

将本地代码，与项目进行关联，git命令如下

git init
git remote add origin git@code.aliyun.com:smart-service-fe/ccs-robot-h5.git
git add .
git commit -m "init"
git push -u origin master

配置本地 gitignore 文件

配置本地 gitignore 文件，注意本地build，css和js打包文件一样一个，这样后端引用比较方便

将以上修改push到master分支，注意你的权限。如果你的权限级别比较低，可能开始你就不能新建项目，或者提交代码到master分支。此时可以找管理员申请权限。

以上就完成了一个项目的新建，并且将本地代码与线上代码进行了关联。

二 创建应用

1.进入应用

点击云效工作台，进入你的项目。然后点击左侧的“应用”

2.创建应用

进入“应用”，点击创建新应用

3.填写基本信息

选择“自由模式”

4.设置代码库。

关联已有代码，将第一步里面创建的项目，git地址贴过来

5.应用模板

选择语言。我们公司技术框架选择node.js

6.构建配置

选择较新的语言版本，我们这里选择的是10.x，点击下一步

7.应用信息预览

核对一下你的应用信息，没有问题，点击“确定创建应用”

8.成功创建应用

跳转到以下页面

回到项目代码，此时你会发现多了一个release文件，如下图。

三 创建流水线

1.进入流水线

进入项目=>流水线

进入流水线，可以看到你刚刚创建的应用

2. 修改本地release文件

      回到你本地代码，看看创建应用成功后生成的release文件。

修改下图箭头处这段脚本，是运维提供的，一般直接从别的应用copy过来就可以了。

这段话的意思就是，build完，执行install，然后运行 dev.py这个python文件（此名称可以自定义，跟你创建的文件名称保持一致即可）。dev.py是你要在本地根目录新建的。

这里我将dev.py改了个名字，叫deploy.py，内容也是直接从别的应用copy（里面的内容是运维提供的，同一个项目部门应该是差不多的内容）。这段代码的作用就是，把code阿里云上面dist目录里面的内容copy到oss上面去。

改完以后，先放一放，下面高级参数配置，还需要在这里进行部分修改。

3. 配置流水线

      我们继续刚刚流水线的步骤。

设置管理员，修改流程如下图，你可以根据你的实际情况进行配置

如果需要版本，分支名称，项目名称等参数配置，如下图

注意这里配置的参数在本地deploy.py要相应的配置，添加如下代码到deploy.py

cdn = "https://cdn.yunlizhihui.com/$project_name/$branch_name/$version_number/$file_name"
oss_url = "https://yunli-fe.oss-cn-beijing.aliyuncs.com/$project_name/$branch_name/$version_number/$file_name"
cdn_template = Template(cdn)
oss_template = Template(oss_url)


project_name = os.environ['ENV_PROJECT_NAME']
branch_name = os.environ['ENV_BRANCH_NAME']
version_number=os.environ['ENV_VERSION_NUMBER']
current_dir = os.path.split(os.path.realpath(__file__))[0]


print("project name: ", project_name)
print("branch name: ", branch_name)
print("version_number: ", version_number)
print("current_dir: ", current_dir)

本地代码到此就修改完成了，可以提交到线上分支。

4.运行流水线

流水线点击完成，并“运行流水线”。这时候就可以正常发布了。

比如我现在建的是maser分支发布。

如果需要release分支发布预发，再重新根据以上流程再新建一个流水线就可以了。

以上就是所有流程了。完。