aboutsummaryrefslogtreecommitdiffstats
path: root/roles/setup_mkdocs
diff options
context:
space:
mode:
Diffstat (limited to 'roles/setup_mkdocs')
-rw-r--r--roles/setup_mkdocs/tasks/main.yml39
-rw-r--r--roles/setup_mkdocs/templates/mkdocs.service24
-rw-r--r--roles/setup_mkdocs/vars/main.yml17
3 files changed, 80 insertions, 0 deletions
diff --git a/roles/setup_mkdocs/tasks/main.yml b/roles/setup_mkdocs/tasks/main.yml
new file mode 100644
index 0000000..83ed41b
--- /dev/null
+++ b/roles/setup_mkdocs/tasks/main.yml
@@ -0,0 +1,39 @@
+
+# =========================================================================== #
+# __ __ __
+# _________ / /__ ____ ___ / /______/ /___ __________
+# / ___/ __ \/ / _ \ / __ `__ \/ //_/ __ / __ \/ ___/ ___/
+# / / / /_/ / / __/ / / / / / / ,< / /_/ / /_/ / /__(__ )
+# /_/ \____/_/\___(_) /_/ /_/ /_/_/|_|\__,_/\____/\___/____/
+#
+# =========================================================================== #
+
+---
+- name: Check mkdocs-material install
+ pip:
+ name: mkdocs-material
+
+- name: Check mkdocs mermaid plugin install
+ pip:
+ name: mkdocs-mermaid2-plugin
+
+- name: Add user mkdocs
+ user:
+ name: "{{ mkdocs_user }}"
+ comment: "{{ mkdocs_user_comment }}"
+
+- name: Copy syncthing systemd unit
+ template:
+ src: "{{ mkdocs_daemon_unit }}.service"
+ dest: "{{ g_systemd_unit_directory }}"
+ owner: root
+ group: root
+ mode: 0644
+
+- name: Start and enable syncthing systemd unit
+ systemd:
+ name: "{{ mkdocs_daemon_unit }}"
+ state: restarted
+ daemon_reload: yes
+ enabled: yes
+
diff --git a/roles/setup_mkdocs/templates/mkdocs.service b/roles/setup_mkdocs/templates/mkdocs.service
new file mode 100644
index 0000000..0befc0d
--- /dev/null
+++ b/roles/setup_mkdocs/templates/mkdocs.service
@@ -0,0 +1,24 @@
+
+# =========================================================================== #
+# _ __ __ __ _
+# __ ______ (_) /_ _______ ______ _____/ /_/ /_ (_)___ ____ _
+# / / / / __ \/ / __/ / ___/ / / / __ \/ ___/ __/ __ \/ / __ \/ __ `/
+# / /_/ / / / / / /__ (__ ) /_/ / / / / /__/ /_/ / / / / / / / /_/ /
+# \__,_/_/ /_/_/\__(_) /____/\__, /_/ /_/\___/\__/_/ /_/_/_/ /_/\__, /
+# /____/ /____/
+#
+# =========================================================================== #
+
+[Unit]
+Description=Webserver for markdown documentation
+
+[Service]
+Type=simple
+User={{ mkdocs_user }}
+WorkingDirectory={{ mkdocs_files_directory }}
+ExecStart=mkdocs serve --dev-addr {{g_ip_mkdocs_gui}}:{{g_port_mkdocs_gui }}
+ExecStop=/bin/kill -s HUP $MAINPID
+RuntimeDirectoryMode=0700
+
+[Install]
+WantedBy=default.target
diff --git a/roles/setup_mkdocs/vars/main.yml b/roles/setup_mkdocs/vars/main.yml
new file mode 100644
index 0000000..418df91
--- /dev/null
+++ b/roles/setup_mkdocs/vars/main.yml
@@ -0,0 +1,17 @@
+
+# =========================================================================== #
+# __ __
+# _ ______ ___________ ____ ___ / /______/ /___ __________
+# | | / / __ `/ ___/ ___/ / __ `__ \/ //_/ __ / __ \/ ___/ ___/
+# | |/ / /_/ / / (__ ) / / / / / / ,< / /_/ / /_/ / /__(__ )
+# |___/\__,_/_/ /____(_) /_/ /_/ /_/_/|_|\__,_/\____/\___/____/
+#
+# =========================================================================== #
+
+---
+mkdocs_user: mkdocs
+mkdocs_user_comment: webserver hosting documentation in markdown
+mkdocs_group: null
+mkdocs_daemon_unit: mkdocs
+
+mkdocs_files_directory: /srv/git/infrastructure-docs
remember that computers suck.