taskcluster/generic-worker

Taskcluster Generic Worker 镜像文档

镜像概述

Taskcluster Generic Worker 镜像提供了在Docker容器中运行Taskcluster通用工作节点的能力。该工作节点能够连接到指定的Taskcluster部署，从配置的任务队列中认领并处理任务，是Taskcluster任务执行架构的关键组件。

核心功能与特性

• 容器化部署：可在Docker环境中轻松部署，简化环境配置与依赖管理
• 灵活配置：支持通过配置文件和环境变量自定义工作节点参数
• Taskcluster集成：与Taskcluster服务无缝对接，支持任务认领、执行与状态汇报
• 安全认证：通过客户端ID和访问令牌实现与Taskcluster部署的安全认证

使用场景

• 需要在Docker环境中部署Taskcluster工作节点的场景
• 开发与测试环境中快速搭建Taskcluster任务执行节点
• 需要隔离任务执行环境的场景

使用方法

前置要求

• 已创建Taskcluster客户端凭证（包含clientId和accessToken）
• Docker环境已安装并运行

配置文件准备

创建工作节点配置文件worker-config.json，示例如下：

json
{
  "accessToken": "%access-token%",  // 替换为实际访问令牌
  "clientId": "%clientId%",        // 替换为实际客户端ID
  "ed25519SigningKeyLocation": "/etc/generic-worker/ed25519_key",  // 签名密钥位置
  "rootURL": "https://dev.alpha.taskcluster-dev.net",  // Taskcluster部署根URL
  "workerId": "generic-worker",    // 工作节点ID
  "provisionerId": "docker-compose",  // 供应者ID
  "workerType": "generic-worker",  // 工作节点类型
  "livelogExecutable": "/usr/local/bin/livelog",  // 实时日志可执行文件路径
  "taskclusterProxyExecutable": "/usr/local/bin/taskcluster-proxy",  // Taskcluster代理可执行文件路径
  "publicIP": "127.1.2.3"  // 工作节点公网IP
}

运行Docker容器

使用以下命令启动工作节点容器，连接到指定Taskcluster部署并开始认领任务：

sh
docker run -it --rm \
  -e TASKCLUSTER_ROOT_URL=https://your-deployment \  # 替换为实际Taskcluster部署URL
  -e TASKCLUSTER_CLIENT_ID=%client-id% \            # 替换为实际客户端ID
  -e TASKCLUSTER_ACCESS_TOKEN=%access-token% \      # 替换为实际访问令牌
  -v $(pwd)/worker-config.json:/etc/generic-worker/config.json \  # 挂载配置文件
  taskcluster/generic-worker:v44.20.4 \             # 镜像名称及版本
  standalone                                        # 启动模式

参数说明

环境变量

• TASKCLUSTER_ROOT_URL: Taskcluster部署的根URL
• TASKCLUSTER_CLIENT_ID: 用于认证的客户端ID
• TASKCLUSTER_ACCESS_TOKEN: 用于认证的访问令牌

配置文件参数

• accessToken: 访问令牌（与环境变量二选一，环境变量优先级更高）
• clientId: 客户端ID（与环境变量二选一，环境变量优先级更高）
• rootURL: Taskcluster部署根URL（与环境变量二选一，环境变量优先级更高）
• workerId: 工作节点唯一标识
• provisionerId: 关联的供应者ID
• workerType: 工作节点类型，用于任务队列匹配

镜像来源

https://github.com/taskcluster/taskcluster/blob/main/generic-worker.Dockerfile