原文链接：https://docs.gitlab.com/runner/install/docker.html
本文描述的是如何在 Docker 容器中运行 GitLab Runner 的方法。
通常的 GitLab Runner Docker 镜像用法
GitLab Runner 的 Docker 镜像（基于 Ubuntu 或 Alpine Linux）被设计为围绕标准 gitlab-runner 命令的包装器，就像 GitLab Runner 直接安装在主机上一样。
一般规则是每个 GitLab Runner 命令通常会执行为：
gitlab-runner [Runner command and options...]
可以执行为：
docker run [chosen docker options...] gitlab/gitlab-runner [Runner command and options...]
例如，想要获取 GitLab Runner 命令的顶级帮助信息可以执行：
docker run --rm -t -i gitlab/gitlab-runner --help
NAME:
gitlab-runner - a GitLab Runner
USAGE:
gitlab-runner [global options] command [command options] [arguments...]
VERSION:
10.7.0 (7c273476)
(...)
简而言之，命令 gitlab-runner 被 docker run [docker options] gitlab/gitlab-runner 替换，而 Runner 命令的其余部分保留，就像 注册文档 中描述的那样。唯一的区别是 gitlab-runner 命令是在 Docker 容器内执行的。
Docker 镜像的安装和配置
- 首先安装 Docker：
curl -sSL https://get.docker.com/ | sh
- 你需要将配置卷安装到
gitlab-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
💡提示：在 macOS 系统中，使用
/Users/Shared代替/srv。
或者，您也可以使用配置容器来装入自定义数据卷：
docker run -d --name gitlab-runner-config \
-v /etc/gitlab-runner \
busybox:latest \
/bin/true
然后，运行 Runner：
docker run -d --name gitlab-runner --restart always \
-v /var/run/docker.sock:/var/run/docker.sock \
--volumes-from gitlab-runner-config \
gitlab/gitlab-runner:latest
- 按照 Docker section of Registering Runners 中的说明注册刚刚启动的 Runner。
请务必阅读 FAQ 部分，其中介绍了GitLab Runner的一些最常见问题。
更新
拉取 gitlab/gitlab-runner 最新版本：
docker pull gitlab/gitlab-runner:latest
停止并删除现有容器：
docker stop gitlab-runner && docker rm gitlab-runner
像原来一样启动容器：
docker run -d --name gitlab-runner --restart always \
-v /var/run/docker.sock:/var/run/docker.sock \
-v /srv/gitlab-runner/config:/etc/gitlab-runner \
gitlab/gitlab-runner:latest
注意：您需要使用与最初安装数据卷相同的方法（
-v /srv/gitlab-runner/config:/etc/gitlab-runner或者--volumes-from gitlab-runner-config）。
查看 GitLab Runner 日志
当 GitLab Runner 作为前台任务启动时（无论是本地安装的二进制文件还是 Docker 容器内），日志都会打印到标准输出。
当 GitLab Runner 作为系统服务启动时（例如使用 Systemd），在大多数情况下，日志通过 Syslog 或其他系统日志记录机制记录。
当 GitLab Runner 作为基于 Docker 的服务启动时，因为 gitlab-runner ... 命令是容器的主要进程，所以可以使用 docker logs 命令读取日志。
例如，如果使用以下命令启动 GitLab Runner：
docker run -d --name gitlab-runner --restart always \
-v /var/run/docker.sock:/var/run/docker.sock \
-v /srv/gitlab-runner/config:/etc/gitlab-runner \
gitlab/gitlab-runner:latest
您可以通过以下方式获取日志：
docker logs gitlab-runner
其中 gitlab-runner 是启动 GitLab Runner 时，用第一个命令 --name gitlab-runner 设置的容器名称。
您可以在 Docker文档页面 上找到有关处理容器日志的更多信息。
安装受信任的 SSL 服务器证书
如果您（自搭建的）的 GitLab CI 服务使用自签名 SSL 证书，那么您应确保 gitlab-runner 容器信任 GitLab CI 服务器证书，以便它们能够相互通信。
gitlab/gitlab-runner 镜像被配置为在 /etc/gitlab-runner/certs/ca.crt 中查找受信任的 SSL 证书，但是可以使用 -e "CA_CERTIFICATES_PATH=/DIR/CERT" 配置选项来更改。
将 ca.crt 文件复制到数据卷（或容器）上的 certs 目录中。ca.crt 文件应包含您希望 gitlab-runner 信任的所有服务器的根证书。gitlab-runner 容器将在启动时导入 ca.crt 文件，因此如果您的容器已在运行，则可能需要重新启动它才能使更改生效。
Docker 镜像
镜像源 gitlab/gitlab-runner:latest 基于 Ubuntu 系统，请参阅 gitlab-org/gitlab-runner 源代码，了解 Ubuntu 和 Alpine 镜像的可能构建说明。
您也可以使用用于 Alpine Linux 系统下的名为 gitlab/gitlab-runner:alpine 的镜像，它占用空间小得多（Ubuntu 系统下大约 400 MB vs Alpine 系统下大约 100 MB ）。
SELinux
一些发行版（CentOS，RedHat，Fedora）默认使用 SELinux 来增强底层系统的安全性。
处理此类配置时必须特别小心。
- 如果要使用 Docker 执行程序在容器中运行构建，需要访问
/var/run/docker.sock。但是，如果您在执行模式下存在 SELinux，则在访问/var/run/docker.sock时会看到权限被拒绝。需要安装selinux-dockersock解决该问题：https://github.com/dpw/selinux-dockersock。 - 请确保在主机上创建了一个永久目录：
mkdir -p /srv/gitlab-runner/config。 - 在卷中使用
:Z运行 Docker。
docker run -d --name gitlab-runner --restart always \
-v /var/run/docker.sock:/var/run/docker.sock \
-v /srv/gitlab-runner/config:/etc/gitlab-runner:Z \
gitlab/gitlab-runner:latest
有关原因和解决方案的更多信息，请点击此处：http://www.projectatomic.io/blog/2015/06/using-volumes-with-docker-can-cause-problems-with-selinux/
