gitlab/glab

glab GitLab CLI 工具 Docker 镜像介绍

简介

glab 是 GitLab 官方提供的命令行工具，可直接在终端操作 GitLab 功能（如项目管理、Issue、合并请求等）。本 Docker 镜像封装了 glab 工具，无需在本地系统安装，直接通过容器即可使用，适合快速部署、多环境一致性需求场景。

基本用法

拉取镜像

官方镜像托管于 GitLab Container Registry，拉取命令：

bash
docker pull registry.gitlab.com/gitlab-org/cli/glab:latest

（可替换 latest 为具体版本号，如 v1.33.0，推荐指定版本以确保稳定性）

首次运行与认证

glab 需与 GitLab 服务端认证，推荐通过 个人访问令牌（Personal Access Token） 认证。首次使用需执行认证配置：

1. 方式一：手动交互认证
   运行容器并执行 auth login，按提示输入 GitLab 实例 URL（如 `[]
   CODE_TOKEN_1

   • -it：交互模式，允许输入令牌
   • -v ~/.config/glab:/root/.config/glab：挂载本地目录保存配置（容器内 glab 默认配置路径为 /root/.config/glab）
   • 完成后，本地 ~/.config/glab 目录会生成持久化配置，后续无需重复认证

2. 方式二：环境变量传递令牌（适合脚本/自动化）
   直接通过 GITLAB_TOKEN 环境变量传入令牌，无需交互：
   CODE_TOKEN_2

常用命令示例

以下命令均需挂载配置目录（确保认证信息生效），示例中镜像名简化为 glab-img（可自行替换为完整镜像路径）。

1. 查看项目信息

CODE_TOKEN_3
（my-group/my-project 为项目完整路径，或使用项目 ID）

2. 创建 Issue

CODE_TOKEN_4

3. 列出合并请求

CODE_TOKEN_5

4. 推送分支并创建合并请求

CODE_TOKEN_6

注意事项

1. 配置持久化：必须挂载 ~/.config/glab 到容器内 /root/.config/glab，否则每次运行容器都需重新认证。
2. 认证令牌权限：个人访问令牌需包含必要权限（如 api、read_repository、write_repository），创建令牌路径：GitLab 个人设置 → Access Tokens。
3. 镜像版本：生产环境建议指定具体版本（如 v1.33.0），避免 latest 标签自动更新导致兼容性问题。
4. 权限问题：若挂载目录提示权限错误，检查本地 ~/.config/glab 目录权限（可临时执行 chmod -R 777 ~/.config/glab 测试，生产环境需按最小权限原则配置）。

通过以上步骤，可快速使用 Docker 容器运行 glab CLI，简化 GitLab 终端操作流程。详细命令可参考 [glab 官方文档] 。