spring-boot-seed

⚠️ Still under construction

Provides fast, reliable and extensible starter for the development of Java projects using Spring Boot.

How to start?

Before start update the /etc/hosts file:

# tools
127.0.0.1       db.dev.local
127.0.0.1       db.prod.local
127.0.0.1       api.dev.local
127.0.0.1       api.prod.local

Clone the repository:

$ git clone --depth 1 https://github.com/alobaton/spring-boot-seed.git
$ cd spring-boot-seed

Start the database:

$ docker-compose -f docker-compose.dev.yml up -d db

Compile the project:

$ cd apps
$ mvn clean install -Dspring.profiles.active=dev -DskipTests=true

Execute loader:

$ cd loader
$ mvn spring-boot:run -Dspring.profiles.active=dev -DskipTests=true

Start authentication and authorization server:

$ cd ..
$ cd auth
$ mvn spring-boot:run -Dspring.profiles.active=dev -DskipTests=true

The authentication and authorization server is deployed at http://localhost:8082.

Start the application:

$ cd ..
$ cd core
$ mvn spring-boot:run -Dspring.profiles.active=dev -DskipTests=true

The application server is deployed at http://localhost:8083.

To start the projects without Maven use:

$ java $JAVA_OPTS -Djava.security.egd=file:/dev/./urandom -Dspring.profiles.active=dev -DskipTests=true -jar /app.jar

How to test?

To test the project use:

$ cd apps
$ mvn clean install -Dspring.profiles.active=dev

Dockerización

Development building and deployment

NOTA Dev don't use Netflix architecture, you must update in change api.dev.local to localhost in application-dev.properties file. Ex. jdbc:mysql://db:3306/prod-db where db is the container tag in docker-compose.dev.properties file.

To start the containers use:

$ cp .env.dev .env
$ docker-compose -f docker-compose.dev.yml up -d

The authentication and authorization server is deployed at http://localhost:8082. The application is deployed at http://localhost:8083.

To start the containers automatically using a Linux server you can use the file app-name-dev.service. You must update the project path, move the file to /etc/systemd/system/ and execute the following commands:

$ sudo systemctl enable app-name-dev.service
$ sudo systemctl start app-name-dev

Production building and deployment

To start the containers use:

$ cp .env.prod .env
$ docker-compose -f docker-compose.prod.yml up -d

The Eureka and spring boot admin console are available at http://localhost:8081/#/eureka ó http://localhost:8081/admin#/applications.

To start the containers automatically using a Linux server you can use the file app-name-prod.service. You must update the project path, move the file to /etc/systemd/system/ and execute the following commands:

$ sudo systemctl enable app-name-prod.service
$ sudo systemctl start app-name-prod

License

MIT