velocityorg/docker-gitlab-runner

Velocity.org Gitlab Runner 12.9.0

https://hub.docker.com/r/velocityorg/docker-gitlab-runner/

这是一个可在Docker Swarm上部署的GitLab多runner栈镜像，支持Amazon S3或Minio兼容的对象存储。

支持的标签及Dockerfile链接

• https://github.com/velocityorg/docker-gitlab-runner/blob/master/latest/Dockerfile

（待办：后续将支持更多runner版本，目前仅提供"latest"）

环境变量

GitLab Runner应用本身支持通过环境变量配置，因此通过docker run -e ...或compose文件设置的环境变量会传递给gitlab-runner二进制文件。

必须指定的环境变量是GITLAB_SERVER，需包含GitLab实例的完整URL（包括https协议）。通常该值对应CI_SERVER_URL，但此处使用GITLAB_SERVER更直观，未来可能支持两种变量名。

必填变量

• GITLAB_SERVER：GitLab服务器的主机名/IP地址:端口，需包含https协议（建议使用HTTPS）。

其他环境变量

更多可传递的环境变量请参考syntax.md文件。

Docker Secrets

该镜像使用Docker Secrets存储敏感数据，支持以下secrets：

• gitlab_access_token：GitLab提供的runner认证令牌（在GitLab管理员界面：设置 => Runners获取）
• s3_access_key（可选）：Amazon S3或兼容服务的访问密钥
• s3_secret_key（可选）：Amazon S3或兼容服务的秘密密钥

Secrets名称必须严格匹配上述名称，runner脚本会在/var/run/secrets路径中查找对应文件。

可在任意Swarm管理节点执行以下命令创建secrets：

bash
echo "你的gitlab访问令牌" | docker secret create gitlab_access_token -
echo "你的S3访问密钥" | docker secret create s3_access_key -
echo "你的S3秘密密钥" | docker secret create s3_secret_key -

也可使用文件形式的secrets，但不建议在Git仓库中存储栈配置时使用此方式。

非Swarm环境下的Secrets替代方案

若不使用Docker Swarm，无法直接使用Docker Secrets。此时可创建docker-compose.override.yaml文件存储敏感数据（该文件不应提交到版本控制系统）。示例override文件可参考相关文档。

Docker Swarm栈配置示例

yaml
version: '3.7'

services:
    gitlab-runner:
        image: velocityorg/docker-gitlab-runner:latest
        environment:
            - GITLAB_SERVER=https://my.cool.gitlab.server.com
        volumes:
            - '/var/run/docker.sock:/var/run/docker.sock'
        networks:
            - gitlab_ci_net
        secrets:
            - gitlab_access_token
            - s3_access_key
            - s3_secret_key
        deploy:
            mode: global
            placement:
                constraints: [node.role == worker]

secrets:
    gitlab_access_token:
        external: true
    s3_access_key:
        external: true
    s3_secret_key:
        external: true

networks:
  gitlab_ci_net:

注意：若使用Docker Secrets，栈配置文件的版本必须至少为3.1（Docker Secrets从该版本开始支持），且Docker版本需不低于v1.13.1。