diff --git a/translated/tech/20180209 How to Install Gogs Go Git Service on Ubuntu 16.04.md b/translated/tech/20180209 How to Install Gogs Go Git Service on Ubuntu 16.04.md index 6923c0e332..52c5c59dc7 100644 --- a/translated/tech/20180209 How to Install Gogs Go Git Service on Ubuntu 16.04.md +++ b/translated/tech/20180209 How to Install Gogs Go Git Service on Ubuntu 16.04.md @@ -1,9 +1,9 @@ -如何在 Ubuntu 16.04 上使用 Gogs 安装 Go 语言编写的 Git 服务器 +如何在 Ubuntu 安装 Go 语言编写的 Git 服务器 Gogs ====== -Gogs 是由 Go 语言编写，提供开源且免费的 Git 服务。Gogs 是一款无痛式自托管的 Git 服务器，能在尽可能小的硬件资源开销上搭建并运行您的私有 Git 服务器。Gogs 的网页界面和 GitHub 十分相近，且提供 MySQL、PostgreSQL 和 SQLite 数据库支持。 +Gogs 是由 Go 语言编写的，自由开源的 Git 服务。Gogs 是一款无痛式自托管的 Git 服务器，能在尽可能小的硬件资源开销上搭建并运行您的私有 Git 服务器。Gogs 的网页界面和 GitHub 十分相近，且提供 MySQL、PostgreSQL 和 SQLite 数据库支持。 -在本教程中，我们将使用 Gogs 在 Ununtu 16.04 上按步骤，指导您安装和配置您的私有 Git 服务器。这篇教程中涵盖了如何在 Ubuntu 上安装 Go 语言、PostgreSQL 和安装并且配置 Nginx 网页服务器作为 Go 应用的反向代理的细节内容。 +在本教程中，我们将使用 Gogs 在 Ununtu 16.04 上按步骤指导您安装和配置您的私有 Git 服务器。这篇教程中涵盖了如何在 Ubuntu 上安装 Go 语言、PostgreSQL 和安装并且配置 Nginx 网页服务器作为 Go 应用的反向代理的细节内容。 ### 搭建环境 @@ -22,9 +22,11 @@ Gogs 是由 Go 语言编写，提供开源且免费的 Git 服务。Gogs 是一 8. 测试 ### 步骤 1 - 更新和升级系统 + 继续之前，更新 Ubuntu 所有的库，升级所有包。 -运行下面的 apt 命令 +运行下面的 `apt` 命令： + ``` sudo apt update sudo apt upgrade @@ -36,12 +38,14 @@ Gogs 提供 MySQL、PostgreSQL、SQLite 和 TiDB 数据库系统支持。 此步骤中，我们将使用 PostgreSQL 作为 Gogs 程序的数据库。 -使用下面的 apt 命令安装 PostgreSQL。 +使用下面的 `apt` 命令安装 PostgreSQL。 + ``` sudo apt install -y postgresql postgresql-client libpq-dev ``` 安装完成之后，启动 PostgreSQL 服务并设置为开机启动。 + ``` systemctl start postgresql systemctl enable postgresql @@ -51,62 +55,71 @@ systemctl enable postgresql 之后，我们需要为 Gogs 创建数据库和用户。 -使用 'postgres' 用户登陆并运行 ‘psql’ 命令获取 PostgreSQL 操作界面. +使用 `postgres` 用户登录并运行 `psql` 命令以访问 PostgreSQL 操作界面。 + ``` su - postgres psql ``` -创建一个名为 ‘git’ 的新用户，给予此用户 ‘CREATEDB’ 权限。 +创建一个名为 `git` 的新用户，给予此用户 `CREATEDB` 权限。 + ``` CREATE USER git CREATEDB; \password git ``` -创建名为 ‘gogs_production’ 的数据库，设置 ‘git’ 用户作为其所有者。 +创建名为 `gogs_production` 的数据库，设置 `git` 用户作为其所有者。 + ``` CREATE DATABASE gogs_production OWNER git; ``` [![创建 Gogs 数据库][1]][2] -作为 Gogs 安装时的 ‘gogs_production’ PostgreSQL 数据库和 ‘git’ 用户已经创建完毕。 +用于 Gogs 的 `gogs_production` PostgreSQL 数据库和 `git` 用户已经创建完毕。 ### 步骤 3 - 安装 Go 和 Git -使用下面的 apt 命令从库中安装 Git。 +使用下面的 `apt` 命令从库中安装 Git。 + ``` sudo apt install git ``` -此时，为系统创建名为 ‘git’ 的新用户。 +此时，为系统创建名为 `git` 的新用户。 + ``` sudo adduser --disabled-login --gecos 'Gogs' git ``` -登陆 ‘git’ 账户并且创建名为 ‘local’ 的目录。 +登录 `git` 账户并且创建名为 `local` 的目录。 + ``` su - git mkdir -p /home/git/local ``` -切换到 ‘local’ 目录，依照下方所展示的内容，使用 wget 命令下载 ‘Go’（最新版）。 +切换到 `local` 目录，依照下方所展示的内容，使用 `wget` 命令下载 Go（最新版）。 + ``` cd ~/local -wget +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’ 命令。 +Go 二进制文件已经被下载到 `~/local/go` 目录。此时我们需要设置环境变量 - 设置 `GOROOT` 和 `GOPATH` 目录到系统环境，这样，我们就可以在 `git` 用户下执行 `go` 命令。 执行下方的命令。 + ``` cd ~/ echo 'export GOROOT=$HOME/local/go' >> $HOME/.bashrc @@ -114,7 +127,8 @@ echo 'export GOPATH=$HOME/go' >> $HOME/.bashrc echo 'export PATH=$PATH:$GOROOT/bin:$GOPATH/bin' >> $HOME/.bashrc ``` -之后通过运行 'source ~/.bashrc' 重载 Bash，如下： +之后通过运行 `source ~/.bashrc` 重载 Bash，如下： + ``` source ~/.bashrc ``` @@ -123,7 +137,8 @@ source ~/.bashrc [![安装 Go 编程语言][5]][6] -现在运行 'go' 的版本查看命令。 +现在运行 `go` 的版本查看命令。 + ``` go version ``` @@ -132,27 +147,30 @@ go version [![检查 go 版本][7]][8] -现在，Go 已经安装在系统的 ‘git’ 用户下了。 +现在，Go 已经安装在系统的 `git` 用户下了。 ### 步骤 4 - 使用 Gogs 安装 Git 服务 -使用 ‘git’ 用户登陆并且使用 ‘go’ 命令从 GitHub 下载 ‘Gogs’。 +使用 `git` 用户登录并且使用 `go` 命令从 GitHub 下载 Gogs。 + ``` su - git go get -u github.com/gogits/gogs ``` -此命令将在 ‘GOPATH/src’ 目录下载 Gogs 的所有源代码。 +此命令将在 `GOPATH/src` 目录下载 Gogs 的所有源代码。 + +切换至 `$GOPATH/src/github.com/gogits/gogs` 目录，并且使用下列命令搭建 Gogs。 -切换至 '$GOPATH/src/github.com/gogits/gogs' 目录，并且使用下列命令搭建 gogs。 ``` cd $GOPATH/src/github.com/gogits/gogs go build ``` -确保您没有捕获到错误。 +确保您没有遇到错误。 现在使用下面的命令运行 Gogs Go Git 服务器。 + ``` ./gogs web ``` @@ -161,31 +179,34 @@ go build [![安装 Gogs Go Git 服务][9]][10] -打开网页浏览器，键入您的 IP 地址和端口号，我的是 +打开网页浏览器，键入您的 IP 地址和端口号，我的是 http://192.168.33.10:3000/ 。 -您应该会得到于下方一致的反馈。 +您应该会得到与下方一致的反馈。 [![Gogs 网页服务器][11]][12] -Gogs 已经在您的 Ubuntu 系统上安装完毕。现在返回到您的终端，并且键入 'Ctrl + c' 中止服务。 +Gogs 已经在您的 Ubuntu 系统上安装完毕。现在返回到您的终端，并且键入 `Ctrl + C` 中止服务。 ### 步骤 5 - 配置 Gogs Go Git 服务器 本步骤中，我们将为 Gogs 创建惯例配置。 -进入 Gogs 安装目录并新建 ‘custom/conf’ 目录。 +进入 Gogs 安装目录并新建 `custom/conf` 目录。 + ``` cd $GOPATH/src/github.com/gogits/gogs mkdir -p custom/conf/ ``` -复制默认的配置文件到 custom 目录，并使用 [vim][13] 修改。 +复制默认的配置文件到 `custom` 目录，并使用 [vim][13] 修改。 + ``` cp conf/app.ini custom/conf/app.ini vim custom/conf/app.ini ``` -在 ‘ **[server]** ’ 选项中，修改 ‘HOST_ADDR’ 为 ‘127.0.0.1’. +在 `[server]` 小节中，修改 `HOST_ADDR` 为 `127.0.0.1`。 + ``` [server] PROTOCOL = http @@ -193,23 +214,23 @@ vim custom/conf/app.ini ROOT_URL = %(PROTOCOL)s://%(DOMAIN)s:%(HTTP_PORT)s/ HTTP_ADDR = 127.0.0.1 HTTP_PORT = 3000 - ``` -在 ‘ **[database]** ’ 选项中，按照您的数据库信息修改。 +在 `[database]` 选项中，按照您的数据库信息修改。 + ``` [database] DB_TYPE = postgres HOST = 127.0.0.1:5432 NAME = gogs_production USER = git - PASSWD = [email protected]# - + PASSWD = aqwe123@# ``` 保存并退出。 运行下面的命令验证配置项。 + ``` ./gogs web ``` @@ -218,54 +239,57 @@ vim custom/conf/app.ini [![配置服务器][14]][15] -Gogs 现在已经按照自定义配置下运行在 ‘localhost’ 的 3000 端口上了。 +Gogs 现在已经按照自定义配置下运行在 `localhost` 的 3000 端口上了。 ### 步骤 6 - 运行 Gogs 服务器 -这一步，我们将在 Ubuntu 系统上配置 Gogs 服务器。我们会在 ‘/etc/systemd/system’ 目录下创建一个新的服务器配置文件 ‘gogs.service’。 +这一步，我们将在 Ubuntu 系统上配置 Gogs 服务器。我们会在 `/etc/systemd/system` 目录下创建一个新的服务器配置文件 `gogs.service`。 + +切换到 `/etc/systemd/system` 目录，使用 [vim][13] 创建服务器配置文件 `gogs.service`。 -切换到 ‘/etc/systemd/system’ 目录，使用 [vim][13] 创建服务器配置文件 ‘gogs.service’。 ``` cd /etc/systemd/system vim gogs.service ``` -粘贴下面的代码到 gogs 服务器配置文件中。 +粘贴下面的代码到 Gogs 服务器配置文件中。 + ``` [Unit] - Description=Gogs - After=syslog.target - After=network.target - After=mariadb.service mysqld.service postgresql.service memcached.service redis.service +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 +[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 服务器并设置为开机启动。 +使用下面的命令开启 Gogs 服务器并设置为开机启动。 + ``` systemctl start gogs systemctl enable gogs @@ -276,6 +300,7 @@ systemctl enable gogs Gogs 服务器现在已经运行在 Ubuntu 系统上了。 使用下面的命令检测： + ``` netstat -plntu systemctl status gogs @@ -290,23 +315,27 @@ systemctl status gogs 在本步中，我们将为 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’。 +之后，进入 `/etc/nginx/sites-available` 目录并且创建虚拟主机文件 `gogs`。 + ``` cd /etc/nginx/sites-available vim gogs ``` -粘贴下面的代码到配置项。 +粘贴下面的代码到配置文件。 + ``` server {     listen 80; @@ -316,21 +345,21 @@ server {         proxy_pass http://localhost:3000;     } } - ``` 保存退出。 -**注意:** -使用您的域名修改 ‘server_name’ 项。 +**注意:** 请使用您的域名修改 `server_name` 项。 现在激活虚拟主机并且测试 nginx 配置。 + ``` ln -s /etc/nginx/sites-available/gogs /etc/nginx/sites-enabled/ nginx -t ``` -确保没有抛错，重启 Nginx 服务器。 +确保没有遇到错误，重启 Nginx 服务器。 + ``` systemctl restart nginx ``` @@ -339,25 +368,25 @@ systemctl restart nginx ### 步骤 8 - 测试 -打开您的网页浏览器并且输入您的 gogs URL，我的是 +打开您的网页浏览器并且输入您的 Gogs URL，我的是 http://git.hakase-labs.co 现在您将进入安装界面。在页面的顶部，输入您所有的 PostgreSQL 数据库信息。 [![Gogs 安装][22]][23] -之后，滚动到底部，点击 ‘Admin account settings’ 下拉选项。 +之后，滚动到底部，点击 “Admin account settings” 下拉选项。 输入您的管理者用户名和邮箱。 [![键入 gogs 安装设置][24]][25] -之后点击 ‘Install Gogs’ 按钮。 +之后点击 “Install Gogs” 按钮。 然后您将会被重定向到下图显示的 Gogs 用户面板。 [![Gogs 面板][26]][27] -下面是 Gogs ‘Admin Dashboard（管理员面板）’。 +下面是 Gogs 的 “Admin Dashboard（管理员面板）”。 [![浏览 Gogs 面板][28]][29] @@ -369,7 +398,7 @@ via: https://www.howtoforge.com/tutorial/how-to-install-gogs-go-git-service-on-u 作者：[Muhammad Arul][a] 译者：[CYLeft](https://github.com/CYLeft) -校对：[校对者ID](https://github.com/校对者ID) +校对：[wxy](https://github.com/wxy) 本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出