返回

Gitlab 自动部署指南之二:亲手安装 GITLAB-RUNNER

前端

作为程序员,我们经常会遇到需要自动部署的情况,而 Gitlab 作为一款备受欢迎的代码托管平台,其内置的 CI/CD 功能可以轻松实现代码的自动构建、测试和部署。然而,在使用 Gitlab 自动部署之前,我们需要先安装 GITLAB-RUNNER。GITLAB-RUNNER 是一个用于执行 CI/CD 作业的开源软件,它可以运行在各种平台上,包括 Linux、Windows 和 macOS。在本文中,我们将详细介绍如何在 Ubuntu 20.04 系统上安装 GITLAB-RUNNER。

前提条件

在安装 GITLAB-RUNNER 之前,我们需要确保系统已经满足以下条件:

  • Ubuntu 20.04 系统
  • Git 已安装
  • Docker 已安装
  • Docker Compose 已安装
  • Python 3 已安装

安装过程

1. 创建用户

首先,我们需要创建一个专门用于运行 GITLAB-RUNNER 的用户。这有助于提高安全性,并便于管理。

sudo adduser --system --group --no-create-home gitlab-runner

2. 安装 GITLAB-RUNNER

接下来,我们需要安装 GITLAB-RUNNER。

curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh | sudo bash
sudo apt-get install gitlab-runner

3. 配置 GITLAB-RUNNER

安装完成后,我们需要配置 GITLAB-RUNNER。

sudo nano /etc/gitlab-runner/config.toml

在配置文件中,我们需要添加以下内容:

concurrent = 1
check_interval = 0

[session_server]
  session_timeout = 1800

[[runners]]
  name = "my-runner"
  url = "https://gitlab.com/"
  token = "YOUR_TOKEN"
  executor = "docker"

  [runners.docker]
    tls_verify = false
    image = "gitlab/gitlab-runner:latest"
    volumes = ["/cache"]

其中,YOUR_TOKEN 是你的 Gitlab 个人访问令牌,可以通过访问 Gitlab 个人资料页面获取。

4. 注册 GITLAB-RUNNER

配置完成后,我们需要注册 GITLAB-RUNNER。

sudo gitlab-runner register

在注册过程中,你需要提供以下信息:

  • Runner description:一个性名称,例如 "My Runner"
  • Runner tags:可以留空,也可以添加一些标签,例如 "docker"、"linux" 等
  • Runner executor:选择 "docker"
  • Runner token:填写你在配置文件中设置的 token

5. 启动 GITLAB-RUNNER

最后,我们需要启动 GITLAB-RUNNER。

sudo systemctl start gitlab-runner
sudo systemctl enable gitlab-runner

验证安装

为了验证 GITLAB-RUNNER 是否安装成功,我们可以执行以下命令:

sudo gitlab-runner verify

如果出现以下输出,则表示安装成功:

Checking runner configuration...
Runner configuration OK
Checking runner cache...
Runner cache OK
Checking runner system...
Runner system OK
Checking runner network...
Runner network OK
Checking runner docker...
Runner docker OK

总结

至此,我们已经完成了 GITLAB-RUNNER 的安装和配置。接下来,我们就可以在 Gitlab 上创建 CI/CD 作业,并使用 GITLAB-RUNNER 来执行这些作业了。在下一篇文章中,我们将详细介绍如何使用 Gitlab 自动部署一个简单的项目。