codefresh/cf-git-providers

Git多平台交互CLI工具镜像

镜像概述

本镜像是一个轻量级命令行工具(CLI)，专为与各类Git服务提供商（如GitHub、GitLab、Bitbucket等）进行交互而设计。它提供统一的操作接口，简化跨不同Git平台的仓库管理、代码提交、分支操作等任务，适合集成到开发流程或自动化脚本中。

核心功能与特性

• 多平台支持：兼容主流Git服务提供商，包括GitHub、GitLab、Bitbucket等
• 命令行便捷操作：通过简洁的命令完成复杂Git交互任务，减少手动操作
• 轻量级设计：镜像体积小巧，资源占用低，启动速度快
• 认证集成：支持通过令牌、SSH密钥等多种方式进行Git服务认证
• 跨环境一致性：通过Docker容器化确保在不同环境中操作行为一致

使用场景与适用范围

• 开发者日常工作流：简化跨平台Git仓库的克隆、提交、推送等操作
• CI/CD流水线集成：在自动化流程中与Git服务交互（如创建PR、获取仓库信息）
• 多平台项目管理：同时管理分布在不同Git服务上的多个项目
• 自动化脚本开发：编写统一脚本处理不同Git平台的批量操作

使用方法

1. 获取镜像

bash
docker pull [镜像仓库地址]/git-interactive-cli:latest

注：请将[镜像仓库地址]替换为实际的Docker镜像仓库地址

2. 基本操作示例

查看帮助信息

bash
docker run --rm [镜像仓库地址]/git-interactive-cli:latest --help

获取指定仓库信息

bash
docker run --rm \
  -e GIT_PROVIDER="github" \
  -e GIT_TOKEN="your_github_personal_access_token" \
  [镜像仓库地址]/git-interactive-cli:latest \
  repo info --owner "username" --repo "repository-name"

跨平台克隆仓库

bash
docker run --rm \
  -v $(pwd):/workspace \
  -e GIT_PROVIDER="gitlab" \
  -e GIT_TOKEN="your_gitlab_token" \
  [镜像仓库地址]/git-interactive-cli:latest \
  repo clone --owner "group-name" --repo "project-name" --dest /workspace

3. 环境变量配置

4. 持久化配置（可选）

如需保存常用配置，可挂载本地目录作为配置存储：

bash
docker run --rm \
  -v $(pwd)/git-cli-config:/root/.git-cli \
  [镜像仓库地址]/git-interactive-cli:latest \
  config save --provider "github" --token "your_token"

后续使用时无需重复指定环境变量：

bash
docker run --rm \
  -v $(pwd)/git-cli-config:/root/.git-cli \
  [镜像仓库地址]/git-interactive-cli:latest \
  repo list --owner "username"

注意事项

• 确保提供的访问令牌具有足够权限（如仓库读取/写入、PR管理等）
• 敏感信息（如令牌、SSH密钥）建议通过环境变量或安全挂载方式传入，避免硬编码
• 不同Git提供商的API存在差异，部分命令可能需要针对特定平台调整参数
• 长时间运行任务建议使用-it参数保持交互模式：

  bash
  docker run --rm -it [镜像仓库地址]/git-interactive-cli:latest