smarthelios/git

Alpine Git-YQ-OpenSSH 镜像文档

镜像概述

本镜像基于Alpine Linux构建，集成了git（版本控制工具）、yq（YAML/JSON处理工具）和openssh（SSH客户端/服务端工具），提供轻量级环境支持版本控制、配置文件处理及远程连接需求。

核心功能与特性

• 基础环境：基于Alpine Linux，镜像体积小（约50-60MB），资源占用低
• 预装工具：
  • git：完整的版本控制功能，支持代码克隆、提交、分支管理等
  • yq：支持YAML/JSON文件的查询、修改、转换等操作（基于mikefarah/yq）
  • openssh：包含ssh客户端、scp、sftp等工具，支持远程服务器连接与文件传输

使用场景

• CI/CD流水线：用于代码拉取、配置文件处理、远程服务器部署
• 开发环境：轻量级工具集，满足日常版本控制与配置处理需求
• 自动化脚本：在容器中执行包含git操作、YAML处理或SSH连接的自动化任务
• 临时环境：快速启动包含基础工具的临时工作环境

使用方法

基本使用

通过docker run命令启动容器：

bash
docker run -it --rm alpine-git-yq-openssh

此命令将以交互模式启动容器，并在退出时自动清理容器。

工具使用示例

1. Git操作

bash
# 克隆代码仓库
git clone https://github.com/example/repo.git

# 查看分支
git branch

# 提交修改
git add . && git commit -m "Update config"

2. YAML文件处理（yq）

bash
# 查看YAML文件内容
yq eval '.' config.yaml

# 修改YAML文件中的值
yq eval '.key = "new-value"' -i config.yaml

# 提取JSON格式输出
yq eval -o json '.' config.yaml

3. SSH连接

bash
# 连接远程服务器
ssh user@remote-host

# 使用scp传输文件
scp local-file.txt user@remote-host:/path/remote-file.txt

持久化数据

如需保留工作目录数据，可挂载本地目录：

bash
docker run -it --rm -v $(pwd):/workspace alpine-git-yq-openssh

容器内/workspace目录将映射到本地当前目录，操作数据可持久化保存。

环境变量配置

可通过环境变量自定义部分行为（如SSH密钥配置）：

bash
docker run -it --rm \
  -e SSH_PRIVATE_KEY="$(cat ~/.ssh/id_rsa)" \
  alpine-git-yq-openssh

容器启动时可自动加载SSH私钥（需确保密钥权限正确）。

注意事项

• Alpine Linux使用apk包管理器，可通过apk add安装额外工具
• SSH服务默认未启动，如需作为SSH服务端使用，需自行配置sshd_config并启动服务
• yq工具版本以镜像构建时的最新稳定版为准，具体功能可通过yq --help查看