docs: dockerise dev (#9043)

Setting up Ruby v2.7 is getting increasingly difficult on newer systems.

This PR aims to help with that by providing a simple way to launch a documentation dev environment.

Author: alxndrsn

.dockerignore

@@ -0,0 +1,8 @@
+**
+
+!/package.json
+!/bin/build-site.js
+!/bin/install-jekyll.sh
+!/package-lock.json
+!/docs/Gemfile
+!/docs/Gemfile.lock

CONTRIBUTING.md

@@ -118,6 +118,10 @@ Now you can build the site and start the dev server with:
 
 You should now find the documentation at http://127.0.0.1:4000
 
+You can also build and run the documentation with docker:
+
+    $ npm run dev-site-with-docker
+
 Writing a PouchDB Blog Post
 --------------------------------------
 

docs-dev.Dockerfile

@@ -0,0 +1,32 @@
+# maintain similarity to CI by using common base image:
+FROM ubuntu:20.04
+
+RUN apt-get update && \
+    apt-get --yes install \
+        build-essential \
+        curl \
+        ruby-full \
+        && \
+    apt-get clean && \
+    rm -rf /var/lib/apt/lists/*
+
+# TODO confirm ruby version is 2.7... if it matters
+RUN gem install bundler -v 2.1.4
+
+ENV NODE_VERSION=22.12.0
+ENV NVM_DIR=/root/.nvm
+RUN curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
+RUN . "$NVM_DIR/nvm.sh" && nvm install 22
+ENV PATH="$NVM_DIR/versions/node/v${NODE_VERSION}/bin/:${PATH}"
+
+WORKDIR /pouchdb-docs
+
+COPY ./docs/ ./docs-bundler
+RUN cd docs-bundler && bundle install
+
+COPY package.json package-lock.json .
+RUN npm install --ci
+
+COPY ./bin/ ./bin/
+
+CMD ["npm", "run", "build-site"]

package.json

@@ -23,6 +23,7 @@
     "install-jekyll": "./bin/install-jekyll.sh",
     "publish-site": "./bin/publish-site.sh",
     "build-site": "node ./bin/build-site.js",
+    "dev-site-with-docker": "docker build --file docs-dev.Dockerfile --progress=plain . && docker run -it --rm --volume $PWD/docs:/pouchdb-docs/docs -p 4000:4000 $(docker build --quiet .)",
     "test-coverage": "./bin/test-coverage.sh",
     "coverage": "COVERAGE=1 SERVER=pouchdb-server POUCHDB_SERVER_FLAGS=--in-memory PLUGINS=pouchdb-find ./bin/test-coverage.sh",
     "build-test": "npm run build-test-utils && npm run build-perf",