使用 Hugo 进行持续集成写作及同步

我们通常会在本地计算机上写 Markdown 文件,然后使用 Hugo 建立静态博客网站。因此需要一种方法将本地文件同步到服务器上,同时实现 GitHub 集成,确保网站的可维护性。我使用了 Git hook 的方法进行同步与集成。

#服务器上

#更新

1
2
3
yum update
yum install nginx
yum install git

新建 hugo 用户:

1
2
adduser hugo
passwd hugo

#安装 hugo

#安装 go

yum -y install golang
go version

#源码安装

1
2
3
4
5
mkdir $HOME/src
cd $HOME/src
git clone https://github.com/gohugoio/hugo.git
cd hugo
go install --tags extended

#yum 安装

有些主题需要支持sass/scss功能,如果使用 yum 安装 hugo,则没办法安装extend版本,会导致编译失败。

#添加 epel repo

/etc/yum.repos.d/hugo.repo 文件中添加:

[daftaupe-hugo]
name=Copr repo for hugo owned by daftaupe
baseurl=https://copr-be.cloud.fedoraproject.org/results/daftaupe/hugo/epel-7-$basearch/
type=rpm-md
skip_if_unavailable=True
gpgcheck=1
gpgkey=https://copr-be.cloud.fedoraproject.org/results/daftaupe/hugo/pubkey.gpg
repo_gpgcheck=0
enabled=1

#执行安装 Hugo

yum -y install hugo
hugo version

注意,如果使用 CentOS,使用 yum 安装的只是 hugo 的普通版本,而不是 extend。如果需要用 extend,那么请使用 Linuxbrew 进行安装(由于 Linuxbrew 无法安装在 root 目录,因此后面在hooks/post-receive调用时请使用全路径。

#部署

切换到 Hugo 用户:

1
su hugo

在用户目录下新建 .git 目录

1
2
3
cd ~
mkdir .git
cd .git

将本地的 id_rsa.pub 的内容保存到~/.ssh/authorized_keys 文件内

1
vim authorized_keys

进入 vim 后按下 i 进入insert模,直接粘贴就行

这样就可以用 hugo 用户 ssh 到服务器上了,其中,ssh公钥生效需满足至少下面两个条件:

  • .ssh 目录的权限必须是 700
  • .ssh/authorized_keys 文件权限必须是 600

#建立 Git 库

在用户目录下新建 .git 目录

1
2
3
4
5
6
cd ~
mkdir hugo.git
cd hugo.git
git --bare init
touch hooks/post-receive
mkdir /data/www/hugo

添加下面的代码到 hooks/post-receive :

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
GIT_REPO=$HOME/hugo.git
TMP_GIT_CLONE=$HOME/tmp/hugo
PUBLIC_WWW=/data/www/hugo
THEME=/data/www/hugoTheme/themes/meme/.

git clone $GIT_REPO $TMP_GIT_CLONE
cp -r $THEME $TMP_GIT_CLONE/themes/meme
hugo -s $TMP_GIT_CLONE -d $PUBLIC_WWW
rm -Rf $TMP_GIT_CLONE
exit

并修改执行权限

1
chmod a+x hooks/post-receive

这里需要说明一下,Git hook 是一段自动执行的代码,当使用 Git push 时,远程的服务器会自动执行 post-receive 中的代码片段。在这里,我首先将主题文件复制到服务器中,再运行 hugo 命令在制定的文件夹中生成静态博客。

切换到root账户,然后建立/data/www/hugo文件,并将文件所有者设置为 hugo

1
2
chown hugo /data/www/hugo/
chgrp hugo /data/www/hugo/

#Nginx

我使用了 Nginx 作为 web 服务器,记录下一些小设置,给后来的朋友踩坑。


Nginx 隐藏 html后缀

1
2
3
4
5
6
7
location / {
     //添加上以下代码:
     if (!-e $request_filename){
         rewrite ^(.*)$ /$1.html last;
         break;
     }
}

自动跳转 https

/conf/nginx.conf文件中加入:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
# HTTPS server
  server {
  listen 443;
  server_name localhost;
  ssl on;
  ssl_certificate cert.pem;
  ssl_certificate_key cert.key;
  ssl_session_timeout 5m;
  ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
  ssl_ciphers ALL:!ADH:!EXPORT56:RC4+RSA:+HIGH:+MEDIUM:+LOW:+SSLv2:+EXP;
  ssl_prefer_server_ciphers on;
  location / {

在需要跳转的站点下的server中,加入:

1
2
3
4
5
6
7
8
server {
   listen 80;
   server_name localhost;   #将localhost修改为您证书绑定的域名,例如:www.example.com。
  	rewrite ^(.*)$ https://$host$1 permanent;   #将所有http请求通过rewrite重定向到https。
   location / {
  	index index.html index.htm;
	}
}

#本机

在该网站的 Git 仓库下运行:

1
2
git remote set-url --add origin life@yourserver.com:~/life.git
git remote -v

之后只需要使用常规git操作,即可同时 push 到 GitHub 和云服务器上

1
2
3
git add .
git commit -m "my life website"
git push
Load Comments?