翻过那座山——Gitlab流水线任务疑难之编译有子模块的项目指南
- 欢迎点赞 ： 收藏 ⭐留言 如有错误敬请指正，赐人玫瑰，手留余香！
- 本文作者：由webmote 原创
- 作者格言：新的征程，我们面对的不是技术而是人心，人心不可测，海水不可量，唯有技术，才是深沉黑夜中的一座闪烁的灯塔 ！
序言
当格陵兰岛的雪山上还在漫天飞雪时，我已经安静的坐在空调房里，吹起了冰爽的风。为了满足组内的代码仓库实时编译的需求，我不得不部署了N个gitlab runner，来实现代码的编译工作。
当然编译代码是个很简单的事情，只需要我们了解我们的代码类型，然后选择适合他们的编译命令即可。
而难住我的不是这个，而是子模块的下载。
1. 拉取子模块
什么是git子模块？
子模块就是允许你将一个 Git 仓库作为另一个 Git 仓库的子目录。 它能让你将另一个仓库克隆到自己的项目中，同时还保持提交的独立。为了拉取子模块，我们需要在流水线里配置子模块相关的变量即可，主要是.gitmodules文件,具体内容可以参考第三节。
如下所示是ci的配置：
variables:
GIT_SUBMODULE_STRATEGY: normal
GIT_SUBMODULE_DEPTH: 1
这样的配置，就是在告诉Gitlab的runner，在拉取代码时，顺便拉取下子模块。
2. 自签名问题
碰到的第一个问题就是因为我采用了https方式部署的gitlab，而签名证书使用的是自签名证书，那反馈的问题也是自签名不识别。
Synchronizing submodule url for 'apiserver'
Cloning into 'E:/GitLab-Runner/builds/BXnNsKsZ/0/apiserver'...
fatal: unable to access 'https://192.168.1.185/apiserver.git/': SSL certificate problem: self signed certificate
要解决自签名，我们需要登录到runner运行的服务器，配置证书。
这里分两种情况：windows runner 和 docker runner
2.1 windows runner
1.在Git Bash 窗口，键入 git config –list
查看证书地址，找Http.sslcainfo
2.增加git证书到这个证书内
$ cat d:/WorkSpace/git.crt >> "d:/Program Files (x86)/Git/mingw64/ssl/certs/ca-bundle.crt"
注意： d:/WorkSpace/git.crt 是我的证书放的位置，你更换成你的地址即可。
2.2 docker下的runner
docker下运行runner，一般会映射一个配置目录，如下
docker run -d --name gitlab-runner2 --restart always -v /home/gitrunner/config2:/etc/gitlab-runner -v /var/run/docker.sock:/var/run/docker.sock runnerwithcert:latest
如果是这样，就可以修改config.toml文件了。
$ cat config.toml
# 以下是文件内容
concurrent = 1
check_interval = 0
shutdown_timeout = 0
[session_server]
session_timeout = 1800
[[runners]]
name = "runner"
url = "https://192.168.1.185/"
id = 3
token_obtained_at = 2023-03-16T06:48:52Z
token_expires_at = 0001-01-01T00:00:00Z
tls-ca-file = "/etc/gitlab-runner/git.crt"
executor = "docker"
[runners.cache]
MaxUploadedArchiveSize = 0
[runners.docker]
tls_verify = false
image = "maven:latest"
privileged = false
disable_entrypoint_overwrite = false
oom_kill_disable = false
disable_cache = false
volumes = ["/cache"]
shm_size = 0
这里，主要增加配置项 tls-ca-file 和 tls_verify = false。
3. 配置子模块为相对位置
经过这些操作后，依然会有错误，那么这里主要是认证错误，如下：
fatal: could not read Username for 'https://192.168.1.185': No such device or address
这里需要考虑子模块配置修改为相对路径。
修改。gitmodules 文件代码如下：
[submodule "src/views/abc"]
path = src/views/abc
# url = https://192.168.1.185/abc.git
url = ../abc.git
branch = main
依据仓库的位置，修改url为合适的相对路径。
如果出现类似这样的错误，大概率是路径设置错了。
fatal: unable to update url base from redirection:
asked for: https://gitlab-ci-token:[MASKED]@192.168.1.185/abc.git/info/refs?service=git-upload-pack
redirect: https://192.168.1.185/users/sign_in
4. 增加拉取子模块的权限
虽然我们配置了上述步骤，依然在ci运行后得到了错误，这个时候就是考研耐心的时候，我们还有重要的一步需要去做。
对照错误如下：
remote: The project you were looking for could not be found or you don't have permission to view it.
因为ci使用 gitlab-ci-token进行拉取仓库，因此必须给予权限才能拉取到子模块。
我们在gitlab内导航到配置页面（仓库页面的设置 > CI/CD）,
在输入框内填入项目名称，然后点击 增加项目，就可以给予权限了。
什么，添加不上去！！！
这个地址是有格式要求的，哎，就是项目顶端的导航，例如：
某项目是: A> B> C>d
那么我们就输入： A\B\C\d 就可以了。注意不要有空格，有空格也不认识。
再次运行ci，如果能看到如下内容，就配置成功了！
Updating/initializing submodules with git depth set to 1...
Synchronizing submodule url for 'abc'
Entering 'abc'
结语
反正自己走过的弯路，就不希望其他人再走了，技术分享就是这么纯粹！
都看到这了，还在乎点个赞吗？
都点赞了，还在乎一个收藏吗？
都收藏了，还在乎一个评论吗？