jekyll静态blog部署 checklist

1. 安装jekyll

   1.1 安装ruby

   为了避免版本冲突问题，使用rbenv进行安装（以ubuntu为例，参考https://gorails.com/setup/ubuntu/18.04）

   • 安装rbenv

     cd
     git clone https://github.com/rbenv/rbenv.git ~/.rbenv
     echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
     echo 'eval "$(rbenv init -)"' >> ~/.bashrc
     exec $SHELL
     
     git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
     echo 'export PATH="$HOME/.rbenv/plugins/ruby-build/bin:$PATH"' >> ~/.bashrc
     exec $SHELL
     

   • 安装ruby

     rbenv install 3.0.3
     rbenv global 3.0.3
     

     检查安装是否符合预期

     ruby -v
     

   • 安装 Bundler

     gem install bundler
     

   1.2 安装jekyll

      gem install jekyll bundler
   

2. 创建blog project

   方案一： 安装好ruby后，安装jekyll，并创建blog project：

    gem install bundler jekyll
   
    jekyll new myblog
   

   方案二：直接选择自己喜欢的主题，从github将项目克隆到本地

3. vps上部署git仓库，配置hook实现自动部署blog能力(参考https://jekyllrb.com/docs/deployment/automated/)

   3.1 创建git用户，并配置权限

   • 创建 /var/www/myblog 目录，将用户属组配置为git用户

   3.2 创建git仓库

   以git用户登录vps

    cd
    mkdir myrepo.git
    cd myrepo.git
    git --bare init
   

   在 myrepo.git 中创建 hooks/post-receive 文件，内容如下：

    # Install Ruby Gems to ~/gems
    export PATH="$HOME/.rbenv/bin:$PATH"
    eval "$(rbenv init -)"
    export PATH="$HOME/.rbenv/plugins/ruby-build/bin:$PATH"
    export GEM_HOME=$HOME/gems
    export PATH=$GEM_HOME/bin:$PATH
   
    TMP_GIT_CLONE=$HOME/tmp/jekyll-blog
    GEMFILE=$TMP_GIT_CLONE/Gemfile
    PUBLIC_WWW=/var/www/myblog
   
    git clone $GIT_DIR $TMP_GIT_CLONE
    BUNDLE_GEMFILE=$GEMFILE bundle install
    BUNDLE_GEMFILE=$GEMFILE bundle exec jekyll build -s $TMP_GIT_CLONE -d $PUBLIC_WWW
    rm -Rf $TMP_GIT_CLONE
    exit 
   

   3.3 本地blog project绑定vps git 仓库

    cd myblog
    git init
    git remote add deploy git@remote-address:/path/to/myrepo.git
    git push --set-upstream deploy master
   

   后续push时将会触发vps git hook进行自动部署

4. vps上部署nginx

   4.1 部署nginx

   4.2 根据前面步骤中 PUBLIC_WWW 的值，配置nginx

   4.3 安装域名证书（可通过certbot完成）