Support Podman

- add GATEWAY_HOST toggle for Podman/WSL2 routing
- reduce Eureka server log levels
- acme-order: listen on any IP
- avoid leaving the container network for traffic to acme-cart
- acme-shopping-react: fix infinite loading on product pages

Author: TimHess

.gitattributes

@@ -0,0 +1,2 @@
+* text=auto
+*.sh text eol=lf

.gitignore

@@ -65,4 +65,7 @@ hello-world/
 **/cypress/screenshots
 
 # tanzu
-build-output
+build-output
+
+# Local Compose overrides (e.g. GATEWAY_HOST for Podman)
+local-development/.env

apps/acme-order/Properties/launchSettings.json

@@ -4,7 +4,7 @@
     "AcmeOrder": {
       "commandName": "Project",
       "launchUrl": "order",
-      "applicationUrl": "http://localhost:8086",
+      "applicationUrl": "http://*:8086",
       "environmentVariables": {
         "ASPNETCORE_ENVIRONMENT": "Development"
       }

apps/acme-shopping-react/src/products/page.tsx

@@ -18,13 +18,17 @@ export default function ProductPage() {
 
   const addToCartMutation = useAddToCart(userInfo?.userId);
 
-  if (isProductLoading || isUserLoading || userInfo == null) {
+  if (isProductLoading || isUserLoading) {
     return <Loading />;
   }
 
-// TODO: maybe we can refactor the Catalog Service to remove duplicate `data` tag
-  if (isProductLoading || data?.data == null) {
-    return null;
+  // TODO: maybe we can refactor the Catalog Service to remove duplicate `data` tag
+  if (data?.data == null) {
+    return (
+      <div className="p-8">
+        <p id="product-not-found">Product not found or catalog unavailable.</p>
+      </div>
+    );
   }
 
   const product = data.data;

apps/acme-shopping-react/vite.config.ts

@@ -5,6 +5,6 @@ import react from "@vitejs/plugin-react";
 export default defineConfig({
   plugins: [react()],
   server: {
-    allowedHosts: ["host.docker.internal"],
+    allowedHosts: ["host.containers.internal","host.docker.internal"]
   },
 });

local-development/.env.example

@@ -0,0 +1,8 @@
+# Copy to ".env" in this directory (Compose loads it automatically). Do not commit ".env".
+#
+# Podman / some Linux setups: use the hostname that resolves to your host from containers.
+# GATEWAY_HOST=host.containers.internal
+#
+# Note for Windows/WSL2 users: host.containers.internal may not resolve to your Windows host.
+# If you see 'connection refused' errors and the apps are running, try your WSL vEthernet adapter IP instead (e.g., 172.24.240.1).
+# GATEWAY_HOST=172.24.240.1

local-development/README.md

@@ -18,6 +18,21 @@ cd local-development
 docker compose -p acme-fitness up -d
 ```
 
+### Configure gateway routes to services running on host
+
+[`spring-enterprise/routes.yml`](spring-enterprise/routes.yml) builds upstream URIs with `${GATEWAY_HOST:host.docker.internal}` as the hostname. Compose passes `GATEWAY_HOST` into the gateway container (default `host.docker.internal`). For **Podman** (or when that hostname misbehaves), set `GATEWAY_HOST` to a value that will work on your machine before running `compose up`:
+
+```shell
+# Option 1: Copy [.env.example](.env.example) to **`local-development/.env`** and uncomment the line (Compose loads `.env` from this directory).
+# Option 2: Set the env var with your preferred shell
+# bash
+export GATEWAY_HOST="host.containers.internal"
+# CMD
+set GATEWAY_HOST="host.containers.internal"
+# PowerShell
+$env:GATEWAY_HOST="host.containers.internal"
+```
+
 ### Boot up each of the local application following their README
 
 - [acme-cart](../apps/acme-cart/README.md)

local-development/docker-compose.yaml

@@ -2,13 +2,15 @@ services:
 
   discovery:
     container_name: discovery-server
-    image: steeltoeoss/eureka-server
+    image: steeltoe.azurecr.io/eureka-server
     ports:
       - "8761:8761"
+    environment:
+      LOGGING_LEVEL_COM_NETFLIX_EUREKA: ERROR
 
   config:
     container_name: config-server
-    image: steeltoeoss/config-server
+    image: steeltoe.azurecr.io/config-server
     ports:
       - "8888:8888"
     volumes:
@@ -23,6 +25,8 @@ services:
     ports:
       - "8090:8090"
       - "9000:9000"
+    environment:
+      GATEWAY_HOST: ${GATEWAY_HOST:-host.docker.internal}
     volumes:
       - ./spring-enterprise:/app
     working_dir: /app

local-development/spring-enterprise/routes.yml

@@ -8,15 +8,15 @@ spring:
         # ####################################################
         # acme-assist
         # ####################################################
-        - uri: http://host.docker.internal:8081
+        - uri: "http://${GATEWAY_HOST:host.docker.internal}:8081"
           predicates:
             - Path=/ai/*
             - Method=POST
           filters:
             - StripPrefix=0
           tags:
             - assist-service
-        - uri: http://host.docker.internal:8081
+        - uri: "http://${GATEWAY_HOST:host.docker.internal}:8081"
           predicates:
             - Path=/ai/admin/*
             - Method=GET
@@ -28,7 +28,7 @@ spring:
         # ####################################################
         # acme-cart
         # ####################################################
-        - uri: http://host.docker.internal:8085
+        - uri: "http://cart:5000"
           predicates:
             - Path=/cart/item/add/{userId}
             - Method=POST
@@ -37,7 +37,7 @@ spring:
             - TokenRelay
           tags:
             - cart
-        - uri: http://host.docker.internal:8085
+        - uri: "http://cart:5000"
           predicates:
             - Path=/cart/item/modify/{userId}
             - Method=POST
@@ -46,7 +46,7 @@ spring:
             - TokenRelay
           tags:
             - cart
-        - uri: http://host.docker.internal:8085
+        - uri: "http://cart:5000"
           predicates:
             - Path=/cart/items/{userId}
             - Method=GET
@@ -55,7 +55,7 @@ spring:
             - TokenRelay
           tags:
             - cart
-        - uri: http://host.docker.internal:8085
+        - uri: "http://cart:5000"
           predicates:
             - Path=/cart/clear/{userId}
             - Method=GET
@@ -64,7 +64,7 @@ spring:
             - TokenRelay
           tags:
             - cart
-        - uri: http://host.docker.internal:8085
+        - uri: "http://cart:5000"
           predicates:
             - Path=/cart/total/{userId}
             - Method=GET
@@ -79,7 +79,7 @@ spring:
         # ####################################################
         - title: products-route
           description: /products endpoint
-          uri: http://host.docker.internal:8082
+          uri: "http://${GATEWAY_HOST:host.docker.internal}:8082"
           predicates:
            - Path=/products
            - Method=GET
@@ -90,7 +90,7 @@ spring:
            - catalog
         - title: products-id-route
           description: /products/id endpoint
-          uri: http://host.docker.internal:8082
+          uri: "http://${GATEWAY_HOST:host.docker.internal}:8082"
           predicates:
            - Path=/products/{id}
            - Method=GET
@@ -100,7 +100,7 @@ spring:
            - catalog
         - title: catalogliveness-route
           description: /products/id endpoint
-          uri: http://host.docker.internal:8082
+          uri: "http://${GATEWAY_HOST:host.docker.internal}:8082"
           predicates:
            - Path=/catalogliveness
            - Method=GET
@@ -111,7 +111,7 @@ spring:
            - catalog
         - title: catalogliveness-route
           description: /products/id endpoint
-          uri: http://host.docker.internal:8082
+          uri: "http://${GATEWAY_HOST:host.docker.internal}:8082"
           predicates:
            - Path=/static/images/{id}
            - Method=GET
@@ -125,7 +125,7 @@ spring:
         # ####################################################
         - order: 0
           ssoEnabled: true
-          uri: http://host.docker.internal:8083
+          uri: "http://${GATEWAY_HOST:host.docker.internal}:8083"
           predicates:
             - Path=/acme-login
             - Method=GET
@@ -134,7 +134,7 @@ spring:
             - RedirectTo=302, /
           tags:
             - sso
-        - uri: http://host.docker.internal:8083
+        - uri: "http://${GATEWAY_HOST:host.docker.internal}:8083"
           predicates:
             - Path=/userinfo
             - Method=GET
@@ -150,7 +150,7 @@ spring:
             - Method=POST
           tags:
             - users
-        - uri: http://host.docker.internal:8083
+        - uri: "http://${GATEWAY_HOST:host.docker.internal}:8083"
           predicates:
             - Path=/whoami
             - Method=GET
@@ -163,7 +163,7 @@ spring:
         # ####################################################
         # acme-order
         # ####################################################
-        - uri: http://host.docker.internal:8086
+        - uri: "http://${GATEWAY_HOST:host.docker.internal}:8086"
           title: Create an order.
           description: Creates an order for the user.
           predicates:
@@ -174,7 +174,7 @@ spring:
             - TokenRelay
           tags:
             - order
-        - uri: http://host.docker.internal:8086
+        - uri: "http://${GATEWAY_HOST:host.docker.internal}:8086"
           title: Retrieve User's Orders.
           description: Lookup all orders for the given user
           predicates:
@@ -189,7 +189,7 @@ spring:
         # ####################################################
         # acme-payment
         # ####################################################
-        - uri: http://host.docker.internal:8084
+        - uri: "http://${GATEWAY_HOST:host.docker.internal}:8084"
           description: /pay endpoint
           predicates:
             - Path=/pay
@@ -204,7 +204,7 @@ spring:
         # acme-shopping (frontend)
         # ####################################################
         - order: 999
-          uri: http://host.docker.internal:8080
+          uri: "http://${GATEWAY_HOST:host.docker.internal}:8080"
           predicates:
             - Path=/**
             - Method=GET