compile("io.springfox:springfox-swagger2:2.2.2")
compile("io.springfox:springfox-swagger-ui:2.2.2")

@SpringBootApplication
@EnableSwagger2 (1)
public class Application {

  public static void main(String[] args) {
    SpringApplication.run(Application.class, args);
  }

  @Bean (2)
  public Docket api() {
    return new Docket(DocumentationType.SWAGGER_2).apiInfo(apiInfo()).select().paths(regex("/accountsvc.*")).build();
  }

  private ApiInfo apiInfo() {
    return new ApiInfoBuilder().title("Spring REST Sample with Swagger").description("Spring REST Sample with Swagger")
        .termsOfServiceUrl("http://dockerhost:8100/termsofservice").contact("service@ericsson.com")
        .license("Apache License Version 2.0").licenseUrl("http://dockerhost:8100/LICENSE").version("2.0").build();
  }
}

@Api(value = "accountsvc", description = "Endpoint for account management") (1)
@RequestMapping(value = "/accountsvc")
class AccountController {
  @ApiOperation(value = "list accounts", notes = "Lists all accounts. Account informtion contains id, name and email.",
          produces = "application/json") (2)
  @ApiResponses(value = { @ApiResponse(code = 200, message = "Success", response = Account.class) }) (3)
  @RequestMapping(method = GET, path = "/accounts", produces = "application/json")
  ResponseEntity<List<Account>> get() {
    return new ResponseEntity<List<Account>>(account, OK);
  }

  @ApiOperation(value = "look up  account by id", notes = "Looks up account by id.")
  @ApiImplicitParams({ @ApiImplicitParam(name = "id", value = "Account id", required = true, dataType = "int",
          paramType = "path", defaultValue = "1") }) (4)
  @ApiResponses(value = { @ApiResponse(code = 200, message = "Success", response = Account.class) })
  @RequestMapping(method = GET, path = "/accounts/{id}", produces = "application/json")
  ResponseEntity<Account> getById(@PathVariable int id) throws Exception {
    return new ResponseEntity<Account>(account.get(id - 1), OK);
  }

  @ApiOperation(value = "add new account", nickname = "Add a new account", response = Void.class)
  @ApiResponses(value = { @ApiResponse(code = 201, message = "Success", response = Account.class) })
  @RequestMapping(value = "/accounts", method = POST, produces = "application/json", consumes = "application/json")
  ResponseEntity<Account> post(@ApiParam(value = "Created Account object")
                               @RequestBody Account body) { (5)
    account.add(body);
    return new ResponseEntity<Account>(body, CREATED);
  }

  @ApiOperation(value = "update an Account", nickname = "Updates existing account with new name and/or email",
          response = Void.class)
  @ApiResponses(value = { @ApiResponse(code = 201, message = "Success", response = Account.class) })
  @RequestMapping(value = "/accounts/{id}", method = PUT, produces = "application/json", consumes = "application/json")
  ResponseEntity<Account> put(@PathVariable int id,
      @ApiParam(value = "Updated Account object") @RequestBody Account body) {
    account.remove(id - 1);
    account.add(body);
    return new ResponseEntity<Account>(body, OK);
  }

  @ApiOperation(value = "delete account", notes = "Deletes account by id")
  @RequestMapping(value = "/accounts/{id}", method = DELETE)
  @ApiResponses(value = { @ApiResponse(code = 400, message = "Account not found", response = void.class) })
  void delete(@PathVariable int id) throws Exception {
    if (id <= account.size()) {
      account.remove(id - 1);
    } else {
      throw new AccountException("Account not found");
    }
  }
@ApiModel( value = "Account", description = "Account resource representation" ) (6)
class Account {
  @ApiModelProperty( value = "Account id", required = true )
  private int id;

  @ApiModelProperty( value = "Account name", required = true )
  private String name;

  @ApiModelProperty( value = "Account email", required = false )
  private String email;

  public Account() {
  }

server:
  port: 8100

endpoints:
  health:
    sensitive: false
  shutdown:
    enabled: true

$ gradle prepDocker
...
:prepDocker
Run command: docker build -t msvcdojo/accounts-service:0.0.1 build/docker

BUILD SUCCESSFUL

$ docker build -t msvcdojo/accounts-service:0.0.1 build/docker
Sending build context to Docker daemon 12.95 MB
Step 1 : FROM java:8
Step 2 : MAINTAINER Igor Moochnick "igor@igorshare.com"
Step 3 : VOLUME /tmp
Step 4 : EXPOSE 8100
Step 5 : ADD accountsvc-0.0.1.jar accountsvc.jar
Step 6 : ENTRYPOINT java -Djava.security.egd=file:/dev/./urandom -jar /accounts-service.jar
Successfully built cb55f79088db

$ docker images
REPOSITORY                  TAG                 IMAGE ID            CREATED             VIRTUAL SIZE
msvcdojo/accounts-service   0.0.1               fdb0ace78a40        2 minutes ago       660.6 MB

$ curl http://localhost:8100/v2/api-docs

{
    "swagger": "2.0",
    "info": {
    "description": "Spring REST Sample with Swagger",
    "version": "2.0",
    "title": "Spring REST Sample with Swagger",
        ...
        },
"host": "localhost:8100",
"basePath": "/",
"tags": [{
    "name": "accountsvc",
    "description": "Endpoint for account management"
}
"paths": {
    "/accountsvc/delete/{id}": {
                "delete": {
                        "tags": ["accountsvc"],
                        "summary": "delete Account By Id",
                        "description": "Deletes an account by passing accountId",
                        "operationId": "deleteUsingDELETE",
                        "consumes": ["application/json"],
                        "produces": ["*/*"],
                        ...
                        }
                }
        }
}

$ curl http://localhost:8100/swagger-ui.html