Blog site built with Spring Boot
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
gradle/wrapper
src
.editorconfig
.gitignore
Brocfile.js
LICENSE Add README and LICENSE Sep 11, 2017
README.md
build.gradle.kts
gradlew
gradlew.bat Switch to Gradle Kotlin DSL Jan 20, 2019
package.json
settings.gradle.kts
yarn.lock

README.md

Blog

A blog site written in Spring Boot. Used by https://bianjp.com.

Requirement

  • Java 8
  • PostgreSQL >= 9.0
  • Redis

Extra development/building requirement:

Configuration

Profiles

Spring Profiles are used to separate configurations for different environments.

This project has two profiles:

  • development: Used for development environment
  • production: Used for production environment

Only save common and non-sensitive configurations in src/main/resource/application-{profile}.yml files.

Local specific or sensitive configuration (eg: database password) can be passed in the following ways:

  • src/main/resource/config/application-{profile}.yml: Git ignored, will be included in packaged jar
  • application-{profile}.yml or config/application-{profile}.yml in working directory (it's project root in development environment): Git ignored, will not be included in packaged jar
  • os environment variable
  • Java system properties specified in command line
  • command line arguments

For example, to specify redis host and datasource url by command line arguments:

java -jar build/libs/blog-spring-0.1.0-SNAPSHOT.jar --spring.profiles.active=production --spring.redis.host=127.0.0.1 --spring.datasource.url=jdbc:postgresql://localhost/blog

See Externalized Configuration for more details about configuration methods and precedence.

Minimal configuration

You should at least config datasource and redis.

Create an empty database, and Flyway will take care of the schema migrations.

Running

Development

Install npm dependencies if you haven't:

yarn install

Then just start Spring Boot in your IDE or using gradle (./gradlew bootRun).

By default BroccoliServer will start a broccoli serve process listening on localhost:4200. Change assets.* properties as needed.

Production

./gradlew build -x test
java -jar build/libs/blog-0.1.0-SNAPSHOT.jar --spring.profiles.active=production

Systemd

If you just need a single instance, using systemd is a good idea.

Create /etc/systemd/system/blog.service:

[Unit]
Description=Blog site
After=syslog.target

[Service]
User=YOUR_NORMAL_USER
WorkingDirectory=/path/to/working-directory
ExecStart=/usr/bin/java -jar /path/to/blog-0.1.0-SNAPSHOT.jar --spring.profiles.active=production --server.port=8080
SuccessExitStatus=143

[Install]
WantedBy=multi-user.target
sudo systemctl start blog
sudo systemctl enable blog

License

This project is licensed under the terms of the MIT license.