trueosiris/git

docker-git 镜像文档

镜像概述和主要用途

docker-git是一个基于Ubuntu 22.04的最小化沙箱容器，集成了git和vim工具，提供简化命令以方便在Docker环境中进行Git仓库管理和Docker镜像推送操作。该容器设计用于开发者在隔离环境中编辑代码、管理Git版本控制及推送Docker镜像，适合需要快速搭建Git和Docker操作环境的场景。

核心功能和特性

• 基础环境：基于Ubuntu 22.04，最小化设计，仅包含必要工具
• 核心工具：集成git和vim，满足代码编辑和版本控制需求
• 简化命令：提供gitpush、dockerpush和push三个简化命令，简化Git提交推送和Docker镜像构建推送流程
• SSH支持：自动生成SSH密钥，便于与GitHub等代码托管平台建立安全连接
• 灵活挂载：支持挂载本地目录和Docker socket，实现数据持久化和Docker引擎访问

使用场景和适用范围

• 开发者需要在隔离环境中快速搭建Git工作流
• 需要简化Git提交、推送和Docker镜像构建推送流程的场景
• 临时沙箱环境中进行代码编辑、版本控制和镜像推送操作
• 希望避免在本地环境直接安装和配置Git、Docker工具链的情况

使用方法和配置说明

首次设置

1. 启动容器：首次启动时，容器会在挂载的卷目录下创建凭证文件，并自动停止

   bash
   docker run -d --name='git' \
   --net='bridge' \
   -e TZ="Europe/Paris" \
   -v '/path/on/host/':'/mnt/github':'rw' \
   -v '/var/run/docker.sock':'/var/run/docker.sock':'rw' \
   'trueosiris/git'
   

2. 编辑凭证文件：在主机挂载目录（/path/on/host/）中找到并编辑.credentials.txt文件，按要求填写以下变量（无空格，含`# docker-git 镜像文档

镜像概述和主要用途

docker-git是一个基于Ubuntu 22.04的最小化沙箱容器，集成了git和vim工具，提供简化命令以方便在Docker环境中进行Git仓库管理和Docker镜像推送操作。该容器设计用于开发者在隔离环境中编辑代码、管理Git版本控制及推送Docker镜像，适合需要快速搭建Git和Docker操作环境的场景。

核心功能和特性

• 基础环境：基于Ubuntu 22.04，最小化设计，仅包含必要工具
• 核心工具：集成git和vim，满足代码编辑和版本控制需求
• 简化命令：提供gitpush、dockerpush和push三个简化命令，简化Git提交推送和Docker镜像构建推送流程
• SSH支持：自动生成SSH密钥，便于与GitHub等代码托管平台建立安全连接
• 灵活挂载：支持挂载本地目录和Docker socket，实现数据持久化和Docker引擎访问

使用场景和适用范围

• 开发者需要在隔离环境中快速搭建Git工作流
• 需要简化Git提交、推送和Docker镜像构建推送流程的场景
• 临时沙箱环境中进行代码编辑、版本控制和镜像推送操作
• 希望避免在本地环境直接安装和配置Git、Docker工具链的情况

使用方法和配置说明

首次设置

1. 启动容器：首次启动时，容器会在挂载的卷目录下创建凭证文件，并自动停止

   bash
   docker run -d --name='git' \
   --net='bridge' \
   -e TZ="Europe/Paris" \
   -v '/path/on/host/':'/mnt/github':'rw' \
   -v '/var/run/docker.sock':'/var/run/docker.sock':'rw' \
   'trueosiris/git'
   

2. 编辑凭证文件：在主机挂载目录（/path/on/host/）中找到并编辑.credentials.txt文件，按要求填写以下变量（无空格，含等特殊符号需用单引号包裹）：

   • GITUSER：GitHub用户名/仓库名
   • GITMAIL：GitHub***/登录账号
   • DOCKERUSER：Docker账号
   • DOCKERPASS：Docker密码
   • SSHPASS：openssh-server密码

3. 重启容器：完成凭证文件编辑后，重启容器

   bash
   docker restart git
   

4. 获取SSH密钥：查看容器日志获取生成的SSH密钥，用于添加到GitHub账号

   bash
   docker logs -f git
   

5. 添加SSH密钥到GitHub：登录GitHub，进入Settings -> SSH and GPG keys，添加日志中的SSH公钥

连接容器

使用以下命令进入容器交互式终端：

bash
docker exec -it git /bin/bash

使用简化命令

Git操作

1. 克隆Git仓库并进入目录

   bash
   git clone https://github.com/yourgituser/yourgitrepo
   cd yourgitrepo
   

2. 使用gitpush命令提交并推送代码，格式：gitpush [comment] [tag]

   bash
   # 无注释和标签
   gitpush
   
   # 带注释和标签
   gitpush "upgraded python" 1.3
   
   # 带注释和主分支标签
   gitpush "adapted the README.md" main
   

Docker镜像推送

1. 在Docker Hub创建仓库后，使用dockerpush命令构建并推送镜像，格式：dockerpush <repository>[:tag]

   bash
   # 推送默认标签
   dockerpush yourdockerrepo
   
   # 推送指定标签
   dockerpush yourdockerrepo:1.0
   
   # 推送并清理镜像
   dockerpush yourdockerrepo:1.1 --purge-images
   

一站式操作

使用push命令同时完成Git提交推送和Docker镜像构建推送，格式：push <docker-repository>[:docker-tag]

bash
push yourdockerrepo:1.0

环境变量

凭证文件变量

卷挂载

端口映射

可选暴露SSH端口，用于远程连接容器：

运行命令示例

bash
docker run -d --name='git' \
--net='bridge' \
-e TZ="Europe/Paris" \
-v '/path/on/host/':'/mnt/github':'rw' \
-v '/var/run/docker.sock':'/var/run/docker.sock':'rw' \
-p 1234:22 \  # 可选，如需SSH访问
'trueosiris/git'

相关链接

• GitHub仓库：https://github.com/TrueOsiris/docker-git
• Docker Hub仓库：https://hub.docker.com/repository/docker/trueosiris/git

日志信息

容器日志存储在/var/log/git.log。本镜像的Docker Hub描述使用peterevans/dockerhub-description工具更新，特此致谢。

注意：凭证文件中包含用户名和密码等敏感信息，存在暴露风险，请谨慎使用。