mdbook

What is does this role do?

This role installs mdbook as well as a cron job that manages the site that is installed.

Meta

Files Managed:

• /etc/iptables.d/mdbook.rules
• /etc/nginx/locations.d/[MDBOOK_SITE_URL]/
• /etc/nginx/sites-available/[MDBOOK_SITE_NAME].conf
• /etc/nginx/sites-enabled/[MDBOOK_SITE_NAME].conf
• /etc/cron.d/[MDBOOK_SITE_NAME]
• /usr/local/sbin/mdbook-build-[MDBOOK_SITE_NAME]

Variables Required: mdbook_sites:

• site_name: the name for the site, should not have spaces site_path: where to serve the site from site_url: the url of the site source_url: a git repo containing the site source_dir: a subdirectory containing docs source_host: the host of the git repository source_port: the port to connect to on the host containing the jekyll source material ssl_certificate_path: if using ssl, this must be the path to the certificate's full chain ssl_key_path: if using ssl, this must be the path to the certificate keyfile use_ssl: whether to use ssl webserver: which webserver role to use (nginx)

Files Required:

• None

Optional Files:

• None

Conflicting Roles:

• None

Depends On:

• network
• nginx