在2016年-2019年，SkywenCode技术团队使用码云Gitee 作为线上代码库管理，基于敏捷开发和持续构建的思路，我们整体基础建设以Drone / Jenkins + Docker 的方式构建和部署整个基础建设体系。

在接下来的时间里，SkywenCode技术团队基础建设系列会基于每一步的进展和采坑推出相应的教程，用于团队的经验总结回顾，以及分享和开放给有需要的团队或个人参考。

本篇主要介绍01 Gitea Docker 安装部署。

01

安装教程

Docker 安装部署

这里推荐用Daocloud 平台做镜像加速，或者其他加速平台，Docker 安装不做教程说明，默认以docker和docker composer安装好开始下一步。

Gitea Docker Compose 配置文件注释和说明

从gitea官方文档，docker安装途径copy而来。

Docker Gitea部署步骤

1、在合适的位置创建文件夹，将其作为网站部署【本教程安装测试于windows环境下】

具体，如下截图：

当前部署的根目录为http://gitea.hiwilliam.cn，目录下仅有docker-compose.yml，内容为上面的compose文件配置。

2、

dockers会自动根据compose 文件拉去所需要的镜像，例如本次教程的gitea本体镜像和依赖的mysql镜像。

【如果要停止拉取，快捷键ctrl+c】

部署完成：

docker-compose ps 检查服务运行状态：

3、确认服务处于up状态下，浏览器访问 host:3000，或者配置好的域名，出现如下页面，说明gitea本地部署已完成，服务器部署过程相同。

02

相关配置

Gitea 初始配置

1、点击登录、注册或者探索皆可，跳转到初始配置表单页面。

配置表单的数据库配置因为我们在compose 文件中都已设置好初始变量，所以这里不用做任何更改。尤其数据库的类型和主机因为docker 启动容器服务绑定的，改为其他值反而会出错。

2、下面的一般设置主要是关于gitea仓库的站点相关信息。

a. 站点名称根据自己喜好设置，而仓库根目录，LFS根目录，以用户名运行请保持默认不要改动。原因和数据库类型一样在服务部署时就已绑定。

b. ssh服务域名如果本地构建就保持默认，如果线上服务器则改为服务器公网ip地址，ssh服务端口请和compose文件中保持一致，

c. http服务端口也和compose文件保持一致。基本url如果本地默认或者设置好并绑定的虚拟域名，线上填写解析过的一个域名。

d. 总结：所有端口和目录相关配置请保持默认。

Gitea 可选配置

• 电子邮箱配置

主要是设置用gitea仓库内容邮箱发送的基础配置，如若不用，可忽略。

• 服务设置

主要是针对gitea仓库站点的相关设置，如访问限制等。

• 管理员账号设置

为gitea仓库添加一个管理，不设置的话则默认第一个注册的账号为管理员账号。

至此，gitea相关配置完成，点击立即安装，即可完成安装。

Gitea 更多配置说明

除了安装过程的表单设置，我们还可以修改gitea的配置文件来修改gitea服务。具体地址：

1、进入上面的路径的conf文件，复制app.ini文件,做好备份，万一玩崩了还能回来。至于可配置依旧是那个原则，凡是【目录和端口】的配置修改都要谨慎，尽量不要修改！这里贴出部分常用配置：

2、执行docker-compose restart重启服务

这里注意：有时dockerc-compose构建目录有环境变量【.env文件】，所以最好是在项目的根目录执行docker-compose命令 ，例如本次部署http://gitea.hiwilliam.cn为根目录。当然本次过程没有使用变量所以就无所谓了，只要不跳出根目录。

03

教程总结

gitea的docker部署方式非常便捷，官方文档说明也非常详细，选择很多样，只要对docker的有基本的认知和了解都可以轻易上手。如果在部署途中失败或者其他问题，可以通过以下命令来解决。

当然，仅仅简单如此部署是不适合生产的。尤其数据的存放，不仅仅是gitea容器映射的数据卷，还有gitea服务依赖的db服务-MySQL，为此可以考虑使用定时备份gitea映射的数据卷到oss，以及将本地依赖的db服务改为RDS。

除此之外如何将代码从旧的git仓库迁移到新部署的gitea仓库也是需要我们考虑实现的。

作者 / HiWilliam

排版 / 大野鱼头