initial commit

Author: ManfredLange

.devcontainer/.dockerignore

@@ -0,0 +1,9 @@
+.dockerignore
+.env
+.git
+.gitignore
+.vs
+.vscode
+docker-compose.yml
+docker-compose.*.yml
+*.class

.devcontainer/Dockerfile

@@ -0,0 +1,41 @@
+FROM openjdk:17.0.1-bullseye
+# To check for newer JDK versions, see https://openjdk.java.net/, then 
+# https://hub.docker.com/_/openjdk. Last check on 16 jan 2022 [Manfred, 16jan2022]
+
+RUN apt-get update && \
+    apt-get upgrade -y && \
+    apt-get install -y \
+        procps \
+        iputils-ping \
+        net-tools \
+        lsb-release
+# procps: to support command 'ps'
+# iputils-ping: to support command 'ping' (https://linuxconfig.org/ping-command-not-found-on-ubuntu-20-04-focal-fossa-linux) [Manfred, 19sep2021]
+# net-tools: to support command such as 'arp', 'ifconfig', 'netstat', etc. (https://helpmanual.io/packages/apt/net-tools/) [Manfred, 26sep2021]
+# lsb-release: to support commmand 'lsb_release -a' [Manfred, 15jan2022]
+# You can safely remove the packages you don't want. [Manfred, 08oct2021]
+
+# Create non-root user (zero trust principle, least privileged principle)
+RUN groupadd -g 1000 -r dev && \
+    useradd -u 1000 -r -g dev -m -s $(which bash) dev
+# Option '-m' to create home directory (see https://askubuntu.com/a/393470)
+# Option '-s' to set shell for this user (see comment in https://askubuntu.com/a/393470)
+# Option '-r' creates a system user which does not expire (see https://linuxize.com/post/how-to-create-users-in-linux-using-the-useradd-command/)
+
+# How to add sudo support for the non-root user is described at https://code.visualstudio.com/remote/advancedcontainers/add-nonroot-user#_creating-a-nonroot-user
+# However, standard practice is not to add sudo support for security reasons. VS Code will connect
+# to the running dev container as the user specified in file ".devcontainer/devcontainer.json" in
+# property "remoteUser". If you need to run commands as root to set up the dev container, use the
+# "RUN" directive in Dockerfile or add suitable code to the script ".devcontainer/entrypoint.sh". 
+# [Manfred, 16jan2022]
+
+# Create working directory. Ownership will be changed in entrypoint.sh which
+# executes *after* the volume has been mounted.
+RUN mkdir /src
+
+# Copy entrypoint script into container, make it executable, then make it the entrypoint for the
+# container:
+COPY entrypoint.sh /entrypoint.sh
+RUN chmod +x /entrypoint.sh
+# Option '+x' adds executable flag to the file
+ENTRYPOINT ["/entrypoint.sh"]

.devcontainer/devcontainer.json

@@ -0,0 +1,16 @@
+{
+   "name": "java-dev",
+   "dockerComposeFile": [
+       "docker-compose.yml"
+   ],
+   "service": "java-dev",
+   "workspaceFolder": "/src",
+   "extensions": [
+       "eamodio.gitlens",
+       "editorconfig.editorconfig",
+       "shd101wyy.markdown-preview-enhanced",
+       "vscjava.vscode-java-pack"
+   ],
+   "remoteUser": "dev",
+   "shutdownAction": "stopCompose"
+}

.devcontainer/docker-compose.yml

@@ -0,0 +1,18 @@
+version: '3.7'
+
+services:
+   java-dev:
+      container_name: java-dev
+      hostname: java-dev.local
+      build:
+         context: .
+      working_dir: /src
+      volumes:
+         - ..:/src:cached
+      command: >
+         bash -c "sleep infinity"
+      networks:
+         rimutec:
+
+networks:
+   rimutec:

.devcontainer/entrypoint.sh

@@ -0,0 +1,18 @@
+#!/bin/sh
+
+echo Running entrypoint.sh
+
+#################################################################################################################
+# Provided the Dockerfile doesn't change the user, this script will run as 'root'. However, once VS Code connects
+# it will connect remotely as user 'dev' [Manfred, 19sep2021]
+
+
+#################################################################################################################
+# Change ownership of all directories and files in the mounted volume:
+chown -R dev:dev /src
+# Option '-R' applies the ownerhip change recursively on files and directories in /src
+
+
+#################################################################################################################
+# Finally invoke what has been specified as CMD in Dockerfile or command in docker-compose:
+"$@"

.editorconfig

@@ -0,0 +1,11 @@
+# top-most EditorConfig file
+root = true
+
+# Unix-style newlines with a newline ending every file
+[*]
+end_of_line = lf
+indent_style = space
+indent_size = 3
+insert_final_newline = true
+# Do not add the following without confirming that nullable warnings and errors are still honored
+# generated_code = true

.env

@@ -0,0 +1,3 @@
+# Name of the project so that services specified in docker-compose for this project
+# are grouped under that name in Docker Desktop:
+COMPOSE_PROJECT_NAME=rimutec

.gitattributes

@@ -0,0 +1,4 @@
+# Ensure all files git considers to be text to have normalized (LF) line endings in the repository
+# https://stackoverflow.com/a/33890199/411428
+# [Manfred, 19sep2021]
+* text=auto