fixup! fixup! fixup! fixup! fixup! fixup! fixup! fixup! fixup! !fixup Introduce devcontainer service container based development environment (#705)

Author: bedrich-schindler

docker/react_ui_devcontainer/files/home/developer/shell-init.sh

@@ -1,6 +1,10 @@
 #!/bin/sh
 
 # Block SSH agent forwarding if the environment variable `BLOCK_SSH_AUTH_SOCK` is set to "true"
+#
+# VS Code forwards the SSH agent socket to the dev container by default, so this allows users
+# to opt out of that behavior if they want to disable SSH agent forwarding to isolate the dev container.
+# JetBrains IDEs forward the SSH agent socket only if allowed by the user.
 if [ "$BLOCK_SSH_AUTH_SOCK" = "true" ]; then
   # Disable SSH agent forwarding for the current shell session
   export SSH_AUTH_SOCK=/dev/null

docker/react_ui_devcontainer/files/usr/local/bin/mkdocs

@@ -1,3 +1,5 @@
 #!/bin/sh
 
+# This script is a wrapper around the `mkdocs` command that executes it within the Docker container.
+# Docker Socket is owned by root, so we need to use `sudo` to access it.
 sudo docker compose -p "$COMPOSE_PROJECT_NAME" exec docs mkdocs "$@"

docker/react_ui_devcontainer/files/usr/local/bin/node

@@ -1,3 +1,5 @@
 #!/bin/sh
 
+# This script is a wrapper around the `node` command that executes it within the Docker container.
+# Docker Socket is owned by root, so we need to use `sudo` to access it.
 sudo docker compose -p "$COMPOSE_PROJECT_NAME" exec node node "$@"

docker/react_ui_devcontainer/files/usr/local/bin/npm

@@ -1,5 +1,7 @@
 #!/bin/sh
 
+# This script is a wrapper around the `npm` command that executes it within the Docker container.
+# Docker Socket is owned by root, so we need to use `sudo` to access it.
 if [ "$1" = "run" ] && echo "$2" | grep -q '^test:playwright'; then
   sudo docker compose -p "$COMPOSE_PROJECT_NAME" exec playwright npm "$@"
 else

docker/react_ui_devcontainer/files/usr/local/bin/npx

@@ -1,3 +1,5 @@
 #!/bin/sh
 
+# This script is a wrapper around the `npx` command that executes it within the Docker container.
+# Docker Socket is owned by root, so we need to use `sudo` to access it.
 sudo docker compose -p "$COMPOSE_PROJECT_NAME" exec node npx "$@"