mawalu/hetzner-gitlab-runner

使用GitLab Runner和Hetzner Docker Machine驱动自动扩展CI作业

镜像概述和主要用途

该补丁版GitLab Runner镜像允许您在Hetzner Cloud上自动扩展CI作业。此补丁安装了https://github.com/JonasProgrammer/docker-machine-driver-hetzner%EF%BC%8C%E9%95%9C%E5%83%8F%E5%8F%AF%E5%9C%A8https://hub.docker.com/r/mawalu/hetzner-gitlab-runner%E8%8E%B7%E5%8F%96%E3%80%82

您可以遵循官方https://docs.gitlab.com/runner/executors/docker_machine.html%E9%85%8D%E7%BD%AE%E5%B8%A6%E6%9C%89Docker Machine的GitLab Runner，只需将此镜像作为gitlab/gitlab-runner的直接替代品使用。

核心功能和特性

• 无缝替代：可直接替换官方gitlab/gitlab-runner镜像
• Hetzner集成：内置Hetzner Docker Machine驱动，支持Hetzner Cloud自动扩展
• 配置兼容：遵循GitLab Runner官方配置规范，易于集成现有CI/CD流程
• 灵活定制：支持通过MachineOptions配置Hetzner特定参数（如服务器类型、镜像等）

使用场景和适用范围

• 需要在Hetzner Cloud上动态扩展CI/CD资源的团队
• 希望根据CI作业负载自动调整Runner数量的项目
• 已使用GitLab CI但需要在Hetzner环境实现弹性扩展的用户

使用方法和配置说明

基本使用

使用https://hub.docker.com/r/mawalu/hetzner-gitlab-runner%E6%9B%BF%E4%BB%A3%60gitlab/gitlab-runner%60%EF%BC%8C%E5%B9%B6%E5%9C%A8Runner%E9%85%8D%E7%BD%AE%E4%B8%AD%E5%B0%86%60MachineDriver%60%E8%AE%BE%E7%BD%AE%E4%B8%BA%60hetzner%60%E3%80%82

配置示例

config.toml示例

toml
concurrent = 1
check_interval = 0

[session_server]
  session_timeout = 1800

[[runners]]
  name = "docker-machine"
  url = "https://gitlab.com"
  token = "your-token"
  executor = "docker+machine"
  [runners.docker]
    tls_verify = false
    image = "docker:latest"
    privileged = true
    disable_cache = false
    volumes = ["/cache"]
    shm_size = 536870912
  [runners.cache]
  [runners.machine]
    IdleCount = 0
    IdleTime = 1800
    MaxBuilds = 10
    MachineDriver = "hetzner"
    MachineName = "runner-%s"
    MachineOptions = [
      "hetzner-api-token=hetzner-api-token",
      "hetzner-image=ubuntu-18.04",
      "hetzner-server-type=cx31",
    ]

docker-compose.yaml示例

yaml
version: "3.8"

services:
  hetzner-runner:
    image: mawalu/hetzner-gitlab-runner:latest
    volumes:
      - "./hetzner_config:/etc/gitlab-runner"

Docker错误处理

如果运行时遇到Docker相关问题（如下所示），可以在MachineOptions中指定Docker版本：

toml
 MachineOptions = [
      "engine-install-url=https://releases.rancher.com/install-docker/19.03.9.sh",
    ]

可能遇到的Docker错误：

bash
ERROR: Error creating machine: Error running provisioning: Unable to verify the Docker daemon is listening: Maximum number of retries (10) exceeded  driver=hetzner name=runner-xxx-xxx operation=create

更多信息请参见https://github.com/docker/machine/issues/4858%E3%80%82

版本信息

当前镜像基于gitlab/gitlab-runner:latest和最新版Hetzner Docker Machine插件构建。如需其他版本构建，请提交PR。

许可证

MIT