Docker系列——利用gogs搭建属于本身的git服务

gogs简介

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

功能特性

• 支持活动时间线
• 支持 SSH 以及 HTTP/HTTPS 协议
• 支持 SMTP、LDAP 和反向代理的用户认证
• 支持反向代理子路径
• 支持用户、组织和仓库管理系统
• 支持添加和删除仓库协做者
• 支持仓库和组织级别 Web 钩子（包括 Slack 集成）
• 支持仓库 Git 钩子和部署密钥
• 支持仓库工单（Issue）、合并请求（Pull Request）、Wiki 以及保护分支
• 支持迁移和镜像仓库以及它的 Wiki
• 支持在线编辑仓库文件和 Wiki
• 支持自定义源的 Gravatar 和 Federated Avatar
• 支持 Jupyter Notebook
• 支持邮件服务
• 支持后台管理面板
• 支持 MySQL、PostgreSQL、SQLite三、MSSQL 和 TiDB（实验性支持） 数据库
• 支持多语言本地化（22 种语言）

部署环境

拉取镜像

经过docker命令拉取gogs镜像

使用命令操做以下：

docker pull gogs/gogs

命令行操做以下所示：

新建gogs目录

在/home/software下新建文件夹gogs

• 进入/home/software路径下新建，命令以下：

mkdir gogs

• 在根目录下直接新建，命令以下：

mkdir home/software/gogs

• 建立多级目录，命令以下：

mkdir -p software/gogs

开放服务器端口

配置端口在服务器的安全组中进行配置，开放的端口，用于gogs/docker服务端口进行映射。

启动服务

启动服务命令以下：

docker run --name=gogs -p 8234:22 -p 8235:3000 -v /home/software/gogs:/data gogs/gogs

参数说明:

• -p: 端口映射,将容器的22端口映射到宿主机的1006端口,将容器的3000端口映射到宿主机的1007端口
• -name: 指定容器名称
• -net: 将容器加入backend网络,目的是为了可以链接backend网络中的mysql数据库
• -v: 数据卷挂载, 用于将容器和数据分离

启动操做以下所示：

安装配置

经过地址访问，格式为：http://服务器ip+映射端口/install，
如：http://101.111.22.31:8235/install，
访问进入以下页面，进行配置数据：

1. 配置数据库
   数据库类型选择为SQLite3，免配置，直接使用。
   

2. 基本信息配置
   基本信息中，配置信息以下所示：
   
   

• 应用名称：支持自定义，可维护成本身的专属名称
• 仓库根目录：默认便可
• 运行系统用户：也默认便可
• 域名：服务器的公网地址，如：http://101.111.22.31
• SSH端口号：服务器的映射端口，如：8234
• HTTP端口：监听端口默认为3000
• 应用URL：公网地址+映射端口，如：http://101.111.22.31:8235
• 日志路径：默认便可

3. 可选配置
   可选配置，看我的所需，其余暂时不配置，配置管理员帐号便可。

gogs使用

配置完成后，访问地址，进入到登陆页，以下所示：

注册&登陆

在以前配置基础信息时，没配置管理员帐号的话，在登陆页，注册个帐号即可以登陆；若是有配置管理员帐号，使用配置的帐号直接登陆便可。注册页面以下：

控制面板

控制面板界面以下所示：

• 左侧：我的的操做记录，好比：提交代码，建立合并请求，请求关闭...
• 右侧：个人仓库：属于本身的仓库，拥有管理权限
• 右侧：参与协做的仓库：参与的仓库，没有全部权，权限按仓库所属人进行分配

仓库管理

仓库管理界面以下所示：

在该页面，能够操做以下设置：

• 基本设置，可配置仓库名称、可见性等
• 管理协做者，添加仓库的协做者，一块儿维护仓库内容
• 管理分支，配置默认分支和保护分支
• 管理Web钩子，Gogs上发生指定事件时对指定 URL 发送 POST 通知
• 管理Git钩子
• 管理部署密钥
• 转移仓库全部权

工单管理

工单管理界面以下所示：

在该页面，能够查看本身的以及指派给本身的工单，也能够查看工单状态，便捷管理。

合并请求

合并请求界面以下所示：

在该页面，能够查看合并请求的状态。

建立仓库

建立仓库界面以下所示：

点击面板中的+号，选择建立仓库，便可进入到该页面。具体建立本身操做一波就能够了，很简单。

代码操做

• 克隆代码
  使用以下命令操做：

git clone http://101.111.22.31:8235/yihuqingjiu/Auto_Test.git

截图以下：

• 提交代码
  提交代码的操做，能够祥见这篇博文：Git基本操做命令合集，这里就不赘述了。提交代码后，能够在面板中查看，以下所示：
  

问题总结

1. 配置gogs基础信息时，想使用本地的Mysql数据库，但一直提示权限错误，没能解决，最终仍是使用了免配置的sqlite3。

2. 想使用ssh方式拉取代码，在服务器端，生成的公钥，一直提示失败，也没能解决，报错提示信息：invalid key format: illegal base64 data at input byte 171。

以上就是今天分享的内容，若有博友遇到如上2个问题，望告知一二，祝你们双节快乐。