3.4 KiB

Raw Blame History

Java Microservice Setup Task

Purpose

Initialize a new Java microservice project using Java 21, Spring Boot, Spring Cloud, Maven, and AWS cloud platform. Creates the foundation for a modern microservice with proper project structure, dependencies, and configuration.

When to Use

Starting a new Java microservice project
Creating a microservice with Spring Boot and Spring Cloud
Setting up a project for AWS EKS deployment
Establishing a foundation for microservice development with modern Java

Input Requirements

Microservice name and description
Service responsibilities and boundaries
Inter-service communication requirements
Service discovery preferences
AWS deployment preferences
Monitoring and observability requirements

Process Steps

1. Project Structure Creation

Create Maven project structure
Set up source directories (src/main/java, src/main/resources)
Set up test directories (src/test/java, src/test/resources)
Create package structure following microservice conventions
Initialize Git repository

2. Maven Configuration

Create pom.xml with Java 21 configuration
Add Spring Boot parent POM
Add Spring Cloud dependencies
Configure Maven compiler plugin
Add Spring Boot Maven plugin
Configure build profiles (dev, test, prod)
Set up Maven wrapper

3. Spring Boot Configuration

Add Spring Boot Web starter dependency
Add Spring Boot Data JPA starter dependency
Add Spring Boot Security starter dependency
Add Spring Boot Test starter dependency
Add Spring Boot Actuator starter dependency
Add Spring Cloud dependencies
Configure application.properties/yml

4. Spring Cloud Configuration

Add Spring Cloud Netflix dependencies (Eureka, Gateway)
Add Spring Cloud Config dependencies
Add Spring Cloud Sleuth dependencies
Add Resilience4j dependencies
Configure service discovery
Configure API Gateway
Configure distributed tracing

5. Microservice Configuration

Create main application class
Configure Spring Boot for microservice
Set up service discovery client
Configure circuit breaker
Set up health checks
Configure metrics and monitoring
Set up distributed tracing

6. Development Environment Setup

Configure IDE for Java 21 and Spring Boot
Set up local development database
Configure application profiles
Set up service discovery server locally
Configure API Gateway locally
Set up debugging environment

Output Deliverables

Complete Maven project structure
Configured pom.xml with all dependencies
Spring Boot microservice configuration
Spring Cloud configuration
Service discovery setup
Development environment setup guide
Basic microservice template
Git repository with initial commit

Success Criteria

Maven project builds successfully
Spring Boot application starts without errors
Service discovery registration working
Health checks accessible
Metrics and monitoring working
Development environment fully functional
All dependencies resolved correctly
Project ready for microservice development

Dependencies

Java 21 JDK installed
Maven 3.9+ installed
IDE configured for Java development
Git repository access
AWS account (for deployment)
Service discovery server (Eureka/Consul)

Tools and Resources

Maven build tool
Spring Boot framework
Spring Cloud
Java 21 JDK
IDE (IntelliJ IDEA, Eclipse, VS Code)
Git version control
Service discovery tools
AWS CLI (for deployment)