casjaysdevdocker/gitea

gitea Docker镜像文档

镜像概述和主要用途

gitea Docker镜像是一个轻量级的Git服务容器，旨在提供简单、高效的代码托管解决方案。它支持Git版本控制、代码仓库管理、用户权限控制等核心功能，适用于个人开发者或小型团队搭建私有代码仓库，实现代码的存储、版本管理和协作开发。

核心功能和特性

• 轻量级部署：容器化设计，部署简单，资源占用低
• 持久化存储：支持数据和配置目录的持久化挂载，确保数据不丢失
• 环境配置：通过环境变量灵活配置时区、主机名等参数
• 自动更新：支持通过dockermgr工具实现镜像的自动安装与更新
• 兼容性：支持Docker Compose编排，便于集成到现有部署环境

使用场景和适用范围

• 个人开发者搭建私有Git仓库
• 小型开发团队内部代码协作与版本管理
• 需要快速部署Git服务的开发环境或测试环境
• 对资源占用有要求的轻量级服务器环境

使用方法和配置说明

系统脚本安装

首先安装系统管理脚本，用于后续的镜像管理：

shell
sudo bash -c "$(curl -q -LSsf "https://github.com/systemmgr/installer/raw/main/install.sh")"
sudo systemmgr --config && sudo systemmgr install scripts

自动安装/更新

通过dockermgr工具自动安装或更新gitea镜像：

shell
dockermgr update gitea

手动安装并运行容器

1. 创建必要的目录结构：

shell
mkdir -p "$HOME/.local/share/srv/docker/gitea/rootfs"
git clone "https://github.com/dockermgr/gitea" "$HOME/.local/share/CasjaysDev/dockermgr/gitea"
cp -Rfva "$HOME/.local/share/CasjaysDev/dockermgr/gitea/rootfs/." "$HOME/.local/share/srv/docker/gitea/rootfs/"

2. 运行容器：

shell
docker run -d \
--restart always \
--privileged \
--name casjaysdevdocker-gitea \
--hostname gitea \
-e TZ=${TIMEZONE:-America/New_York} \
-v "$HOME/.local/share/srv/docker/casjaysdevdocker-gitea/rootfs/data:/data:z" \
-v "$HOME/.local/share/srv/docker/casjaysdevdocker-gitea/rootfs/config:/config:z" \
-p 80:80 \
casjaysdevdocker/gitea:latest

通过Docker Compose部署

创建docker-compose.yml文件，内容如下：

yaml
version: "2"
services:
  ProjectName:
    image: casjaysdevdocker/gitea
    container_name: casjaysdevdocker-gitea
    environment:
      - TZ=America/New_York  # 时区设置，可替换为其他时区如Asia/Shanghai
      - HOSTNAME=gitea       # 容器主机名
    volumes:
      - "$HOME/.local/share/srv/docker/casjaysdevdocker-gitea/rootfs/data:/data:z"  # 数据持久化目录
      - "$HOME/.local/share/srv/docker/casjaysdevdocker-gitea/rootfs/config:/config:z"  # 配置持久化目录
    ports:
      - 80:80  # 端口映射，主机端口:容器端口
    restart: always  # 容器退出后自动重启

运行容器：docker-compose up -d

获取源码文件

通过dockermgr下载源码：

shell
dockermgr download src casjaysdevdocker/gitea

或通过Git克隆源码：

shell
git clone "https://github.com/casjaysdevdocker/gitea" "$HOME/Projects/github/casjaysdevdocker/gitea"

构建容器

进入源码目录并构建：

shell
cd "$HOME/Projects/github/casjaysdevdocker/gitea"
buildx 

配置参数说明

环境变量

• TZ：时区设置，默认值为America/New_York，可根据需要修改（如Asia/Shanghai）
• HOSTNAME：容器主机名，默认值为gitea

卷挂载

• /data：数据存储目录，用于存放Git仓库数据、用户信息等
• /config：配置文件目录，用于存放gitea的配置文件

作者信息

• casjay: https://github.com/casjay
• casjaysdevdocker: https://github.com/casjaysdevdocker | https://hub.docker.com/u/casjaysdevdocker