README.md

asciidoc s2i Builder

Usage

This builder is used in openshift to generate sites automatically. But, you can also run the builder on your own workstation.

Prerequisites

You need the source-to-image package on your workstation to build an output image.

$ dnf -y install source-to-image

Getting/building the container

$ docker pull bstinsonmhk/docs-fpo-build

Or build it yourself

$ docker build --tag <yournamespace>/docs-fpo-build -f Dockerfile.build .

Building the master docs.fedoraproject.org Site:

# We need to do the magic --exclude='' flag here, so the .git directory isn't
# stripped out by s2i

$ s2i build https://pagure.io/fedora-docs/docs-fp-o --exclude='' bstinsonmhk/docs-fpo-build <output-image>

Building a pull request on the install-guide:

# This builds pull-request 1 on the install-guide and puts it in the output
# image. Feel free to try against the other fedora-docs repos as well! If you
# leave off the PR= variable the builder will build the master branch. 

$ s2i build https://pagure.io/fedora-docs/install-guide -e "PR=1" --exclude='' bstinsonmhk/docs-fpo-build <output-image>

Running the built image

$ docker run -d -p 8080:8080 <output-image>

et voilà ! Visit http://localhost:8080 to explore the site.