jekyll_deployment

Deployment of Jekyll-Sites using Git Bare Repository on a Linux🐧 webserver e.g. uberspace🚀.

Types of use

The script can be used in 2 ways:

As post-receive git hook
As standalone script with path to git bare repository as argument

In both cases the same config (deploy.conf) is used.

How does it work?

The script executes the following steps:

Assign pushed branch to a variable, if called via post-receive
Read the configuration file from repository into a temporary file and source it
Assign build branch from configuration to pushed branch variable if script was called directly
Check if pushed branch and build branch (from configuration) matches (exit or continue)
Generate a temporary directory
Clone the bare repo into this directory
Install the dependencies specified in your Gemfile via bundle install
Generate HTML from Jekyll via jekyll build to our document root
Delete temporary file from step 2 and directory from step 5
Execute an optional task, $post_exec that can be configured

Installation

Prerequisites

Install Jekyll & Bundler

On your target machine, you will need to install Jekyll and Bundler.

See Jekyll on Linux for details.

~/.ssh/authorized_keys

You need to add all ssh public keys that should be able to deploy to ~/.ssh/authorized_keys on your target machine.

Bare-Git-Repository

We need to create a bare git repository on your target machine.

We start after successful ssh-login on our target host in our home directory and create a directory for our repositories.

mkdir repos

change into...

cd repos

and create another directory to which we want to push. In the following example the directory is named like our domain. (From here on you should substitute florian.latzel.io with your domain.)

mkdir florian.latzel.io

change into...

cd florian.latzel.io

now we initialise the directory as bare repository.

git init --bare

Post-receive Git Hook

At first we remove the post-receive from the git repository (if exists), to replace it later with a symbolic link to our script:

rm ~/repos/florian.latzel.io/hooks/post-receive

We clone the Jekyll Deployment Skript into above created repo directory:

git clone https://github.com/fl3a/jekyll_deployment.git ~/repos

Now we create a symbolic link named post-receive in our git bare repository which source is the same named script from Jekyll Deployment Skript:

ln -s ~/repos/jekyll_deployment/post-receive ~/repos/florian.latzel.io/hooks/post-receive

At last, we need to make script executable:

chmod +x ~/repos/jekyll_deployment/post-receive

Standalone Script

Set a symbolic link to directory which is your $PATH. (On uberspace it is ~/bin by default).

ln -s ~/repos/jekyll_deployment/post-receive ~/bin/jekyll_deployment

Configuration

Set BUNDLE_PATH

On your target machine, add the following line to ~/.bundle/config:

BUNDLE_PATH: "~/.gem"

deploy.conf

Copy deploy.conf to your sites repository, edit the variables, commit and push it.
So the script can read its config from the repository.

These are the mandatory variables, you must change them according your needs:
(If you are on uberspace🚀 like me, www path schema will already fit😙)

build_branch, the branch that should be build (pushes to other branches will be ignored) e.g. main
domain, name of your domain e.g. 'example.com'
git_repo, path to your Jekyll Git-Repository e.g. "${HOME}/repos/${domain}.git"
www, path to document root, destination for the generated html e.g. "/var/www/virtual/${USER}/${domain}"

For optional variables have a look at the corresponding comments in deploy.conf and the examples below.

Add remote repository

On your local machine, you need to add a remote repository, in below example named uberspace to your local git repository.

git remote add uberspace fl3a@bellatrix.uberspace.de:repos/florian.latzel.io

Now you can push your branch e.g. main to your remote uberspace and might see the output from git clone, bundle install and jekyll build after the transmission of your changes.

git push uberspace main

Usage

git push

From your repository on your local machine you will just type git push uberspace and your site will be depoyed in a few moments.