如何在Ubuntu安装Go语言编写的Git服务器Gogs，gitgogs


如何在Ubuntu安装Go语言编写的Git服务器Gogs

Gogs 是由 Go 语言编写的，自由开源的 Git 服务。Gogs 是一款无痛式自托管的 Git 服务器，能在尽可能小的硬件资源开销上搭建并运行您的私有 Git 服务器。Gogs 的网页界面和 GitHub 十分相近，且提供 MySQL、PostgreSQL 和 SQLite 数据库支持。

在本教程中，我们将使用 Gogs 在 Ununtu 16.04 上按步骤指导您安装和配置您的私有 Git 服务器。这篇教程中涵盖了如何在 Ubuntu 上安装 Go 语言、PostgreSQL 和安装并且配置 Nginx 网页服务器作为 Go 应用的反向代理的细节内容。

搭建环境

  • Ubuntu 16.04
  • Root 权限

我们将会接触到的事物

步骤 1 - 更新和升级系统

继续之前，更新 Ubuntu 所有的库，升级所有包。

apt
  1. sudo apt update
  2. sudo apt upgrade

步骤 2 - 安装和配置 PostgreSQL

Gogs 提供 MySQL、PostgreSQL、SQLite 和 TiDB 数据库系统支持。

此步骤中，我们将使用 PostgreSQL 作为 Gogs 程序的数据库。

apt
  1. sudo apt install -y postgresql postgresql-client libpq-dev

安装完成之后，启动 PostgreSQL 服务并设置为开机启动。

  1. systemctl start postgresql
  2. systemctl enable postgresql

此时 PostgreSQL 数据库在 Ubuntu 系统上完成安装了。

之后，我们需要为 Gogs 创建数据库和用户。

postgrespsql
  1. su - postgres
  2. psql
gitCREATEDB
  1. CREATE USER git CREATEDB;
  2. \password git
gogs_productiongit
  1. CREATE DATABASE gogs_production OWNER git;

创建 Gogs 数据库

创建 Gogs 数据库

gogs_productiongit

步骤 3 - 安装 Go 和 Git

apt
  1. sudo apt install git
git
  1. sudo adduser --disabled-login --gecos 'Gogs' git
gitlocal
  1. su - git
  2. mkdir -p /home/git/local
localwget
  1. cd ~/local
  2. wget https://dl.google.com/go/go1.9.2.linux-amd64.tar.gz

安装 Go 和 Git

安装 Go 和 Git

解压并且删除 go 的压缩文件。

  1. tar -xf go1.9.2.linux-amd64.tar.gz
  2. rm -f go1.9.2.linux-amd64.tar.gz
~/local/goGOROOTGOPATHgitgo

执行下方的命令。

  1. cd ~/
  2. echo 'export GOROOT=$HOME/local/go' >> $HOME/.bashrc
  3. echo 'export GOPATH=$HOME/go' >> $HOME/.bashrc
  4. echo 'export PATH=$PATH:$GOROOT/bin:$GOPATH/bin' >> $HOME/.bashrc
source ~/.bashrc
  1. source ~/.bashrc

确定您使用的 Bash 是默认的 shell。

安装 Go 编程语言

安装 Go 编程语言

go
  1. go version

之后确保您得到下图所示的结果。

检查 go 版本

检查 go 版本

git

步骤 4 - 使用 Gogs 安装 Git 服务

gitgo
  1. su - git
  2. go get -u github.com/gogits/gogs
GOPATH/src
$GOPATH/src/github.com/gogits/gogs
  1. cd $GOPATH/src/github.com/gogits/gogs
  2. go build

确保您没有遇到错误。

现在使用下面的命令运行 Gogs Go Git 服务器。

  1. ./gogs web

此命令将会默认运行 Gogs 在 3000 端口上。

安装 Gogs Go Git 服务

安装 Gogs Go Git 服务

打开网页浏览器，键入您的 IP 地址和端口号，我的是 http://192.168.33.10:3000/ 。

您应该会得到与下方一致的反馈。

Gogs 网页服务器

Gogs 网页服务器

Ctrl + C

步骤 5 - 配置 Gogs Go Git 服务器

本步骤中，我们将为 Gogs 创建惯例配置。

custom/conf
  1. cd $GOPATH/src/github.com/gogits/gogs
  2. mkdir -p custom/conf/
custom
  1. cp conf/app.ini custom/conf/app.ini
  2. vim custom/conf/app.ini
[server]HOST_ADDR127.0.0.1
  1. [server]
  2.  PROTOCOL = http
  3.  DOMAIN = localhost
  4.  ROOT_URL = %(PROTOCOL)s://%(DOMAIN)s:%(HTTP_PORT)s/
  5.  HTTP_ADDR = 127.0.0.1
  6.  HTTP_PORT = 3000
[database]
  1. [database]
  2.  DB_TYPE = postgres
  3.  HOST = 127.0.0.1:5432
  4.  NAME = gogs_production
  5.  USER = git
  6.  PASSWD = aqwe123@#

保存并退出。

运行下面的命令验证配置项。

  1. ./gogs web

并且确保您得到如下的结果。

配置服务器

配置服务器

localhost

步骤 6 - 运行 Gogs 服务器

/etc/systemd/systemgogs.service
/etc/systemd/systemgogs.service
  1. cd /etc/systemd/system
  2. vim gogs.service

粘贴下面的代码到 Gogs 服务器配置文件中。

  1. [Unit]
  2. Description=Gogs
  3. After=syslog.target
  4. After=network.target
  5. After=mariadb.service mysqld.service postgresql.service memcached.service redis.service
  6.  
  7. [Service]
  8. # Modify these two values and uncomment them if you have
  9. # repos with lots of files and get an HTTP error 500 because
  10. # of that
  11. ###
  12. #LimitMEMLOCK=infinity
  13. #LimitNOFILE=65535
  14. Type=simple
  15. User=git
  16. Group=git
  17. WorkingDirectory=/home/git/go/src/github.com/gogits/gogs
  18. ExecStart=/home/git/go/src/github.com/gogits/gogs/gogs web
  19. Restart=always
  20. Environment=USER=git HOME=/home/git
  21.  
  22. [Install]
  23. WantedBy=multi-user.target

之后保存并且退出。

现在可以重载系统服务器。

  1. systemctl daemon-reload

使用下面的命令开启 Gogs 服务器并设置为开机启动。

  1. systemctl start gogs
  2. systemctl enable gogs

运行 Gogs 服务器

运行 Gogs 服务器

Gogs 服务器现在已经运行在 Ubuntu 系统上了。

使用下面的命令检测：

  1. netstat -plntu
  2. systemctl status gogs

您应该会得到下图所示的结果。

Gogs is listening on the network interface

Gogs is listening on the network interface

步骤 7 - 为 Gogs 安装和配置 Nginx 反向代理

在本步中，我们将为 Gogs 安装和配置 Nginx 反向代理。我们会在自己的库中调用 Nginx 包。

使用下面的命令添加 Nginx 库。

  1. sudo add-apt-repository -y ppa:nginx/stable

此时更新所有的库并且使用下面的命令安装 Nginx。

  1. sudo apt update
  2. sudo apt install nginx -y
/etc/nginx/sites-availablegogs
  1. cd /etc/nginx/sites-available
  2. vim gogs

粘贴下面的代码到配置文件。

  1. server {
  2.      listen 80;
  3.      server_name git.hakase-labs.co;
  4.  
  5.      location / {
  6.          proxy_pass http://localhost:3000;
  7.      }
  8.  }

保存退出。

server_name

现在激活虚拟主机并且测试 nginx 配置。

  1. ln -s /etc/nginx/sites-available/gogs /etc/nginx/sites-enabled/
  2. nginx -t

确保没有遇到错误，重启 Nginx 服务器。

  1. systemctl restart nginx

安装和配置 Nginx 反向代理

安装和配置 Nginx 反向代理

步骤 8 - 测试

打开您的网页浏览器并且输入您的 Gogs URL，我的是 http://git.hakase-labs.co

现在您将进入安装界面。在页面的顶部，输入您所有的 PostgreSQL 数据库信息。

Gogs 安装

Gogs 安装

之后，滚动到底部，点击 “Admin account settings” 下拉选项。

输入您的管理者用户名和邮箱。

键入 gogs 安装设置

键入 gogs 安装设置

之后点击 “Install Gogs” 按钮。

然后您将会被重定向到下图显示的 Gogs 用户面板。

Gogs 面板

Gogs 面板

下面是 Gogs 的 “Admin Dashboard（管理员面板）”。

浏览 Gogs 面板

浏览 Gogs 面板

现在，Gogs 已经通过 PostgreSQL 数据库和 Nginx 网页服务器在您的 Ubuntu 16.04 上完成安装。