docs: improves description of Docker bundle steps.

docs/deployment_patterns.md

@@ -114,6 +114,35 @@ $ zip -ur imposter-awslambda.zip config
 
 The `imposter-bundle.zip` file can be [deployed to AWS Lambda](./run_imposter_aws_lambda.md) as normal.
 
+#### Creating a container image bundle
+
+When [deploying using containers](./run_imposter_docker.md), you can add the configuration files into the container image itself.
+
+Let's assume your configuration sits in a directory called `config`.
+
+Here is an example Dockerfile:
+
+```dockerfile
+FROM outofcoffee/imposter as imposter
+
+# your custom config
+COPY config /opt/imposter/config
+```
+
+Build it:
+
+```shell
+$ docker build --tag example/mocks .
+```
+
+The container image (`example/mocks` in this example), can be [run with Docker](./run_imposter_docker.md) as normal.
+
+```shell
+$ docker run --rm -it example/mocks
+```
+
+> See [the Docker example project](https://github.com/outofcoffee/imposter/tree/main/examples/docker) for a working example.
+
 ## Further reading
 
 - See [Benchmarks](./benchmarks.md) for representative performance tests, including test set up and configuration.

examples/docker-healthcheck/Dockerfile

@@ -1,4 +1,4 @@
-FROM outofcoffee/imposter as imposter
+FROM outofcoffee/imposter
 
 # docker healthcheck using embedded CLI
 HEALTHCHECK --interval=5s --timeout=5s --start-period=5s --retries=3 CMD imposter list -qx

examples/docker-shell/Dockerfile

@@ -0,0 +1,12 @@
+FROM outofcoffee/imposter as imposter
+
+FROM eclipse-temurin:11.0.16_8-jre-focal
+COPY --from=imposter /opt/imposter/lib /opt/imposter/lib
+
+# your custom config
+COPY config /opt/imposter/config
+
+# optional docker healthcheck
+HEALTHCHECK --interval=5s --timeout=5s --start-period=5s --retries=3 CMD curl -f http://localhost:8080/system/status || exit 1
+
+ENTRYPOINT ["java", "-classpath", "/opt/imposter/lib/*", "io.gatehill.imposter.cmd.ImposterLauncher", "--configDir", "/opt/imposter/config"]

examples/docker-shell/config/imposter-config.yaml

@@ -0,0 +1,20 @@
+plugin: rest
+
+resources:
+  - path: "/users"
+    method: "GET"
+    response:
+      statusCode: 200
+      headers:
+        Content-Type: "application/json"
+      content: |
+        [
+          {
+            "id": 1,
+            "name": "Ada"
+          },
+          {
+            "id": 2,
+            "name": "Grace"
+          }
+        ]

examples/docker-shell/docker-compose.yaml

@@ -0,0 +1,8 @@
+services:
+  mock-server:
+    image: mock-server
+    build: .
+    ports:
+      - "8080:8080"
+    volumes:
+      - ./config:/opt/imposter/config:ro

examples/docker/Dockerfile

@@ -1,12 +1,4 @@
-FROM outofcoffee/imposter as imposter
-
-FROM eclipse-temurin:11.0.16_8-jre-focal
-COPY --from=imposter /opt/imposter/lib /opt/imposter/lib
+FROM outofcoffee/imposter
 
 # your custom config
 COPY config /opt/imposter/config
-
-# optional docker healthcheck
-HEALTHCHECK --interval=5s --timeout=5s --start-period=5s --retries=3 CMD curl -f http://localhost:8080/system/status || exit 1
-
-ENTRYPOINT ["java", "-classpath", "/opt/imposter/lib/*", "io.gatehill.imposter.cmd.ImposterLauncher", "--configDir", "/opt/imposter/config"]