From 47f9a5d9d1f79dbd9198ecbbc6b4d2be7e7b257d Mon Sep 17 00:00:00 2001
From: ChenYi <31087327+cyleft@users.noreply.github.com>
Date: Sat, 24 Feb 2018 12:03:48 +0800
Subject: [PATCH] translated by cyleft

---
 ...nstall Gogs Go Git Service on Ubuntu 16.04 | 405 ++++++++++++++++++
 1 file changed, 405 insertions(+)
 create mode 100644 translated/tech/20180209 How to Install Gogs Go Git Service on Ubuntu 16.04

diff --git a/translated/tech/20180209 How to Install Gogs Go Git Service on Ubuntu 16.04 b/translated/tech/20180209 How to Install Gogs Go Git Service on Ubuntu 16.04
new file mode 100644
index 0000000000..6923c0e332
--- /dev/null
+++ b/translated/tech/20180209 How to Install Gogs Go Git Service on Ubuntu 16.04	
@@ -0,0 +1,405 @@
+如何在 Ubuntu 16.04 上使用 Gogs 安装 Go 语言编写的 Git 服务器
+======
+
+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. 更新和升级系统
+  2. 安装和配置 PostgreSQL
+  3. 安装 Go 和 Git
+  4. 安装 Gogs
+  5. 配置 Gogs
+  6. 运行 Gogs 服务器
+  7. 安装和配置 Nginx 反向代理
+  8. 测试
+
+### 步骤 1 - 更新和升级系统
+继续之前，更新 Ubuntu 所有的库，升级所有包。
+
+运行下面的 apt 命令
+```
+sudo apt update
+sudo apt upgrade
+```
+
+### 步骤 2 - 安装和配置 PostgreSQL
+
+Gogs 提供 MySQL、PostgreSQL、SQLite 和 TiDB 数据库系统支持。
+
+此步骤中，我们将使用 PostgreSQL 作为 Gogs 程序的数据库。
+
+使用下面的 apt 命令安装 PostgreSQL。
+```
+sudo apt install -y postgresql postgresql-client libpq-dev
+```
+
+安装完成之后，启动 PostgreSQL 服务并设置为开机启动。
+```
+systemctl start postgresql
+systemctl enable postgresql
+```
+
+此时 PostgreSQL 数据库在 Ubuntu 系统上完成安装了。
+
+之后，我们需要为 Gogs 创建数据库和用户。
+
+使用 'postgres' 用户登陆并运行 ‘psql’ 命令获取 PostgreSQL 操作界面.
+```
+su - postgres
+psql
+```
+
+创建一个名为 ‘git’ 的新用户，给予此用户 ‘CREATEDB’ 权限。
+```
+CREATE USER git CREATEDB;
+\password git
+```
+
+创建名为 ‘gogs_production’ 的数据库，设置 ‘git’ 用户作为其所有者。 
+```
+CREATE DATABASE gogs_production OWNER git;
+```
+
+[![创建 Gogs 数据库][1]][2]
+
+作为 Gogs 安装时的 ‘gogs_production’ PostgreSQL 数据库和 ‘git’ 用户已经创建完毕。
+
+### 步骤 3 - 安装 Go 和 Git
+
+使用下面的 apt 命令从库中安装 Git。
+```
+sudo apt install git
+```
+
+此时，为系统创建名为 ‘git’ 的新用户。
+```
+sudo adduser --disabled-login --gecos 'Gogs' git
+```
+
+登陆 ‘git’ 账户并且创建名为 ‘local’ 的目录。
+```
+su - git
+mkdir -p /home/git/local
+```
+
+切换到 ‘local’ 目录，依照下方所展示的内容，使用 wget 命令下载 ‘Go’（最新版）。
+```
+cd ~/local
+wget <https://dl.google.com/go/go1.9.2.linux-amd64.tar.gz>
+```
+
+[![安装 Go 和 Git][3]][4]
+
+解压并且删除 go 的压缩文件。
+```
+tar -xf go1.9.2.linux-amd64.tar.gz
+rm -f go1.9.2.linux-amd64.tar.gz
+```
+
+‘Go’ 二进制文件已经被下载到 ‘~/local/go’ 目录。此时我们需要设置环境变量 - 设置 ‘GOROOT’ 和 ‘GOPATH’ 目录到系统环境，这样，我们就可以在 ‘git’ 用户下执行 ‘go’ 命令。
+
+执行下方的命令。
+```
+cd ~/
+echo 'export GOROOT=$HOME/local/go' >> $HOME/.bashrc
+echo 'export GOPATH=$HOME/go' >> $HOME/.bashrc
+echo 'export PATH=$PATH:$GOROOT/bin:$GOPATH/bin' >> $HOME/.bashrc
+```
+
+之后通过运行 'source ~/.bashrc' 重载 Bash，如下：
+```
+source ~/.bashrc
+```
+
+确定您使用的 Bash 是默认的 shell。
+
+[![安装 Go 编程语言][5]][6]
+
+现在运行 'go' 的版本查看命令。
+```
+go version
+```
+
+之后确保您得到下图所示的结果。
+
+[![检查 go 版本][7]][8]
+
+现在，Go 已经安装在系统的 ‘git’ 用户下了。
+
+### 步骤 4 - 使用 Gogs 安装 Git 服务
+
+使用 ‘git’ 用户登陆并且使用 ‘go’ 命令从 GitHub 下载 ‘Gogs’。
+```
+su - git
+go get -u github.com/gogits/gogs
+```
+
+此命令将在 ‘GOPATH/src’ 目录下载 Gogs 的所有源代码。
+
+切换至 '$GOPATH/src/github.com/gogits/gogs' 目录，并且使用下列命令搭建 gogs。
+```
+cd $GOPATH/src/github.com/gogits/gogs
+go build
+```
+
+确保您没有捕获到错误。
+
+现在使用下面的命令运行 Gogs Go Git 服务器。
+```
+./gogs web
+```
+
+此命令将会默认运行 Gogs 在 3000 端口上。
+
+[![安装 Gogs Go Git 服务][9]][10]
+
+打开网页浏览器，键入您的 IP 地址和端口号，我的是<http://192.168.33.10:3000/>
+
+您应该会得到于下方一致的反馈。
+
+[![Gogs 网页服务器][11]][12]
+
+Gogs 已经在您的 Ubuntu 系统上安装完毕。现在返回到您的终端，并且键入 'Ctrl + c' 中止服务。
+
+### 步骤 5 - 配置 Gogs Go Git 服务器
+
+本步骤中，我们将为 Gogs 创建惯例配置。
+
+进入 Gogs 安装目录并新建 ‘custom/conf’ 目录。
+```
+cd $GOPATH/src/github.com/gogits/gogs
+mkdir -p custom/conf/
+```
+
+复制默认的配置文件到 custom 目录，并使用 [vim][13] 修改。
+```
+cp conf/app.ini custom/conf/app.ini
+vim custom/conf/app.ini
+```
+
+在 ‘ **[server]** ’ 选项中，修改 ‘HOST_ADDR’ 为 ‘127.0.0.1’.
+```
+[server]
+ PROTOCOL = http
+ DOMAIN = localhost
+ ROOT_URL = %(PROTOCOL)s://%(DOMAIN)s:%(HTTP_PORT)s/
+ HTTP_ADDR = 127.0.0.1
+ HTTP_PORT = 3000
+
+```
+
+在 ‘ **[database]** ’ 选项中，按照您的数据库信息修改。
+```
+[database]
+ DB_TYPE = postgres
+ HOST = 127.0.0.1:5432
+ NAME = gogs_production
+ USER = git
+ PASSWD = [email protected]#
+
+```
+
+保存并退出。
+
+运行下面的命令验证配置项。
+```
+./gogs web
+```
+
+并且确保您得到如下的结果。
+
+[![配置服务器][14]][15]
+
+Gogs 现在已经按照自定义配置下运行在 ‘localhost’ 的 3000 端口上了。
+
+### 步骤 6 - 运行 Gogs 服务器
+
+这一步，我们将在 Ubuntu 系统上配置 Gogs 服务器。我们会在 ‘/etc/systemd/system’ 目录下创建一个新的服务器配置文件 ‘gogs.service’。
+
+切换到 ‘/etc/systemd/system’ 目录，使用 [vim][13] 创建服务器配置文件 ‘gogs.service’。
+```
+cd /etc/systemd/system
+vim gogs.service
+```
+
+粘贴下面的代码到 gogs 服务器配置文件中。
+```
+[Unit]
+ Description=Gogs
+ After=syslog.target
+ After=network.target
+ After=mariadb.service mysqld.service postgresql.service memcached.service redis.service
+
+ [Service]
+ # Modify these two values and uncomment them if you have
+ # repos with lots of files and get an HTTP error 500 because
+ # of that
+ ###
+ #LimitMEMLOCK=infinity
+ #LimitNOFILE=65535
+ Type=simple
+ User=git
+ Group=git
+ WorkingDirectory=/home/git/go/src/github.com/gogits/gogs
+ ExecStart=/home/git/go/src/github.com/gogits/gogs/gogs web
+ Restart=always
+ Environment=USER=git HOME=/home/git
+
+ [Install]
+ WantedBy=multi-user.target
+
+```
+
+之后保存并且退出。
+
+现在可以重载系统服务器。
+```
+systemctl daemon-reload
+```
+
+使用下面的命令开启 gogs 服务器并设置为开机启动。
+```
+systemctl start gogs
+systemctl enable gogs
+```
+
+[![运行 Gogs 服务器][16]][17]
+
+Gogs 服务器现在已经运行在 Ubuntu 系统上了。
+
+使用下面的命令检测：
+```
+netstat -plntu
+systemctl status gogs
+```
+
+您应该会得到下图所示的结果。
+
+[![Gogs is listening on the network interface][18]][19]
+
+### 步骤 7 - 为 Gogs 安装和配置 Nginx 反向代理
+
+在本步中，我们将为 Gogs 安装和配置 Nginx 反向代理。我们会在自己的库中调用 Nginx 包。
+
+使用下面的命令添加 Nginx 库。
+```
+sudo add-apt-repository -y ppa:nginx/stable
+```
+
+此时更新所有的库并且使用下面的命令安装 Nginx。
+```
+sudo apt update
+sudo apt install nginx -y
+```
+
+之后，进入 ‘/etc/nginx/sites-available’ 目录并且创建虚拟主机文件 ‘gogs’。
+```
+cd /etc/nginx/sites-available
+vim gogs
+```
+
+粘贴下面的代码到配置项。
+```
+server {
+     listen 80;
+     server_name git.hakase-labs.co;
+
+     location / {
+         proxy_pass http://localhost:3000;
+     }
+ }
+
+```
+
+保存退出。
+
+**注意:**
+使用您的域名修改 ‘server_name’ 项。
+
+现在激活虚拟主机并且测试 nginx 配置。
+```
+ln -s /etc/nginx/sites-available/gogs /etc/nginx/sites-enabled/
+nginx -t
+```
+
+确保没有抛错，重启 Nginx 服务器。
+```
+systemctl restart nginx
+```
+
+[![安装和配置 Nginx 反向代理][20]][21]
+
+### 步骤 8 - 测试
+
+打开您的网页浏览器并且输入您的 gogs URL，我的是 <http://git.hakase-labs.co>
+
+现在您将进入安装界面。在页面的顶部，输入您所有的 PostgreSQL 数据库信息。
+
+[![Gogs 安装][22]][23]
+
+之后，滚动到底部，点击 ‘Admin account settings’ 下拉选项。
+
+输入您的管理者用户名和邮箱。
+
+[![键入 gogs 安装设置][24]][25]
+
+之后点击 ‘Install Gogs’ 按钮。
+
+然后您将会被重定向到下图显示的 Gogs 用户面板。
+
+[![Gogs 面板][26]][27]
+
+下面是 Gogs ‘Admin Dashboard（管理员面板）’。
+
+[![浏览 Gogs 面板][28]][29]
+
+现在，Gogs 已经通过 PostgreSQL 数据库和 Nginx 网页服务器在您的 Ubuntu 16.04 上完成安装。
+
+--------------------------------------------------------------------------------
+
+via: https://www.howtoforge.com/tutorial/how-to-install-gogs-go-git-service-on-ubuntu-1604/
+
+作者：[Muhammad Arul][a]
+译者：[CYLeft](https://github.com/CYLeft)
+校对：[校对者ID](https://github.com/校对者ID)
+
+本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出
+
+[a]: https://www.howtoforge.com/tutorial/server-monitoring-with-shinken-on-ubuntu-16-04/
+[1]:https://www.howtoforge.com/images/how_to_install_gogs_go_git_service_on_ubuntu_1604/1.png
+[2]:https://www.howtoforge.com/images/how_to_install_gogs_go_git_service_on_ubuntu_1604/big/1.png
+[3]:https://www.howtoforge.com/images/how_to_install_gogs_go_git_service_on_ubuntu_1604/2.png
+[4]:https://www.howtoforge.com/images/how_to_install_gogs_go_git_service_on_ubuntu_1604/big/2.png
+[5]:https://www.howtoforge.com/images/how_to_install_gogs_go_git_service_on_ubuntu_1604/3.png
+[6]:https://www.howtoforge.com/images/how_to_install_gogs_go_git_service_on_ubuntu_1604/big/3.png
+[7]:https://www.howtoforge.com/images/how_to_install_gogs_go_git_service_on_ubuntu_1604/4.png
+[8]:https://www.howtoforge.com/images/how_to_install_gogs_go_git_service_on_ubuntu_1604/big/4.png
+[9]:https://www.howtoforge.com/images/how_to_install_gogs_go_git_service_on_ubuntu_1604/5.png
+[10]:https://www.howtoforge.com/images/how_to_install_gogs_go_git_service_on_ubuntu_1604/big/5.png
+[11]:https://www.howtoforge.com/images/how_to_install_gogs_go_git_service_on_ubuntu_1604/6.png
+[12]:https://www.howtoforge.com/images/how_to_install_gogs_go_git_service_on_ubuntu_1604/big/6.png
+[13]:https://www.howtoforge.com/vim-basics
+[14]:https://www.howtoforge.com/images/how_to_install_gogs_go_git_service_on_ubuntu_1604/7.png
+[15]:https://www.howtoforge.com/images/how_to_install_gogs_go_git_service_on_ubuntu_1604/big/7.png
+[16]:https://www.howtoforge.com/images/how_to_install_gogs_go_git_service_on_ubuntu_1604/8.png
+[17]:https://www.howtoforge.com/images/how_to_install_gogs_go_git_service_on_ubuntu_1604/big/8.png
+[18]:https://www.howtoforge.com/images/how_to_install_gogs_go_git_service_on_ubuntu_1604/9.png
+[19]:https://www.howtoforge.com/images/how_to_install_gogs_go_git_service_on_ubuntu_1604/big/9.png
+[20]:https://www.howtoforge.com/images/how_to_install_gogs_go_git_service_on_ubuntu_1604/10.png
+[21]:https://www.howtoforge.com/images/how_to_install_gogs_go_git_service_on_ubuntu_1604/big/10.png
+[22]:https://www.howtoforge.com/images/how_to_install_gogs_go_git_service_on_ubuntu_1604/11.png
+[23]:https://www.howtoforge.com/images/how_to_install_gogs_go_git_service_on_ubuntu_1604/big/11.png
+[24]:https://www.howtoforge.com/images/how_to_install_gogs_go_git_service_on_ubuntu_1604/12.png
+[25]:https://www.howtoforge.com/images/how_to_install_gogs_go_git_service_on_ubuntu_1604/big/12.png
+[26]:https://www.howtoforge.com/images/how_to_install_gogs_go_git_service_on_ubuntu_1604/13.png
+[27]:https://www.howtoforge.com/images/how_to_install_gogs_go_git_service_on_ubuntu_1604/big/13.png
+[28]:https://www.howtoforge.com/images/how_to_install_gogs_go_git_service_on_ubuntu_1604/14.png
+[29]:https://www.howtoforge.com/images/how_to_install_gogs_go_git_service_on_ubuntu_1604/big/14.png