screwdrivercd/launcher

Screwdriver Launcher

概述和主要用途

Screwdriver Launcher是Screwdriver CI/CD系统中启动构建作业的入口点工具，负责连接Screwdriver API、获取构建配置并执行作业流程，支持通过Docker容器等多种方式运行，提供灵活的作业启动能力。

核心功能和特性

• 作为Screwdriver构建作业的启动入口，处理API地址和构建ID参数
• 支持通过环境变量SD_SHELL_BIN配置替代shell（默认使用/bin/sh）
• 兼容Docker容器、Go工具和Habitat包等多种运行环境
• 轻量级设计，专注于作业启动流程的高效执行

使用场景和适用范围

主要用于Screwdriver CI/CD系统中启动构建作业，适用于需要自动化构建、测试和部署流程的开发与运维场景，支持各类持续集成/持续部署工作流的初始化执行。

使用方法和配置说明

Docker使用方式

拉取镜像

bash
docker pull screwdrivercd/launcher

基本运行命令

bash
docker run screwdrivercd/launcher --api-uri http://localhost:8080/v4 buildId

配置替代shell

如需使用默认/bin/sh以外的shell，可通过SD_SHELL_BIN环境变量指定：

bash
docker run -e SD_SHELL_BIN=/bin/bash screwdrivercd/launcher --api-uri http://localhost:8080/v4 buildId

其他使用方式

Go工具

bash
go get github.com/screwdriver-cd/launcher
launcher --api-uri http://localhost:8080/v4 buildId

Habitat包

bash
hab package install screwdriver-cd/launcher
hab package exec screwdriver-cd/launcher launcher --api-uri http://localhost:8080/v4 buildId

测试

bash
go get github.com/screwdriver-cd/launcher
go test -cover github.com/screwdriver-cd/launcher/...

构建（Habitat）

bash
habitat studio enter
build
hab pkg exec $HAB_ORIGIN/launcher launcher --help

许可证

代码基于BSD 3-Clause许可证授权。详情参见LICENSE文件。