GitHub Pages, for GitLab.
Glavin Wiechert (Glavin001) - Twitter @GlavinW - LinkedIn
It requires Jekyll to be installed. GitLab Pages will build Jekyll sites or simply copy content from non-jekyll sites to publicPagesDir
.
Create a SSH key pair for GitLab to use as deploy keys.
ssh-keygen -t rsa -C "example@email.com" -f "$(pwd)/keys/id_rsa"
They should be in path keys/id_rsa
and keys/id_rsa.pub
.
Clone this repo and install it's necessary dependencies:
# Already cloned repo
npm install
bower install
Copy default config to custom config file.
cp default_config.js _config.js
Edit your new _config.js file for your setup.
And start the server!
npm start
Docker support is also available and the following env vars are used to configure the installation:
The /app/keys directory SHOULD be mount using docker volumes, this will allow you to use leave the ssh key outside of the docker. If the rsa key doesn't exist the docker_start.sh script will generate it.
Login using your GitLab User Token at http://localhost:1337.
gl-pages
branch is checked out with nodegit. (This can optionally be configured to be gh-pages
branch to work on both GitHub and GitLab).server.publicUrl
/pages/:username/:projectName/. It is recommended that the publicPagesDir
be served using Nginx or Apache.