Local setup

README.md

@@ -69,6 +69,9 @@ Run services `api-gateway`, `order-service`, `customer-service`, `inventory-serv
 | Customer service  | localhost:9091 |
 | Inventory service | localhost:9093 |
 
+
+> Note: service discovery now defaults to `localhost` for local development. If you run services in Docker and need a different address, set `SERVICE_HOSTNAME` before starting each service (for example `export SERVICE_HOSTNAME=host.docker.internal`).
+
 ### Start outbox connectors
 
 Create outbox connectors

customer-service/src/main/resources/application.yml

@@ -21,6 +21,9 @@ spring:
     consul:
       host: ${CONSUL_HOST:localhost}
       port: ${CONSUL_PORT:8500}
+      discovery:
+        prefer-ip-address: false
+        hostname: ${SERVICE_HOSTNAME:host.docker.internal}
     function:
       definition: handleReserveCustomerBalanceRequest;handleCompensateCustomerBalanceRequest
     stream:

inventory-service/src/main/resources/application.yml

@@ -21,6 +21,9 @@ spring:
     consul:
       host: ${CONSUL_HOST:localhost}
       port: ${CONSUL_PORT:8500}
+      discovery:
+        prefer-ip-address: false
+        hostname: ${SERVICE_HOSTNAME:host.docker.internal}
     function:
       definition: handleReserveProductStockRequest
     stream:

order-service/src/main/resources/application.yml

@@ -21,6 +21,9 @@ spring:
     consul:
       host: ${CONSUL_HOST:localhost}
       port: ${CONSUL_PORT:8500}
+      discovery:
+        prefer-ip-address: false
+        hostname: ${SERVICE_HOSTNAME:host.docker.internal}
     function:
       definition: reserveCustomerBalanceStage;reserveProductStockStage
     stream:

pom.xml

@@ -25,6 +25,7 @@
 
   <properties>
     <java.version>21</java.version>
+    <lombok.version>1.18.44</lombok.version>
     <spring-cloud.version>2025.0.0</spring-cloud.version>
   </properties>
 
@@ -41,6 +42,21 @@
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-web</artifactId>
     </dependency>
+    <!-- Source: https://mvnrepository.com/artifact/org.projectlombok/lombok -->
+<dependency>
+    <groupId>org.projectlombok</groupId>
+    <artifactId>lombok</artifactId>
+    <version>1.18.44</version>
+    <scope>compile</scope>
+</dependency>
+<!-- Source: https://mvnrepository.com/artifact/org.projectlombok/lombok-maven -->
+<dependency>
+    <groupId>org.projectlombok</groupId>
+    <artifactId>lombok-maven</artifactId>
+    <version>1.18.20.0</version>
+    <type>pom</type>
+    <scope>compile</scope>
+</dependency>
     <dependency>
       <groupId>org.springframework.cloud</groupId>
       <artifactId>spring-cloud-stream</artifactId>
@@ -59,11 +75,12 @@
       <artifactId>spring-boot-configuration-processor</artifactId>
       <optional>true</optional>
     </dependency>
-    <dependency>
+    <!-- <dependency>
       <groupId>org.projectlombok</groupId>
       <artifactId>lombok</artifactId>
+      <version>${lombok.version}</version>
       <optional>true</optional>
-    </dependency>
+    </dependency> -->
     <dependency>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-test</artifactId>
@@ -82,4 +99,25 @@
       </dependency>
     </dependencies>
   </dependencyManagement>
+
+  <build>
+  <plugins>
+    <plugin>
+      <groupId>org.apache.maven.plugins</groupId>
+      <artifactId>maven-compiler-plugin</artifactId>
+      <version>3.11.0</version>
+      <configuration>
+        <source>${java.version}</source>
+        <target>${java.version}</target>
+        <annotationProcessorPaths>
+          <path>
+            <groupId>org.projectlombok</groupId>
+            <artifactId>lombok</artifactId>
+            <version>${lombok.version}</version>
+          </path>
+        </annotationProcessorPaths>
+      </configuration>
+    </plugin>
+  </plugins>
+</build>
 </project>