1. 安装GitLab Runner:
首先,您需要在Ubuntu系统上安装GitLab Runner。您可以使用以下命令来安装:
sudo apt update
sudo apt install gitlab-runner
2. 注册GitLab Runner:
安装完成后,您需要注册Runner。使用以下命令开始注册过程:
sudo gitlab-runner register
按照提示输入您的GitLab实例的URL、注册令牌(可以在GitLab项目的“Settings” > “CI/CD”下找到)、Runner的描述以及您想要使用的Runner执行者(executor)类型(例如`shell`、`docker`等)。
3. 配置Runner:
注册完成后,您可能需要配置Runner以适应您的项目需求。这可能包括设置环境变量、缓存配置等。
4. 配置项目:
在GitLab中,您需要配置项目的`.gitlab-ci.yml`文件来定义CI流程。这个文件定义了项目的构建、测试和部署步骤。
5. 使用Docker Runner、shell(可选):
如果您打算使用Docker作为执行器,您可能需要在Runner配置中指定Docker镜像。在/etc/gitlab-runner/config.toml文件中添加或修改以下部分:
[[runners]]
name = "Docker Runner"
url = "https://gitlab.com"
token = "YOUR_RUNNER_TOKEN"
executor = "docker"
[runners.custom_build_dir]
[runners.docker]
tls_verify = false
image = "docker:latest" # 您可以指定特定的Docker镜像
privileged = true
disable_entrypoint_overwrite = false
oom_kill_disable = false
如果您打算使用shell作为执行器,在/etc/gitlab-runner/config.toml文件中找到 [[runners]]
部分,然后设置 executor
的值为 "shell":
[[runners]]
name = "My Shell Runner"
url = "https://gitlab.com"
token = "YOUR_RUNNER_TOKEN"
executor = "shell"
[runners.shell]
# 这里可以配置 shell 执行器的特定选项
6. 启动和启用GitLab Runner服务:
使用以下命令启动GitLab Runner服务,并设置为开机启动:
sudo gitlab-runner start
sudo gitlab-runner enable
7. 验证配置:
在GitLab项目中,您可以手动触发一个CI/CD流程来验证配置是否正确。
8. 监控Runner状态:
您可以使用以下命令来查看Runner的状态:
gitlab-runner status
9. 查看日志:
如果CI流程出现问题,您可以查看Runner的日志来诊断问题:
sudo gitlab-runner logs
请注意,这些步骤提供了一个基本的指南,具体的配置可能会根据您的具体需求和项目设置有所不同。如果您需要使用特定的服务或工具,您可能需要在`.gitlab-ci.yml`文件或Runner配置中进行相应的调整。