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

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

服务器上

更新

yum update
yum install nginx
yum install git

新建 hugo 用户:

adduser hugo
passwd hugo

安装hugo

yum -y install golang
go version

添加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

部署

切换到 Hugo 用户:

su hugo

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

cd ~
mkdir .git
cd .git

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

vim authorized_keys

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

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

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

建立 Git 库

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

cd ~
mkdir hugo.git
cd hugo.git
git --bare init
touch hooks/post-receive
mkdir /data/www/hugo

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

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

并修改执行权限

chmod a+x hooks/post-receive

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

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

chown hugo /data/www/hugo/
chgrp hugo /data/www/hugo/

Nginx

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


Nginx 隐藏 html后缀

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

自动跳转 https

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

# 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中,加入:

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 仓库下运行:

git remote set-url --add origin [email protected]:~/life.git
git remote -v

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

git add .
git commit -m "my life website"
git push

你可能感兴趣的:(使用 Hugo 进行持续集成写作及同步)