代码托管

代码托管为软件开发者提供基于GitLab的在线代码托管服务包括代码克隆/下载/提交/推送/比较/合并/分支/Code Review等功能。

菜单路径

产品与服务→软件开发→代码托管

操作步骤

1.登录浪潮云服务控制台。

2.点击“产品与服务”选择“软件开发”>“代码托管”。

3.点击“进入服务”,进入gitlab页面。

构建

构建管理描述了由源代码或程序包构建镜像所需的元数据,包括:源码库配置、语言和构建工具、触发器、软件包信息、构件信息、镜像信息等。用户可基于构建进行镜像的Build和研发PipeLine的定义。

基础构建操作

构建列表及操作

操作步骤

1.登录浪潮云服务控制台。

2.点击“产品与服务”选择“软件开发”>“构建”,进入构建管理列表页面。列表中的基本操作如表1

表1 基本操作

操作名称 操作 详解
查询 支持模糊查询。
  • 构建名称
  • 项目地址
  • 程序包名称
自定义列表 选择您想显示的列表详细信息,最多勾选10个数字。
刷新 刷新构建列表。
构建详情 点击“构建名称”列中的超级链接,即可进入“构建详情”页面。
执行 根据“构建类型”进行独立构建,填写镜像标签名称后,点击“确定”按钮,即可构建镜像并完成打标签的操作。
执行历史
查看构建历史。
构建log
查看构建日志,定时更新,支持手动刷新。
编辑
进入“构建编辑”页面。
删除
删除构建,此操作不可恢复,请慎重。

源代码构建镜像

菜单路径

“产品与服务”→“软件开发”→“构建”→“创建构建”

操作步骤

1.登录浪潮云服务控制台。

2.点击“产品与服务”选择“软件开发”>“构建”。

3.点击“创建构建”,选择“从源代码构建镜像”构建类型,填写构建基本信息。

1)基本信息

属性名称 属性说明
构建名称 1-50个字符,只能以字母开头,只可包含字母、数字、点、下划线及中横线。
构建类型 选择“从源代码构建镜像”

2)配置源码库信息

属性名称 属性说明
源码库类型 存放源代码库的类型。目前支持源码库的类型如下:
  • Gitlab
  • GitHub
是否认证 代码库是否需要登录验证,若需要,则打开认证,并在下方的用户名、密码处填写对应的代码库登录用户名、密码;若不需要验证,直接关闭即可。
用户名 “是否认证”选择“是”时,输入代码库的用户名 。
密码 “是否认证”选择“是”时,输入代码库的密码
Token 生成gitlab API token的操作步骤:
1).使用具有源码项目访问权限和创建webhook权限的用户登录gitlab
2).进入User Settings Access Tokens功能
3).输入token的name并在Scopes中选择 api Access the authenticated user's API选项
4).点击Create personal access token按钮创建 API token
5).复制生成的API token字符串。
项目地址 源代码所在项目的地址。
分支名称 需要打镜像的源代码所在的分支名称。

3)选择语言和构建工具

开发语言 构建工具
Java8、java7 支持Gradle、Maven
Go 支持Gradle、Make
Nodejs8 支持npm
C# 支持dotnet_core
python3 支持python3
Markdown 支持gitbook
dockerfile 支持dockerfile
C++ 支持cmake-gcc

4)选择触发方式

①git事件触发

属性 属性含义
Push Events 当源码库收到push请求时触发构建
Opened Merge Request Events 当源码库打开Merge请求时触发构建
Accepted Merge Request Events 当源码库通过Merge请求时触发构建
Closed Merge Request Events 当源码库关闭Merge请求时触发构建
Comments 当源码库提交代码请求时触发构建

②按周期定时检查

分为两种方式,可以按周期,如间隔多少分钟或者多少小时,或者每日、每周固定时间触发构建,如下图所示:

或者通过corn表达式自定义触发构建

③手动触发构建

4.生成构件

属性名称 属性说明
构件名称 构建源代码成功后生成的构件的名称,1-128个字符,只可包含字母、数字、点、下划线及中横线
生成路径 生成的构件的存放路径,使用相对路径,且路径名由字母、数字、点号、下划线、/组成,并以/结尾。

5.输出镜像

属性名称 属性说明
基础镜像 支持spring_boot、tomcat8两种基础镜像
输出镜像名称 构建的目标镜像的名称
暴露端口 访问端口(端口范围1~65535),如需输入多个暴露端口,在两个端口之间输入空格,类似8080 8081
启动参数 启动基础镜像需要的参数,比如数据库、用户名和密码,例如:--db=test --user=test --pwd=123

6.点击“提交”按钮,一个构建工程就创建完了。

7.返回构建列表页面,查看构建状态。

8.执行构建:

  a.点击 并填写输出镜像的tag为test;

  b.等待1-3分钟,点击日志按钮 确认构建完成 。 |

程序包构建镜像

菜单路径

“产品与服务”→“软件开发”→“构建”→“创建构建”

操作步骤

1.登录浪潮云服务控制台。

2.点击“产品与服务”选择“软件开发”>“构建”。

3.点击“创建构建”,选择“从程序包构建镜像”构建类型,填写构建基本信息。

属性名称 属性说明
构建名称 请输入正确的内容,只能以字母开头,仅包含字母、数字、点、下划线及中横线
构建类型 选择“从程序包构建镜像”

4.填写构建镜像所需软件包信息:

1)选择已有程序包

属性名称 属性说明
上传方式 选择已有软件包
软件包名称 选择已有软件包名称
软件包版本 选择软件包版本

2)选择新建软件包

属性名称 属性说明
上传方式 选择新建软件包
软件包名称 输入软件包名称,1-128字符,只能以字母开头,只可包含字母、数字、点、下划线及中横线
软件包版本 请输入正确的版本号(可以v或者V或者数字开头,字母、数字、点号、中短线、加号组成,例:v1.0,v1.0.0,1.0.0-alpha,1.0.0-alpha+001
文件 选择程序包文件
上传软件包 上传

5.输出镜像

属性名称 属性说明
基础镜像 选择构建镜像时所使用的基础镜像。 支持spring_boot、jdk7_tomcat7、jdk8_tomcat8三种基础镜像。
输出镜像名称 填写构建的目标镜像的名称。
暴露端口 填写暴露端口(端口范围1~65535),如需输入多个暴露端口,在两个端口之间输入空格,类似8080 8081。
启动参数 启动基础镜像需要的参数,比如数据库、用户名和密码,例如:--db=test --user=test --pwd=123

6.点击“提交”按钮,一个构建工程就创建完了。

7.点击“返回”按钮返回构建列表页面,查看构建状态。

8.执行构建:

  a.点击 并填写输出镜像的tag为test;

  b.等待1-3分钟,点击日志按钮 确认构建完成 。 |

源代码构建程序包生成构件

菜单路径

“产品与服务”→“软件开发”→“构建”→“创建构建”

操作步骤

1.登录浪潮云服务控制台。

2.点击“产品与服务”选择“软件开发”>“构建”。

3.点击“创建构建”,选择“从源代码构建程序包”构建类型,填写构建基本信息。

1)基本信息

属性名称 属性说明
构建名称 用于识别构建,请输入正确的内容,只能以字母开头,仅包含字母、数字、点、下划线及中横线。
构建类型 根据用户需求选择相应的构建类型,提供三类:从源代码构建镜像、从程序包构建镜像、从源代码构建程序包

2)源码库配置信息。

属性名称 属性说明
源码库类型 存放源代码库的类型。目前支持源码库的类型如下:
  • Gitlab
  • GitHub
是否认证 代码库是否需要登录验证,若需要,则打开认证,并在下方的用户名、密码处填写对应的代码库登录用户名、密码;若不需要验证,直接关闭即可。
用户名 “是否认证”选择“是”时,输入代码库的用户名 。
密码 “是否认证”选择“是”时,输入代码库的密码
Token 生成gitlab API token的操作步骤:
1).使用具有源码项目访问权限和创建webhook权限的用户登录gitlab
2).进入User Settings Access Tokens功能
3).输入token的name并在Scopes中选择 api Access the authenticated user's API选项
4).点击Create personal access token按钮创建 API token
5).复制生成的API token字符串。
项目地址 源代码所在项目的地址。
分支名称 需要打镜像的源代码所在的分支名称。

3)选择语言和构建工具

开发语言 构建工具
Java8、java7 支持Gradle、Maven
Go 支持Gradle、Make
Nodejs8 支持npm
C# 支持dotnet_core
python3 支持python3
C++ 支持cmake-gcc

4)选择触发构建的触发器

①git事件触发

属性 属性含义
Push Events 当源码库收到push请求时触发构建
Opened Merge Request Events 当源码库打开Merge请求时触发构建
Accepted Merge Request Events 当源码库通过merge请求时触发构建
Closed Merge Request Events 当源码库关闭merge请求时触发构建
Comments 当源码库提交代码请求时触发构建

②按周期定时检查

分为两种方式,可以按周期,如间隔多少分钟或者多少小时,或者每日、每周固定时间触发构建,如下图所示:

或者通过corn表达式自定义触发构建

③手动触发构建

4.点击“提交”按钮,一个构建工程就创建完了。

进阶构建操作

gradle构建

maven构建

制作Docker镜像

菜单路径

“产品与服务”→“软件开发”→“构建”→“创建构建”

操作步骤

1.登录浪潮云服务控制台。

2.点击“产品与服务”选择“软件开发”>“构建”。

3.点击“创建构建”,选择“从源代码构建镜像”构建类型,填写构建基本信息。

4.配置源码库信息,填写存放Dockerfile文件的项目地址

5.构建工具

属性名称 属性说明
工具类型 选择内置构建工具
开发语言 选择dockerfile
构建工具 dockerfile

6.选择触发方式

7.输出镜像

属性名称 属性说明
镜像方式 选择系统镜像
输出镜像名称 构建的目标镜像的名称
时区 选择默认UTC即可
启动参数 默认设置为空

8.点击“提交”按钮,一个制作Docker镜像构建工程就创建完了。

9.执行构建

使用自定义镜像

构建工具选择自定义镜像

1.新建构建,输入基本信息以及配置源码库

2.进入构建工具选择步骤,选择自定义构建工具(镜像)

属性名称 属性说明
工具类型 选择自定义构建工具(镜像)
选择镜像 下拉框选择由制作Docker镜像制作出的自定义镜像,支持模糊输入选择
构建脚本 输入构建脚本

3.选择触发方式

4.生成构件,自定义构建工具支持构件自主选择

单构件

多构件

属性名称 属性说明
是否多构件 用户根据项目选择单构件/多构件,比如java项目选择为单构件,nodejs8项目选择为多构件
构件名称 构建源代码成功后生成的构件的名称,1-128个字符,只可包含字母、数字、点、下划线及中横线
生成路径 生成的构件的存放路径,使用相对路径,且路径名由字母、数字、点号、下划线、/组成,并以/结尾。

5.镜像选择

镜像方式选择自定义镜像

从源代码构建镜像-镜像方式选择自定义镜像

1.新建构建,构建类型选择从源代码构建镜像

2.进入镜像选择步骤,镜像方式选择自定义镜像

属性名称 属性说明
镜像方式 选择自定义镜像
选择镜像 下拉框选择由制作Docker镜像制作出的自定义基础镜像,支持模糊输入选择
输出镜像名称 构建的目标镜像的名称
Dockerfile 输入Dockerfile内容不包含选择镜像指令:FROM + *
从程序包构建镜像-镜像方式选择自定义镜像

1.新建构建,构建类型选择从程序包构建镜像

2.进入镜像选择步骤,镜像方式选择自定义镜像

属性名称 属性说明
镜像方式 选择自定义镜像
选择镜像 下拉框选择由制作Docker镜像制作出的自定义基础镜像,支持模糊输入选择
输出镜像名称 构建的目标镜像的名称
Dockerfile 输入Dockerfile内容不包含选择镜像指令:FROM + *
两种方式异同点
相同点 不同点
镜像都是使用制作Docker镜像制作的镜像,Dockerfile输入皆不包含FROM指令 (1) 从源代码构建镜像,Dockerfile内容中ADD,COPY指令可以添加源代码项目任意内容(包括由构建脚本生成的构件)到镜像,即会自动在项目根目录下生成包含输入Dockerfile内容的Dockerfile文件,并在项目根目下执行docker build -t outputImageName .
(2)从程序包构建镜像,Dockerfile内容中ADD,COPY指令源参数需设置为temp,即上传的程序包都会位于temp文件夹下,系统会在temp同一级下生成一个包含输入Dockerfile内容的Dockerfile文件,并在Dockerfile文件所在目录下执行docker build -t outputImageName .

镜像方式选择Dockerfile

前置准备

代码仓库中需包含源代码以及Dockerfile文件

基本步骤

1.新建构建,填写基本信息,构建类型选择从源代码构建镜像

2.配置源码库信息

3.选择构建工具,触发方式以及构件配置

4.进入镜像选择步骤,镜像方式Dockerfile

属性名称 属性说明
镜像方式 选择Dockerfile
输出镜像名称 构建的目标镜像的名称
Dockerfile路径 输入Dockerfile文件在源代码项目中的相对路径
用户需知
属性名称 属性说明
基本知识 由Dockerfile制作镜像由两部分决定,一是Dockerfile文件的路径,二是build context即构建上下文;通常执行docker build -t outputImageName -f DockerfilePath buildContext,其中的DockerfilePath即指明Dockerfile文件的路径,而buildContext则指明构建上下文,如果buildContext为一点("."),表示构建上下文为docker build执行路径。Docker会把buildContext加到Docker引擎中,作为ADD,COPY指令的源目标选择。
本系统docker build执行方式 目前系统默认在项目根目录下执行docker build -t outputImageName -f DockerfilePath . ,即buildContext为项目根目录,把整个项目加载到Docker引擎中,无论用户的Dockerfile文件位于什么位置,使用ADD,COPY指令时都是相对于项目根目录