Docker: Move docker setup into docs

[schemar]

Fixes #646

[schemar]

@claremacrae I moved the docker stuff into ./docs.

[claremacrae]

On Mac when I run ./docker_start I get:

+ docker run --rm -it --volume /Users/clare/Documents/develop/Obsidian/claremacrae/obsidian-tasks/docs:/docs:Z --publish 4000:4000 localhost/obsidian-tasks-docs:latest
Unable to find image 'localhost/obsidian-tasks-docs:latest' locally

[claremacrae]

docker-compose up no longer works:

ERROR: 
        Can't find a suitable configuration file in this directory or any
        parent. Are you in the right directory?

        Supported filenames: docker-compose.yml, docker-compose.yaml, compose.yml, compose.yaml

[claremacrae]

Hi @schemar Sorry to be the bearer of bad news, but this is a regression for me - I can no longer run the docs locally.

I've got my previous version on the branch for the current PR so that will do for now.

[claremacrae]

I wondered where these extra spaces were coming from.
There's a curious cycle going on that your edits include extra spaces in bullet lists, and then @sytone (and I think mine) remove them.

It's is only cosmetic, but it does make git annotate/blame rather less useful, and makes reviews take longer, as you have to mentally separate out formatting changes from content ones...

[schemar]

I think it's my LSP based md formatter 🤔

[schemar]

On Mac when I run ./docker_start I get:

+ docker run --rm -it --volume /Users/clare/Documents/develop/Obsidian/claremacrae/obsidian-tasks/docs:/docs:Z --publish 4000:4000 localhost/obsidian-tasks-docs:latest

Unable to find image 'localhost/obsidian-tasks-docs:latest' locally

Hm, weird. Sorry.

Did it first build the image? Can you try removing the localhost/ part from the last line in the docker_start script and see if that helps?

[schemar]

The last line should only read $TAG

[schemar]

I may have run into a podman feature that doesn't exist in docker.

[claremacrae]

One thing I was curious about is whether the script defaults to always using the local version of the docs. I was curious about what the tag did….

[claremacrae]

Just curious... What was the motivation for the reworking of the scripts?

[claremacrae]

(I mean more than changing the paths due to different working directory...)

[claremacrae]

The last line should only read $TAG

OK That fixed it. Brilliant - thank you very much! I'm back in business! 🎉

I'll create a tiny PR to push that change...

     --volume "$PWD:/docs:Z" \
     --publish 4000:4000 \
-    "localhost/${TAG}"
+    "${TAG}"

[claremacrae]

One thing I was curious about is whether the script defaults to always using the local version of the docs. I was curious about what the tag did….

Answering my own question: yes, it does pick up changes in the local directory... 🎉

[schemar]

Yeah. For this simple use case, docker compose is not really necessary. It's just a container with a mounted volume. Docker compose is not necessarily part of a docker install and may be an additional dependency.

[claremacrae]

Yeah. For this simple use case, docker compose is not really necessary. It's just a container with a mounted volume. Docker compose is not necessarily part of a docker install and may be an additional dependency.

Thank you. That's good to know.