Drone CI 中文文档

在 Linux 上安装 Docker Runner

本文介绍了如何在 Linux 上安装 Docker 运行器。Docker Runner 打包为一个最小的 Docker 镜像,存放在 DockerHub 上,可用于以下架构:

  • amd64
  • arm
  • arm64

下载

安装 Docker 并拉取公共镜像:

docker pull drone/drone-runner-docker:1

配置

Docker Runner 是使用环境变量配置的。本文引用了以下配置选项。有关配置选项的完整列表,请参阅 配置

  • DRONE_RPC_HOST
    提供 Drone Server 的主机名(和可选端口)。Runner 连接到指定主机地址的 Server 以接收 Pipeline 以执行。
  • DRONE_RPC_PROTO
    提供用于连接 Drone Server 的协议。该值必须是 httphttps
  • DRONE_RPC_SECRET :提供用于向 Drone Server 进行身份验证的共享密钥。这必须与你的 Drone Server 配置中定义的 Secret 匹配。

安装

以下命令创建一个容器并启动 Docker Runner。请记住用你的 Drone Server 详细信息替换下面的环境变量。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
docker run --detach \
  --volume=/var/run/docker.sock:/var/run/docker.sock \
  --env=DRONE_RPC_PROTO=https \
  --env=DRONE_RPC_HOST=drone.company.com \
  --env=DRONE_RPC_SECRET=super-duper-secret \
  --env=DRONE_RUNNER_CAPACITY=2 \
  --env=DRONE_RUNNER_NAME=my-first-runner \
  --publish=3000:3000 \
  --restart=always \
  --name=runner \
  drone/drone-runner-docker:1

验证安装结果

使用 docker logs 命令查看日志并验证 Runner 是否成功与 Drone Server 建立连接。

$ docker logs runner

INFO[0000] starting the server
INFO[0000] successfully pinged the remote server