Build script enhancements, use gradle to build images where possible (#48)

- Use Gradle instead of dockerfiles for SCCS, Eureka and SBA
- Always get version info from metadata files
- Catch errors during build/patch process
- Pass more properties to Initializr
- Add special behavior for local names/tags
- Convert all .adoc to .md

Server-specific updates:
- Config Server: remove spring.config.name override
- Eureka: use lazy-initialization to improve start time
- SBA: Enable AoT and disable checking for thymeleaf templates

Author: TimHess

.github/workflows/build_config_server.yaml

@@ -7,12 +7,14 @@ on:
     paths:
     - '.github/workflows/build_config_server.yaml'
     - 'config-server/**'
+    - 'build.ps1'
   push:
     branches:
     - main
     paths:
     - '.github/workflows/build_config_server.yaml'
     - 'config-server/**'
+    - 'build.ps1'
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
@@ -37,7 +39,7 @@ jobs:
       run: ./build.ps1 -Name '${{ env.IMAGE_NAME }}' -Registry '${{ env.REGISTRY }}' -Tag '${{ env.TAG }}'
       shell: pwsh
       env:
-        TAG: ${{ github.event_name == 'pull_request' && format('-t {0}/{1}:pr-{2}', env.REGISTRY, env.IMAGE_NAME, github.event.number) || '' }}
+        TAG: ${{ github.event_name == 'pull_request' && format('pr-{0}', github.event.number) || '' }}
 
     - name: Login to container registry
       uses: docker/login-action@v3

.github/workflows/build_eureka_server.yaml

@@ -7,12 +7,14 @@ on:
     paths:
     - '.github/workflows/build_eureka_server.yaml'
     - 'eureka-server/**'
+    - 'build.ps1'
   push:
     branches:
     - main
     paths:
     - '.github/workflows/build_eureka_server.yaml'
     - 'eureka-server/**'
+    - 'build.ps1'
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
@@ -37,7 +39,7 @@ jobs:
       run: ./build.ps1 -Name '${{ env.IMAGE_NAME }}' -Registry '${{ env.REGISTRY }}' -Tag '${{ env.TAG }}'
       shell: pwsh
       env:
-        TAG: ${{ github.event_name == 'pull_request' && format('-t {0}/{1}:pr-{2}', env.REGISTRY, env.IMAGE_NAME, github.event.number) || '' }}
+        TAG: ${{ github.event_name == 'pull_request' && format('pr-{0}', github.event.number) || '' }}
 
     - name: Login to container registry
       uses: docker/login-action@v3

.github/workflows/build_springboot_admin_server.yaml

@@ -7,12 +7,14 @@ on:
     paths:
     - '.github/workflows/build_springboot_admin_server.yaml'
     - 'spring-boot-admin/**'
+    - 'build.ps1'
   push:
     branches:
     - main
     paths:
     - '.github/workflows/build_springboot_admin_server.yaml'
     - 'spring-boot-admin/**'
+    - 'build.ps1'
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
@@ -37,7 +39,7 @@ jobs:
       run: ./build.ps1 -Name '${{ env.IMAGE_NAME }}' -Registry '${{ env.REGISTRY }}' -Tag '${{ env.TAG }}'
       shell: pwsh
       env:
-        TAG: ${{ github.event_name == 'pull_request' && format('-t {0}/{1}:pr-{2}', env.REGISTRY, env.IMAGE_NAME, github.event.number) || '' }}
+        TAG: ${{ github.event_name == 'pull_request' && format('pr-{0}', github.event.number) || '' }}
 
     - name: Login to container registry
       uses: docker/login-action@v3

.github/workflows/build_uaa_server.yaml

@@ -7,12 +7,14 @@ on:
     paths:
     - '.github/workflows/build_uaa_server.yaml'
     - 'uaa-server/**'
+    - 'build.ps1'
   push:
     branches:
     - main
     paths:
     - '.github/workflows/build_uaa_server.yaml'
     - 'uaa-server/**'
+    - 'build.ps1'
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
@@ -37,7 +39,7 @@ jobs:
       run: ./build.ps1 -Name '${{ env.IMAGE_NAME }}' -Registry '${{ env.REGISTRY }}' -Tag '${{ env.TAG }}'
       shell: pwsh
       env:
-        TAG: ${{ github.event_name == 'pull_request' && format('-t {0}/{1}:pr-{2}', env.REGISTRY, env.IMAGE_NAME, github.event.number) || '' }}
+        TAG: ${{ github.event_name == 'pull_request' && format('pr-{0}', github.event.number) || '' }}
 
     - name: Login to container registry
       uses: docker/login-action@v3

.gitignore

@@ -1,5 +1,7 @@
-# IntelliJ
+# IDEs
 .idea/
+.vscode/
+.vs/
 
 # Vi/Vim
 *.swp
@@ -10,3 +12,6 @@ build/
 
 # MacOS
 .DS_Store
+
+# Staging directory
+workspace/

README.adoc

@@ -0,0 +1,72 @@
+# SteeltoeOSS Docker Images
+
+GitHub repo for server images to use for local development with SteeltoeOSS.
+
+## Building
+
+### Pre-Requisites
+
+The following tools are required to build any image in this repository:
+
+1. PowerShell or pwsh
+1. Docker or Podman
+
+#### Config Server, Eureka and Spring Boot Admin
+
+The process for these images is to download starter projects from start.spring.io, apply patches to those files and produce images using [the Gradle Plugin](https://docs.spring.io/spring-boot/gradle-plugin/packaging-oci-image.html).
+To build these images you must also have:
+
+1. Access to start.spring.io
+1. `patch` available in the path or installed with Git for Windows
+1. JDK 21
+
+If you do not already have a JDK installed, consider using [Scoop](https://scoop.sh/):
+
+```shell
+# Permit executing remote-signed scripts
+Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
+# Install Scoop
+Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression
+# Add the Java bucket
+scoop bucket add java
+# Install the JDK
+scoop install java/openjdk21
+```
+
+### Build a specific image
+
+```shell
+./build.ps1 config-server
+```
+
+## Running
+
+### List the created images
+
+```shell
+docker images
+```
+
+See [Common Tasks](https://github.com/SteeltoeOSS/Samples/blob/main/CommonTasks.md/) for instructions on how to run the various docker images.
+
+## Images
+
+| Name | Description |
+| ---- | ----------- |
+| [steeltoe.azurecr.io/config-server](config-server/) | Spring Cloud Config Server |
+| [steeltoe.azurecr.io/eureka-server](eureka-server/) | Netflix Eureka Server |
+| [steeltoe.azurecr.io/spring-boot-admin](spring-boot-admin/) | Spring Boot Admin |
+| [steeltoe.azurecr.io/uaa-server](uaa-server/) | Cloud Foundry UAA Server |
+
+## Debug Image Building
+
+### Inspect Container Contents
+
+Via [StackOverflow](https://stackoverflow.com/questions/32353055/how-to-start-a-stopped-docker-container-with-a-different-command/39329138#39329138), here are the commands to list files in a stopped container.
+
+1. Find the id of the stopped container
+   * `docker ps -a`
+1. Commit the stopped container to a new image: test_image.
+   * `docker commit $CONTAINER_ID test_image`
+1. Run the new image in a new container with a shell.
+   * `docker run -ti --entrypoint=sh test_image`