cyd01/gitlabcli

Gitlab API客户端

镜像概述

本镜像基于https://github.com/xanzy/go-gitlab%E5%BA%93%E5%B0%81%E8%A3%85%EF%BC%8C%E6%8F%90%E4%BE%9B%E5%91%BD%E4%BB%A4%E8%A1%8C%E5%B7%A5%E5%85%B7%E7%94%A8%E4%BA%8E%E7%AE%A1%E7%90%86Gitlab%E5%AE%9E%E4%BE%8B%EF%BC%8C%E6%94%AF%E6%8C%81Gitlab API v4版本。

核心功能

• 支持Gitlab API v4的多种操作（如查看广播消息、获取状态、查询用户信息等）
• 多种认证方式：访问令牌（token）、用户名+密码（无2FA时）
• 输出格式灵活：默认Docker风格格式化输出，可通过参数获取原始JSON响应
• 支持自定义Gitlab实例地址

使用场景

• 批量管理Gitlab实例的广播消息
• 查询Gitlab实例的系统状态或用户信息
• 自动化脚本中调用Gitlab API进行操作

配置说明

基础运行

执行以下命令查看客户端使用帮助：

bash
docker run --rm --interactive --tty cyd01/gitlabcli

指定Gitlab实例

通过GITLAB_URL环境变量设置目标Gitlab实例地址（默认使用官方Gitlab.com）：

bash
export GITLAB_URL="https://gitlab.com"
docker run --rm --interactive --tty --env GITLAB_URL cyd01/gitlabcli broadcast ls

认证方式

访问令牌认证

设置GITLAB_TOKEN环境变量传入访问令牌：

bash
export GITLAB_TOKEN="你的访问令牌"
docker run --rm --interactive --tty --env GITLAB_URL --env GITLAB_TOKEN cyd01/gitlabcli status get

用户名密码认证（无2FA时）

设置GITLAB_AUTH_USER和GITLAB_AUTH_PASS环境变量：

bash
export GITLAB_AUTH_USER="root"
export GITLAB_AUTH_PASS="你的密码"
docker run --rm --interactive --tty --env GITLAB_URL --env GITLAB_AUTH_USER --env GITLAB_AUTH_PASS cyd01/gitlabcli whoami

输出格式

• 默认：Docker风格格式化输出
• 原始JSON输出：添加-output-raw参数

bash
docker run --rm --interactive --tty --env GITLAB_URL --env GITLAB_TOKEN cyd01/gitlabcli status get -output-raw

注意事项

Gitlab.com用户和项目较多，API请求可能耗时较长，可通过-user username参数限制请求范围到指定用户。 ===FULL_DESC===