gitlab_docker安装
# 一、安装Gitlab
# 1、拉取镜像并启动
由于服务器的80
端口可能被占用,所以这里我们改成了其他端口来启动
docker run -d -p 2443:443 -p 8090:80 -p 2222:22 --name gitlab --restart always \
-v/opt/gitlab/config:/etc/gitlab \
-v /opt/gitlab/logs:/var/log/gitlab \
-v /opt/gitlab/data:/var/opt/gitlab \
beginor/gitlab-ce
2
3
4
5
# 2、修改配置文件
提示:等待docker运行gitlab一小段时间后在操作,否则可能出现文件找不到
# 修改gitlab.yml文件
vim /opt/gitlab/data/gitlab-rails/etc/gitlab.yml
找到如下配置,修改host为你服务的IP或者域名(不能加http://
),修改完毕后保存退出
gitlab:
# 这里要将host设置为你gitlab所在的服务器IP或者域名
host: 1.15.141.114
port: 8090
https: false
2
3
4
5
# 修改gitlab.rb文件
vim /opt/gitlab/config/gitlab.rb
找到external_url
,默认是被注释的,要打开,并填写暴露出去的http://ip:port
,IP
一定要和gitlab.yml
文件配置的相同,port
为你启动时指定的,我们这里使用8090
作为端口;最后加上ssh协议下使用的IP和端口(这里的端口是你启动时指定的,我们这里是2222
),最后保存并退出
external_url 'http://1.15.141.114:8090'
gitlab_rails['gitlab_ssh_host'] = '127.0.0.1'
gitlab_rails['gitlab_shell_ssh_port'] = '2222'
2
3
# 停止并移除之前启动的gitlab
# 停止并移除之前启动的GitLab容器
docker rm -f gitlab
2
# 重新启动gitlab
这里要将容器端口改为8090
docker run -d -p 2443:443 -p 8090:8090 -p 2222:22 --name gitlab --restart always \
-v/opt/gitlab/config:/etc/gitlab \
-v /opt/gitlab/logs:/var/log/gitlab \
-v /opt/gitlab/data:/var/opt/gitlab \
beginor/gitlab-ce
2
3
4
5
等待一段时间,就可以访问了,首次需要更改root
账户的密码
# 二、安装Gitlab-Runner
可以在项目中或者项目组中以及全局配置中找到Runner
配置的地方,全局配置仅限GitLab的管理员账号才有权限
项目中
项目中配置的Runner只对当前项目有效 这时候我们展开,就能看到这个设置Runner的区域
项目组中
只对这个项目组内的所有项目生效 这个和在项目中一样,都需要展开,往下拉就能看到手动设置Runner的区域
全局配置
所有项目都可以一起使用 全局配置在右边就能直接看到手动设置Runner的区域
# 1、拉取Runner镜像并启动
docker run -d --name gitlab-runner --restart always -v /srv/gitlab-runner/config:/etc/gitlab-runner -v /var/run/docker.sock:/var/run/docker.sock gitlab/gitlab-runner:latest -- 自己的 docker run -d --name gitlab-runner --restart always -v /opt/software/gitlab-runner/config:/etc/gitlab-runner -v /var/run/docker.sock:/var/run/docker.sock gitlab/gitlab-runner:latest
1
2
3# 2、进入Runner容器内
docker exec -it gitlab-runner bash
1# 3、运行以下命令
gitlab-runner register
1# 输入Gitlab实例的地址
地址是你手动设置Runner区域里面的URL
> Please enter the gitlab-ci coordinator URL (e.g. https://gitlab.com ) http://xxx
1
2# 输入token
token是你手动设置Runner区域里面的令牌
> Please enter the gitlab-ci token for this runner xxx
1
2# 输入Runner的描述
> Please enter the gitlab-ci description for this runner [hostname] my-runner
1
2# 输入与Runner关联的标签
标签是为了让后期在CI脚本中指定选择某个或者多个Runner,这里我们设置他的标签为
test
,你们可以设置其他的> Please enter the gitlab-ci tags for this runner (comma separated): test
1
2# 输入Runner的执行器
由于我们都是基于Docker,所以这里选择执行器为Docker
> Please enter the executor: ssh, docker+machine, docker-ssh+machine, kubernetes, docker, parallels, virtualbox, docker-ssh, shell: docker
1
2# 设置执行器的版本(设置docker 为了ci方便执行docker命令)
> Please enter the Docker image (eg. ruby:2.1): docker
1
2# 退出容器
exit
1通过以上命令后,就创建成功runner啦,这时候我们去GitLab中我们创建Runner的区域刷新就能看到了
# 4、修改Runner配置文件
vim /opt/software/gitlab-runner/config/config.toml
1找到
volumes
配置,修改结果为如下,分别是挂载了宿主机docker的sock文件和Maven的缓存,减少拉取Jar包的时间消耗,其中"/data/.m2/:/.m2/"
这块为Maven的Jar包存放地址,左边为宿主机目录,右边为容器内的Jar包存储路径,这个需要根据自己使用的Maven镜像而定提示:如何构建Maven镜像请翻到文章末尾
volumes = ["/cache","/var/run/docker.sock:/var/run/docker.sock","/data/.m2/:/.m2/"]
1在
volumes
配置下方增加一行配置,防止Runner重复拉取镜像pull_policy = "if-not-present"
1最后重启Runner
docker restart gitlab-runner
1# 三、创建SpringBoot项目测试CICD
这里就不演示如何创建项目了,不会SpringBoot的自行去学习,这里只展示
.gitlab-ci.yml
文件# 1、在项目根目录创建个
Dockerfile
FROM openjdk:8-jdk COPY target/*.jar ci-demo.jar EXPOSE 7777 ENTRYPOINT ["java","-jar","ci-demo.jar"]
1
2
3
4# 2、项目根目录创建
.gitlab-ci.yml
文件下面脚本中出现了
172.20.9.3:5001/root/maven:latest
镜像,这块是我们手动构建的Maven镜像,如何构建请前往文章第四部分拓展知识查看# 全局脚本,会运行在各个阶段的script前,如果某个阶段里面存在before_script,那么以那个阶段里的为主 before_script: # 这里定义了打包成功后的Docker镜像名称,每一次提交代码后构建成功的镜像名称都是唯一的 - export IMAGE_FULL_NAME=${CI_REGISTRY_IMAGE}:${CI_COMMIT_REF_SLUG}-${CI_COMMIT_SHA} # 定义CI执行的阶段,这里可以自己根据情况定义多少个阶段 stages: - compile - build - run # 定义全局变量 variables: PROJECT: "ci-demo" # 这里定义了Maven的jar包存放地址,与我们构建maven私服的时候设置的存放地址一致 MAVEN_REPO: "/.m2" 编译: # 当前阶段的执行镜像,这是我们自己构建的镜像 image: 172.20.9.3:5001/root/maven:latest # 属于上面定义的哪一个阶段 stage: compile # 是否允许失败,允许的话如果当前阶段运行失败还会继续执行下一个阶段 allow_failure: false # 只在哪个分支生效 only: - master # 这里就是你要选择哪个runner来执行了,填写我们创建runner时候指定的标签 tags: - test # 运行脚本 script: - mvn -Dmaven.repo.local=$MAVEN_REPO clean package -Dmaven.test.skip=true # 因为是Maven编译,所以会有Jar包产物,这里定义产物的过期时间 artifacts: name: $PROJECT expire_in: 7 days paths: - target/*.jar 构建镜像: image: docker:stable stage: build script: # 这里的变量会自动获取你当前推送代码的gitlab用户和密码以及仓库地址 - docker login --username $CI_REGISTRY_USER --password $CI_REGISTRY_PASSWORD $CI_REGISTRY # 这里的变量就是我们全局配置定义的了 - docker build -t $IMAGE_FULL_NAME . - docker push $IMAGE_FULL_NAME - rm -rf target - docker rmi $IMAGE_FULL_NAME only: - master tags: - test 运行: image: docker:stable stage: run script: - docker run -d --name $PROJECT -p 7777:7777 $IMAGE_FULL_NAME only: - master tags: - test
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61# 3、将项目提交到Gitlab仓库即可
编写好脚本后,提交代码到master分支,因为我们在CI脚本里只指定了master分支生效,
第一次CI执行的时候会比较慢
,因为需要拉取基础镜像和jar包 CI脚本执行完毕后,我们可以去runner所在服务器进行查看容器是否启动成功,由于我们项目设置了一个接口,所以我们直接尝试访问接口地址看看是不是正常返回,如果返回了就是执行成功了,没有正常返回的话,就需要自己通过docker logs -f <容器名>
查看日志了
建议:
最好使用内网环境的基础镜像
,否则可能导致CI执行时间过长,比如CI脚本中运行阶段的基础镜像docker:stable
还有Dockerfile文件里的基础镜像JDK
。拉取时间的长短受服务器性能和网络影响。
该项目Demo可以前往GitHub查看 (opens new window)
# 四、拓展知识
# 1、开启GitLab中Docker镜像仓库
首先我们先找台服务器启动一个Docker registry镜像仓库
docker run -d -v /data/registry:/var/lib/registry -e REGISTRY_STORAGE_DELETE_ENABLED=true -p 5001:5000 --restart=always --name registry registry:2
过了一会后通过浏览器访问http://<服务器IP>:5051/v2/_catalog
,会返回一个空的JSON,这是因为我们还没推送镜像上去。
在Gitlab中开启Docker镜像仓库,可以直接通过Gitlab中的用户项目权限进行镜像权限控制,非常方便快捷。registry_external_url
和gitlab_rails['registry_api_url']
替换为你的镜像仓库地址,registry_host
、registry_host
修改为对应的地址和IP
registry_external_url 'http://172.20.9.3:5001'
gitlab_rails['registry_enabled'] = true
gitlab_rails['registry_host'] = "172.20.9.3"
gitlab_rails['registry_port'] = "5001"
gitlab_rails['registry_path'] = "/src/gitlab/data/gitlab-rails/shared/registry"
gitlab_rails['registry_api_url'] = "http://172.20.9.3:5001"
2
3
4
5
6
配置完刷新配置
docker exec -it gitlab gitlab-ctl reconfigure
这时候我们随便找到一个项目,点进去查看一下容器库
右边的就是如何通过docker提交镜像到该项目了
提示:由于我们这边没有配置HTTPS,所以需要给Docker增加如下配置,需要登陆镜像仓库的机子都需要给配上,我们这里是通过runner去打包和启动项目,那么就需要在runner所在服务器的docker进行配置了
# 打开文件
vim /etc/docker/daemon.json
# 将下面的配置追加到已有的配置中
"insecure-registries":["xxx:5000"]
2
3
4
最终的效果如下第一行
配置好后重启Docker
systemctl restart docker
# 2、构建自己的Maven镜像
以下两个文件要放到同一个目录里面
Dockerfile
FROM maven:3.6.0-jdk-8-alpine COPY settings.xml /usr/share/maven/ref/
1
2Maven配置文件(settings.xml)
<?xml version="1.0" encoding="UTF-8"?> <settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"> <!--改为你的Jar包存放目录--> <localRepository>/.m2</localRepository> <mirrors> <mirror> <id>mynexus</id> <name>company nexus</name> <url>更改为你的Maven仓库地址,可以是阿里的私服,也可以是公司内部的私服</url> <mirrorOf>central</mirrorOf> </mirror> </mirrors> <profiles> <profile> <id>jdk18</id> <activation> <jdk>1.8</jdk> <activeByDefault>true</activeByDefault> </activation> <properties> <maven.compiler.source>1.8</maven.compiler.source> <maven.compiler.target>1.8</maven.compiler.target> <maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion> </properties> </profile> </profiles> </settings>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29两个文件创建好之后,通过控制台进入到该目录,尝试构建镜像并上传,本文直接采用GitLab开启Docker镜像仓库,因此这里,我们先去Gitlab创建一个叫Maven的项目,然后查看他的容器库
依次执行框框里的命令,这里需要配置docker镜像仓库地址到你要执行这个命令的机子哦,如果你是在本地,那么就是给本地电脑的docker加上配置了
docker login 172.20.9.3:5001
docker build -t 172.20.9.3:5001/root/maven .
docker push 172.20.9.3:5001/root/maven
2
3
4
5
执行完毕后我们回到Gitlab查看一下,这时候就有我们推送的镜像了
https://segmentfault.com/a/1190000020593208