WIP: API doc via SwaggerUI

adapter/build.gradle

@@ -46,6 +46,7 @@ dependencies {
 	implementation 'com.fasterxml.jackson.dataformat:jackson-dataformat-csv'
 	implementation 'org.postgresql:postgresql'
 
+  compile group: 'io.springfox', name: 'springfox-swagger2', version: '2.9.2'
 
 	testImplementation 'org.springframework.boot:spring-boot-starter-test'
 }

adapter/src/main/java/org/jvalue/ods/adapterservice/config/SwaggerConfig.java

@@ -0,0 +1,23 @@
+package org.jvalue.ods.adapterservice.config;
+
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import springfox.documentation.builders.PathSelectors;
+import springfox.documentation.builders.RequestHandlerSelectors;
+import springfox.documentation.spi.DocumentationType;
+import springfox.documentation.spring.web.plugins.Docket;
+import springfox.documentation.swagger2.annotations.EnableSwagger2;
+
+@Configuration
+@EnableSwagger2
+public class SwaggerConfig {
+
+  @Bean
+  public Docket api() {
+    return new Docket(DocumentationType.SWAGGER_2)
+      .select()
+      .apis(RequestHandlerSelectors.any())
+      .paths(PathSelectors.any())
+      .build();
+  }
+}

core/build.gradle

@@ -24,5 +24,7 @@ dependencies {
 	implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
 	implementation 'org.postgresql:postgresql'
 
+  compile group: 'io.springfox', name: 'springfox-swagger2', version: '2.9.2'
+
 	testImplementation 'org.springframework.boot:spring-boot-starter-test'
 }

core/src/main/java/org/jvalue/ods/coreservice/config/SwaggerConfig.java

@@ -0,0 +1,23 @@
+package org.jvalue.ods.coreservice.config;
+
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import springfox.documentation.builders.PathSelectors;
+import springfox.documentation.builders.RequestHandlerSelectors;
+import springfox.documentation.spi.DocumentationType;
+import springfox.documentation.spring.web.plugins.Docket;
+import springfox.documentation.swagger2.annotations.EnableSwagger2;
+
+@Configuration
+@EnableSwagger2
+public class SwaggerConfig {
+
+  @Bean
+  public Docket api() {
+    return new Docket(DocumentationType.SWAGGER_2)
+      .select()
+      .apis(RequestHandlerSelectors.any())
+      .paths(PathSelectors.any())
+      .build();
+  }
+}

docker-compose.yml

@@ -141,11 +141,6 @@ services:
       DATABASE_USER: ods_admin
       DATABASE_PW: ods_pw
 
-  storage-swagger: # API documentation for storage service
-    image: swaggerapi/swagger-ui
-    environment:
-      API_URL: http://localhost:9400/
-
   # ----------------- TRANSFORMATION SERVICE (/transformation) --------------------
   transformation:
     image: ${DOCKER_REGISTRY}/transformation
@@ -197,3 +192,15 @@ services:
       - "9001:8080"   # The Web UI (enabled by --api)
     volumes:
       - /var/run/docker.sock:/var/run/docker.sock # So that Traefik can listen to the Docker events
+
+# --------------------- SWAGGER UI -----------------------------------------
+  swagger:
+    image: swaggerapi/swagger-ui
+    environment:
+      API_URLS: "[{ url: '/api/storage', name: 'storage' }, { url: '/api/core/v2/api-docs', name: 'core' }, { url: '/api/adapter/v2/api-docs', name: 'adapter' }, { url: '/api/scheduler/api-docs', name: 'scheduler' }, { url: '/api/transformation/api-docs', name: 'transformation' }]"
+    labels:
+      - "traefik.enable=true"
+      - "traefik.http.routers.to-swagger.rule=PathPrefix(`/api/docs`)"
+      - "traefik.http.routers.to-swagger.middlewares=swagger-stripprefix@docker"
+      - "traefik.http.middlewares.swagger-stripprefix.stripprefix.prefixes=/api/docs/" # without last slash: api/docs does not work, only api/docs/
+      - "traefik.http.services.swagger.loadbalancer.server.port=8080"