MkDocs is a fast, simple and downright gorgeous static site generator that's geared towards building project documentation. Documentation source files are written in Markdown, and configured with a single YAML configuration file.
- Pratik Thakkar
$ docker build . -t pthakkar/mkdocs
$ docker run -t --rm -v /path/to/src:/docs/src -v /path/to/output:/docs/output pthakkar/mkdocs produce
Run as a development server in background. Should allow you to view the site on http://localhost:8000
$ docker run -d -p 8000:8000 -v /path/to/src:/docs/src pthakkar/mkdocs serve
We’ll be using Goss as the testing tool of choice. The installation is simple and only takes a few seconds.
curl -fsSL https://goss.rocks/install | sh
Goss is a YAML based serverspec alternative tool for validating a server’s configuration. It eases the process of writing tests by allowing the user to generate tests from the current system state. Once the test suite is written they can be executed, waited-on, or served as a health endpoint.
Note: For testing docker containers see the dgoss wrapper.
Note: Once installtion is completed create an environment variable GOSS_FILES_PATH specifying goss.yaml path.
export GOSS_FILES_PATH="/jenkins/workspace/path/"