Build and Run Services
Build all services with Maven and start them in the correct dependency order.
Services must be built and started in dependency order. The platform infrastructure (Service Registry, Config Server, API Gateway) runs in Docker. The three business services run locally on the host.
1. Build the Common Library
cd arya-banking-common
mvn clean install -DskipTests
This publishes the shared library to your local Maven repository (~/.m2/repository). All other services depend on it. You only need to rebuild it when the common library changes.
2. Build the Outbox Starter Library
cd ../arya-banking-outbox-service
mvn clean install -DskipTests
The user-service depends on the outbox starter (org.arya.banking:arya-banking-outbox-service). Install it to your local .m2 as well so the business services can resolve it. Publish it to GitHub Packages only when you need to release a new version.
3. Build All Business Services
cd ../arya-banking-user-service
mvn clean package -DskipTests
cd ../arya-banking-auth-service
mvn clean package -DskipTests
cd ../arya-banking-admin-service
mvn clean package -DskipTests
These can be built in any order — they only need the arya-banking-common and arya-banking-outbox-service artifacts in your local .m2 cache.
4. Start Services
User Service (port 8086)
cd arya-banking-user-service
mvn spring-boot:run
Auth Service (port 8087)
cd arya-banking-auth-service
mvn spring-boot:run
Admin Service (port 8089)
cd arya-banking-admin-service
mvn spring-boot:run
Use separate terminal windows for each service, or run them in the background with mvn spring-boot:run > service.log 2>&1.
5. Expected Startup Behavior
After starting each service, it will:
- Register with Eureka (visible at http://localhost:8761)
- Fetch configuration from the Config Server
- Authenticate to Vault using the AppRole credentials in
vault-credentials.yml - Load secrets into the Spring environment
If a service fails to start, check the Troubleshooting page for common issues.