OpenShift Playbooks is a documentation site for OpenShift, maintained by the OpenShift community and moderated by the North America Emerging Technologies Practice in Red Hat Consulting.
This site is written in asciidoc format and is built using the Asciidoctor plugin for Jekyll.
-
Clone git repositories
git clone https://github.com/redhat-cop/openshift-playbooks.git
-
Start Site Builder Container
cd openshift-playbooks docker run \ -u `id -u` -it \ -v $PWD/:/home/jekyll/src/:Z \ -p 4000:4000 \ redhatcop/jekyll-local-builder
-
Launch browser and navigate to
http://localhost:4000
-
Install necessary packages.
sudo yum install -y libyaml-devel autoconf gcc-c++ readline-devel zlib-devel libffi-devel openssl-devel automake libtool bison sqlite-devel
-
Install Node.js Version Manager (nvm — see https://github.com/creationix/nvm)
curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.29.0/install.sh | bash
-
Note
For gnome-terminal
users, you’ll need to do this additional step -
Install and use Ruby 2.0
rvm install 2.3.0 rvm use 2.3.0
-
Install and set up RubyGems
rvm rubygems latest
-
Install bundler
gem install bundler
-
Install project dependencies
bundle install
-
Build site source
bundle exec jekyll build
-
Run local Jekyll server to view site
bundle exec jekyll serve
See our full contribution guide for more details