easysoft/gogs repository overview

⁠QuickOn Gogs 应用镜像

⁠快速参考

• 通过 渠成软件百宝箱⁠ 一键安装 Gogs
• Dockerfile 源码⁠
• Gogs 源码⁠
• Gogs 官网⁠

⁠一、关于 Gogs

Gogs 的目标是打造一个最简单、最快速和最轻松的方式搭建自助 Git 服务。使用 Go 语言开发使得 Gogs 能够通过独立的二进制分发，并且支持 Go 语言支持的 所有平台，包括 Linux、Mac OS X、Windows 以及 ARM 平台。

Gogs官网：https://gogs.io⁠

⁠1.1 开源组件

• Web 框架：Macaron⁠
• UI 组件：
  • Semantic UI⁠
  • GitHub Octicons⁠
  • Font Awesome⁠
• 前端插件：
  • DropzoneJS⁠
  • highlight.js⁠
  • clipboard.js⁠
  • emojify.js⁠
  • jQuery Date Time Picker⁠
  • jQuery MiniColors⁠
  • CodeMirror⁠
  • notebook.js⁠
  • marked⁠
• ORM：Xorm⁠
• 数据库驱动：
  • github.com/go-sql-driver/mysql⁠
  • github.com/lib/pq⁠
  • github.com/mattn/go-sqlite3⁠
  • github.com/denisenkom/go-mssqldb⁠
• 以及其它所有 Go 语言的第三方包依赖。

⁠二、支持的版本(Tag)

由于版本比较多,这里只列出最新的5个版本,更详细的版本列表请参考:可用版本列表⁠

• latest⁠
• 0.13.0-20230316⁠
• 0.12.10-20230221⁠
• 0.12.9⁠
• 0.12.8⁠

⁠三、获取镜像

推荐从 Docker Hub Registry⁠ 拉取我们构建好的官方Docker镜像。

docker pull easysoft/gogs:latest

如需使用指定的版本，可以拉取一个包含版本标签的镜像，在Docker Hub仓库中查看 可用版本列表⁠

docker pull easysoft/gogs:[TAG]

⁠四、持久化数据

如果你删除容器，所有的数据都将被删除，下次运行镜像时会重新初始化数据。为了避免数据丢失，你应该为容器提供一个挂在卷，这样可以将数据进行持久化存储。

为了数据持久化，你应该挂载持久化目录：

• /data 持久化数据

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

$ docker run -it \
    -v $PWD/data:/data \
docker pull easysoft/gogs:latest

或者修改 docker-compose.yml 文件，添加持久化目录配置

services:
  Gogs:
  ...
    volumes:
      - /path/to/persistence:/data
  ...

⁠五、环境变量

⁠六、运行

⁠6.1 单机Docker-compose方式运行

# 启动服务
make run

# 查看服务状态
make ps

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

• VERSION⁠ 文件中详细的定义了Makefile可以操作的版本。
• docker-compose.yml⁠。