一起玩树莓派3+使用Gogs搭建Git 服务

x1816

一起玩树莓派3+使用Gogs搭建Git 服务 [复制链接]

项目首页：https://gogs.io
下载页：https://gogs.io/docs/installation/install_from_binary
下载地址：https://dl.gogs.io/gogs_v0.9.97_raspi2.zip
安装
gogs使用go语言编写，树莓派官方系统Raspbian上已经具备了基本的运行环境，官网也提供了适用于Raspberry Pi的二进制版本，因此安装相对比较简单。
把gogs_v0.9.97_raspi2.zip上传到树莓派的目录中
解压缩

1. unzip gogs_v0.9.97_raspi2.zip

复制代码

找到可执行文件：

1. cd gogs

复制代码

先运行试试

1. ./gogs

复制代码

输出简短的帮助：

开启服务器：

1. ./gogs web

复制代码

有一个警告提示，自定义的配置文件app.ini没有找到。没有关系，接下来的自助安装过程会生成配置文件。
在和树莓派同一个网段的PC上用浏览器访问树莓派的IP，端口为3000。

1. 192.168.1.66:3000

复制代码

会出现首次运行安装程序的页面，配置如下：

gogs支持MySQL、PostgreSQL，SQLite3和TiDB，树莓派上运行的轻量级服务，使用SQLite3就行了，这样这个数据库在pi上就是一个db文件。

应用基本设置主要是一些必须初始化的配置，根据需要修改。

可选设置如果不是很清楚含义，可以参考我的设置进行，由于是小规模使用，邮件服务没有配置，这里留空。
管理员用户要创建一个，密码要牢记。
最后点击“立即安装”按钮。
等待一会，会跳转到控制面板：

这就表明安装成功了。

如果出现错误，也会有提示，根据提示修改即可。
注意这个是管理员用户，一般建议仅用于管理普通用户，不用它来直接进行代码托管。
也就是管理员用户管理普通用户，普通用户登录该系统进行代码托管。


在网页右上角的菜单中，选择“管理面板”，这个界面是只有管理员才有的。
在用户管理里，添加一个普通新用户：

可以看到用户已经添加好了：

在界面右上角退出管理员用户，用普通用户登录。就可以进行日常的代码托管操作了。
比如这是创建新仓库的界面：

增加新的SSH密钥：

gogs有比较明确的中文提示，这里对于日常的Git使用就先不展开了。


保持gogs服务自动启动
把服务脚本复制到系统目录：

1. sudo cp ~/gogs/scripts/systemd/gogs.service /etc/systemd/system

复制代码

修改：

1. sudo vim /etc/systemd/system/gogs.service

复制代码

注意红框内的内容，默认用户和路径都是git，这里改成pi。
设置开机自启动gogs：

1. sudo systemctl enable gogs

复制代码

立即启动gogs：

1. sudo systemctl start gogs

复制代码

查看实时日志输出：

1. sudo systemctl status gogs

复制代码

附我的配置文件样例，注意有些配置是系统自己生成的，不要直接照搬复制过去。
文件路径：

1. gogs/custom/conf/app.ini

复制代码

1. APP_NAME = 树莓派3上的gogs
   
2. RUN_USER = pi
   
3. RUN_MODE = prod
   
4. 
   
5. [database]
   
6. DB_TYPE  = sqlite3
   
7. HOST     = 127.0.0.1:3306
   
8. NAME     = gogs
   
9. USER     = root
   
10. PASSWD   =
    
11. SSL_MODE = disable
    
12. PATH     = data/gogs.db
    
13. 
    
14. [repository]
    
15. ROOT = /home/pi/gogs-repositories
    
16. 
    
17. [server]
    
18. DOMAIN       = 192.168.1.66
    
19. HTTP_PORT    = 3000
    
20. ROOT_URL     = http://192.168.1.66:3000/
    
21. DISABLE_SSH  = false
    
22. SSH_PORT     = 22
    
23. OFFLINE_MODE = false
    
24. 
    
25. [mailer]
    
26. ENABLED = false
    
27. 
    
28. [service]
    
29. REGISTER_EMAIL_CONFIRM = false
    
30. ENABLE_NOTIFY_MAIL     = false
    
31. DISABLE_REGISTRATION   = false
    
32. ENABLE_CAPTCHA         = true
    
33. REQUIRE_SIGNIN_VIEW    = false
    
34. 
    
35. [picture]
    
36. DISABLE_GRAVATAR        = true
    
37. ENABLE_FEDERATED_AVATAR = false
    
38. 
    
39. [session]
    
40. PROVIDER = file
    
41. 
    
42. [log]
    
43. MODE      = file
    
44. LEVEL     = Info
    
45. ROOT_PATH = /home/pi/gogs/log
    
46. 
    
47. [security]
    
48. INSTALL_LOCK = true
    
49. SECRET_KEY   = 8o6NtFSHz34xsIB
    

复制代码

参考
le062. 在Raspberry Pi 3上搭建高可用Git Server
https://bbs.eeworld.com.cn/thread-488736-1-1.html
另外在后续使用Git服务的时候，往往关于SSH密钥的问题比较多，这里给出Github官方的文档，不同的Git 服务这项功能都是类似的。
https://help.github.com/categories/ssh/

x1816

下期预告：gogs的优点是部署简单，比较轻量级。下期再介绍另一种重量级的Git服务方案，功能上会更加专业。

okhxyyo

x1816 发表于 2016-11-2 08:47
下期预告：gogs的优点是部署简单，比较轻量级。下期再介绍另一种重量级的Git服务方案，功能上会更加专业。

好期待！！(☆▽☆)

shinykongcn

楼主产量真高啊，竟然还用上web管理了，高级，看起来有点github的风格啊

yang_alex

楼主大作不断啊，搬小板凳好好学习。轻量级的Git服务方案和重量级的Git服务方案相比较，都增加了哪些功能？这些功能都有什么好处?谢谢了！

houbangyi

嗨嗨嗨嗨嗨