https://github.com/stelligent/microservice-exemplar
Sample microservice built with Spring Boot to manage bananas. :banana:
https://github.com/stelligent/microservice-exemplar
Last synced: about 1 year ago
JSON representation
Sample microservice built with Spring Boot to manage bananas. :banana:
- Host: GitHub
- URL: https://github.com/stelligent/microservice-exemplar
- Owner: stelligent
- License: mit
- Created: 2016-09-12T18:38:50.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2020-01-07T15:39:11.000Z (over 6 years ago)
- Last Synced: 2025-03-24T05:26:21.431Z (about 1 year ago)
- Language: Java
- Homepage:
- Size: 504 KB
- Stars: 23
- Watchers: 5
- Forks: 9
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Overview
This is a *sample microservice* application built with [Spring Boot](http://projects.spring.io/spring-boot/) and [Docker](https://www.docker.com/), deployed on Amazon ECS, to manage bananas :banana:
Review the steps below to learn how it was created and how to create your own:
# Step 1: Set up your environment
You will need to install the [Spring Boot CLI](http://docs.spring.io/spring-boot/docs/current/reference/htmlsingle/#getting-started-installing-the-cli) to get started. The recommended way is to use [SDKMAN!](http://sdkman.io/index.html). First install SDKMAN! with:
```
$ curl -s "https://get.sdkman.io" | bash
```
Then, install Spring Boot with:
```
$ sdk install springboot
```
Alternatively, you could install with [Homebrew](http://brew.sh/):
```
$ brew tap pivotal/tap
$ brew install springboot
```
Or [MacPorts](http://www.macports.org/):
```
$ sudo port install spring-boot-cli
```
# Step 2: Scaffold out your microservice project
Use the Spring Boot CLI to create a project:
```
$ spring init --build=gradle --package-name=com.stelligent --dependencies=web,actuator,hateoas -n Banana banana-service
```
# Step 3: Create a REST domain, repository, resource and controller
write some code...
# Step 4: Run it locally
Start the app by running:
```
$ gradle bootRun
```
Try it out:
```
$ curl http://localhost:8080/bananas
```
# Step 5: Create a Docker image
Update gradle to build the docker image:
```
buildscript {
...
dependencies {
...
classpath("org.springframework.boot:spring-boot-gradle-plugin:${springBootVersion}")
classpath 'com.bmuschko:gradle-docker-plugin:3.0.3'
}
}
group = 'stelligent'
...
apply plugin: 'application'
apply plugin: 'spring-boot'
apply plugin: 'com.bmuschko.docker-java-application'
docker {
url = 'unix:///var/run/docker.sock'
javaApplication {
baseImage = 'java:8'
maintainer = 'Casey Lee "casey.lee@stelligent.com"'
ports = [8080]
tag = "${project.repoUrl}:${project.revision}"
}
registryCredentials {
def ecrAuthData = new JsonSlurper().parseText('aws ecr get-authorization-token'.execute().text).authorizationData[0]
def credentials = new String(ecrAuthData.authorizationToken.decodeBase64()).tokenize(':')
username = credentials[0]
password = credentials[1]
url = ecrAuthData.proxyEndpoint
}
}
```
Then run:
```
$ gradle dockerBuildImage
```
Run it with:
```
$ docker run -p 8080:8080 -t stelligent/banana-service
```
# Step 6: Deploy to ECS
Setup the stack with:
```
$ gradle platformUp
```
Push latest image to ECR and update the ECS service:
```
$ gradle deploy
```