easysoft/gitea Docker 镜像

QuickOn Gitea 应用镜像

申明: 该软件镜像是由QuickOn打包。在发行中提及的各自商标由各自的公司或个人所有，使用它们并不意味着任何从属关系。

快速参考

• 通过 https://www.qucheng.com/app-install/install-gitea-134.html 一键安装 Gitea
• https://github.com/quicklyon/gitea-docker
• https://github.com/go-gitea/gitea
• https://gitea.io/

一、关于 Gitea

Gitea 是一个自托管的Git服务程序，与GitHub、Bitbucket或Gitlab等类似。它从Gogs发展而来，后经Fork并命名为Gitea。关于Fork原因可参考 https://blog.gitea.io/2016/12/welcome-to-gitea/。

Gitea官网：https://gitea.io/

目标

Gitea的首要目标是创建一个极易安装、运行快速、安装和使用体验良好的自建Git服务。采用Go作为后端语言，只需生成一个可执行程序即可运行，且支持跨平台（Linux、macOS、Windows）及多种架构（x86、amd64、ARM、PowerPC等）。

功能特性

• 支持活动时间线
• 支持SSH及HTTP/HTTPS协议
• 支持SMTP、LDAP和反向代理的用户认证
• 支持反向代理子路径
• 支持用户、组织和仓库管理系统
• 支持添加和删除仓库协作者
• 支持仓库和组织级别Web钩子（包括Slack集成）
• 支持仓库Git钩子和部署密钥
• 支持仓库工单（Issue）、合并请求（Pull Request）及Wiki
• 支持迁移和镜像仓库及其Wiki
• 支持在线编辑仓库文件和Wiki
• 支持自定义源的Gravatar和Federated Avatar
• 支持邮件服务
• 支持后台管理面板
• 支持MySQL、PostgreSQL、SQLite3、MSSQL和TiDB(MySQL)数据库
• 支持多语言本地化（21种语言）
• 支持软件包注册中心（Composer/Conan/Container/Generic/Helm/Maven/NPM/Nuget/PyPI/RubyGems）

系统要求

• 最低系统硬件要求：廉价树莓派
• 团队项目建议配置：2核CPU及1GB内存

浏览器支持

Chrome, Firefox, Safari, Edge

二、支持的版本(Tag)

由于版本较多，此处仅列出最新5个版本，更详细版本列表请参考：https://hub.docker.com/r/easysoft/gitea/tags/

• https://github.com/go-gitea/gitea/releases/tag/v1.23.1
• https://github.com/go-gitea/gitea/releases/tag/v1.22.2
• https://github.com/go-gitea/gitea/releases/tag/v1.21.11
• https://github.com/go-gitea/gitea/releases/tag/v1.20.4
• https://github.com/go-gitea/gitea/releases/tag/v1.19.4
• https://github.com/go-gitea/gitea/releases/tag/v1.18.5
• https://github.com/go-gitea/gitea/releases/tag/v1.17.4

三、获取镜像

推荐从 https://hub.docker.com/r/easysoft/gitea 拉取构建好的官方Docker镜像。

bash
docker pull docker.xuanyuan.run/easysoft/gitea:latest

如需使用指定版本，可拉取包含版本标签的镜像，在Docker Hub仓库中查看 https://hub.docker.com/r/easysoft/gitea/tags/

bash
docker pull docker.xuanyuan.run/easysoft/gitea:[TAG]

四、持久化数据

删除容器会导致所有数据丢失，为避免数据丢失，需挂载卷进行持久化存储。需挂载的持久化目录：

• /data：持久化数据存储目录

若挂载目录为空，首次启动会自动初始化相关文件。

bash
$ docker run -it \
    -v $PWD/data:/data \
    easysoft/gitea:latest

或修改docker-compose.yml文件添加持久化配置：

yaml
services:
  gitea:
    ...
    volumes:
      - /path/to/persistence:/data
    ...

五、环境变量

六、运行

6.1 单机Docker-compose方式运行

bash
# 启动服务
make run

# 查看服务状态
make ps

# 查看服务日志
docker-compose logs -f gitea

说明:

• 启动成功后，打开浏览器输入 http://<你的IP>:8080 访问管理后台
• 默认用户名：gitea，默认密码：pass4Gitea
• https://github.com/quicklyon/gitea-docker/blob/main/VERSION 文件中详细定义了Makefile可操作的版本。
• https://github.com/quicklyon/gitea-docker/blob/main/docker-compose.yml

七、版本升级

容器镜像已为版本升级做特殊处理，当检测数据（数据库/持久化文件）版本与镜像内程序版本不一致时，会自动检查并升级数据库结构。因此，升级只需更换镜像版本号：

修改docker-compose.yml文件

diff
...
  gitea:
-    image: easysoft/gitea:1.17.0-20220729
+    image: easysoft/gitea:1.17.1-20220822
    container_name: gitea
...

更新服务：

bash
# 用新版本镜像更新服务
docker-compose up -d

# 查看服务状态和镜像版本
docker-compose ps