make docker work

.dockerignore

@@ -0,0 +1,6 @@
+# add git-ignore syntax here of things you don't want copied into docker image
+
+.git
+*Dockerfile*
+*docker-compose*
+node_modules

.vitepress/config.mts

@@ -15,6 +15,15 @@ export default defineConfig({
   // Can be removed as soon as the legacy content is removed
   srcExclude: ['**/legacy/**'],
 
+  vite: {
+    server: {
+      fs: {
+        // Allow serving files from one level up to the project root
+        allow: ['..', '../..'],
+      },
+    }
+  },
+
   themeConfig: {
 
     logo: '/images/svg/naemonlogo.svg',

Dockerfile

@@ -3,14 +3,19 @@
 # bash which makes debugging WAY easier
 FROM node:22-bookworm
 
-RUN mkdir -p /site
+EXPOSE 5173
 
-WORKDIR /site
+RUN npm i npm@latest -g
 
-COPY package.json /site/package.json
+WORKDIR /opt/node_app
 
-RUN npm install --verbose
+COPY package.json package-lock.json* ./
+RUN npm install --verbose --include=dev && npm cache clean --force
+ENV PATH=/opt/node_app/node_modules/.bin:$PATH
 
-EXPOSE 5173
+HEALTHCHECK --interval=30s CMD node healthcheck.js
+
+WORKDIR /opt/node_app/app
+COPY . .
 
 CMD ["npm", "run", "docs:dev"]

Makefile

@@ -0,0 +1,21 @@
+#!/usr/bin/make -f
+
+PWD=$(shell pwd)
+DOCKERRUN=docker run \
+	--rm -it \
+	-p 5173:5173 \
+	--name=naemon-docs \
+	-v $(PWD):/opt/node_app/app \
+	-v /opt/node_app/node_modules/ \
+	-v /opt/node_app/app/.vitepress/cache \
+	-v /opt/node_app/app/.vitepress/dist \
+	-v $(PWD)/package.json:/opt/node_app/package.json \
+	naemon/docs:latest
+
+docker-build:
+	docker build -t naemon/docs .
+	$(DOCKERRUN) npm run docs:build
+
+docker-server:
+	docker build -t naemon/docs .
+	$(DOCKERRUN)

README.md

@@ -16,21 +16,21 @@ To do so, all old files got moved into the `legacy` folder using `git mv`. This
 To migrate a page from Jekyll to VitePress, you have to use the `git mv` command, to move the file from the `legacy` folder into the
 new VitePress project located in `src`.
 
-```
+```sh
 git mv legacy/documentation/usersguide/config-incompat3to4.md src/documentation/usersguide/
 ```
 
 In the next step, edit the file, apply all the required changes and command your work.
 
-
 ## Run development server
 
 Please see the documentation of how to setup a local copy of the Naemon website.
 
-[Run Naemon Website Locally ](./documentation/developer/website.md)
+[Run Naemon Website Locally](./documentation/developer/website.md)
 
 ### In a nutshell
-```
+
+```sh
 git clone https://github.com/naemon/naemon.github.io.git
 cd naemon.github.io/
 
@@ -39,18 +39,41 @@ npm run docs:dev
 ```
 
 ### Using Docker
+
 In case you do not want to install Nodejs to your system, you can also use Docker
 
 First build the Docker image which will contain N Nodejs - thats all this documentation has no dependencies
-```
+
+```sh
 docker build . -t naemon/docs
 ```
 
+or simply run:
+
+```sh
+make docker-build
+```
+
 Now run the Docker container and navigate to `http://127.0.0.1:5173` in your browser.
 The container watches for file changes and will automatically regenerate the website if needed.
 
+```sh
+docker run \
+  --rm -it \
+  -p 5173:5173 \
+  --name=naemon-docs \
+  -v $PWD:/opt/node_app/app \
+  -v /opt/node_app/node_modules/ \
+  -v /opt/node_app/app/.vitepress/cache \
+  -v /opt/node_app/app/.vitepress/dist \
+  -v $PWD/package.json:/opt/node_app/package.json \
+  naemon/docs:latest
 ```
-docker run --rm -it -v "$PWD":/site -p "5173:5173" naemon/docs:latest
+
+or simply run:
+
+```sh
+make docker-server
 ```
 
 ### Important for the Migration
@@ -60,7 +83,6 @@ docker run --rm -it -v "$PWD":/site -p "5173:5173" naemon/docs:latest
 3. You can modify HTML anchors like so: `## What Is Naemon? {#whatis}`
 4. Add code blocks `like this` for code instead of quotes 'like so'.
 
-
 ### Goals and Motivation
 
 1. Get a dependency free documentation, (only Nodejs and VitePress) but no GitHub Pages, Jekyll and Ruby anymore.

package.json

@@ -1,13 +1,17 @@
 {
+  "name": "naemon-docs",
+  "private": true,
+  "version": "0.0.0",
   "devDependencies": {
     "vitepress": "^1.5.0"
   },
   "scripts": {
-    "docs:dev": "vitepress dev --host",
-    "docs:build": "vitepress build",
-    "docs:preview": "vitepress preview"
+    "docs:dev": "npx vitepress dev --host",
+    "docs:build": "npx vitepress build",
+    "docs:preview": "npx vitepress preview"
   },
   "dependencies": {
     "@fortawesome/fontawesome-free": "^6.7.0"
   }
-}
+}
+