maniator/gh

Docker化GitHub CLI镜像

镜像概述和主要用途

基于Alpine Linux的轻量级容器，用于无缝运行GitHub CLI（gh）命令行工具，可在任何环境中使用，尤其适用于采用Docker的CI流程项目，提供一致的GitHub命令行操作体验。

核心功能和特性

• 轻量级基础：基于Alpine Linux构建，镜像体积小，资源占用低
• 无缝集成：直接运行gh原生命令，无需本地安装GitHub CLI
• 目录挂载支持：可挂载用户主目录（保存配置）和当前工作目录（操作本地文件）
• 灵活认证：通过环境变量GITHUB_TOKEN传递GitHub认证信息
• 命令简化：支持设置别名，将容器命令转换为类本地命令使用

使用场景和适用范围

• CI/CD流程：在Docker化的持续集成/部署流程中执行GitHub操作（如仓库克隆、PR创建、Issue管理等）
• 临时环境：在无本地gh工具安装的环境中快速使用GitHub命令行功能
• 跨平台一致性：确保不同环境中使用统一版本的gh工具，避免版本差异导致的问题

详细使用方法和配置说明

GitHub仓库

https://github.com/serveside/gh

Docker镜像标签

https://hub.docker.com/r/maniator/gh/tags/

基本使用命令

shell
docker run -it --rm -v ${HOME}:/root -v $(pwd):/gh -e GITHUB_TOKEN=<token> maniator/gh <command>

参数说明：

• -it：交互式终端模式，支持命令行交互
• --rm：容器退出后自动删除，避免残留容器
• -v ${HOME}:/root：挂载用户主目录到容器内/root，用于保存gh配置和认证信息
• -v $(pwd):/gh：挂载当前工作目录到容器内/gh，方便操作本地文件系统
• -e GITHUB_TOKEN=<token>：设置GitHub认证令牌（可选，若已通过其他方式完成认证可省略）

可选别名设置

为简化日常使用，可通过别名将容器命令映射为本地命令：

shell
alias gh="docker run -ti --rm -v ${HOME}:/root -v $(pwd):/gh maniator/gh"

设置别名后，可直接使用类本地命令操作，例如克隆本仓库：

shell
gh repo clone serveside/gh