profclems/glab

glab Docker镜像文档

镜像概述

glab是一个开源的GitLab命令行工具，旨在将GitLab的各项核心功能（如仓库管理、合并请求、问题跟踪、CI/CD等）集成到命令行界面，使用户无需依赖Web界面即可高效完成GitLab相关操作。该Docker镜像封装了glab工具，提供便捷的部署和使用方式。

核心功能和特性

• 全面的GitLab功能支持：覆盖仓库管理、分支操作、合并请求创建/审核/合并、问题管理、里程碑、CI/CD流水线控制等核心功能。
• 命令行高效操作：通过简洁的命令语法，减少Web界面操作的繁琐步骤，提升开发效率。
• 开源免费：基于MIT许可证开源，可自由使用和二次开发。
• 跨平台兼容：通过Docker容器化，可在任何支持Docker的操作系统上运行。

使用场景和适用范围

• 开发者日常工作流：替代GitLab Web界面，快速执行代码提交、合并请求、问题跟踪等操作。
• 自动化脚本集成：在CI/CD脚本或自动化工具中调用glab命令，实现GitLab相关操作的自动化。
• 服务器环境部署：在无图形界面的服务器环境中，通过命令行管理GitLab资源。

使用方法和配置说明

基本使用（docker run）

bash
# 查看glab版本
docker run --rm profclems/glab version

# 配置GitLab认证（需替换YOUR_GITLAB_TOKEN和YOUR_GITLAB_URL）
docker run --rm -v ~/.config/glab:/root/.config/glab profclems/glab auth login --token YOUR_GITLAB_TOKEN --hostname YOUR_GITLAB_URL

# 列出当前项目的合并请求
docker run --rm -v ~/.config/glab:/root/.config/glab profclems/glab mr list

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  glab:
    image: profclems/glab
    volumes:
      - ~/.config/glab:/root/.config/glab  # 持久化配置文件
    environment:
      - GITLAB_TOKEN=YOUR_GITLAB_TOKEN    # GitLab访问令牌（可选，替代手动登录）
      - GITLAB_HOST=YOUR_GITLAB_URL       # GitLab实例地址（可选，默认为gitlab.com）

启动并使用：

bash
# 登录GitLab（若未设置环境变量）
docker-compose run --rm glab auth login

# 查看项目信息
docker-compose run --rm glab project info

核心配置参数

常用命令示例

• 创建合并请求：glab mr create --source-branch feature-branch --target-branch main --title "Add new feature"
• 审核合并请求：glab mr review 123 --approve（123为合并请求ID）
• 查看CI/CD流水线状态：glab ci status
• 创建问题：glab issue create --title "Bug fix" --description "Fix login error"

更多信息

完整文档和命令参考请访问项目GitHub仓库：https://github.com/profclems/glab