Build Swagger UI docs.

.gitlab-ci.yml

+image: alpine:latest
+
+stages:
+  - bundle
+  - deploy
+
+variables:
+  API_ROOT_FILE: ./src/swagger/swagger.yaml
+  BUNDLED_JSON_FILE: ./public/api.json
+
+cache:
+  paths:
+    - ./node_modules
+
+bundle_and_test:
+  stage: bundle
+  before_script:
+    - apk add --update npm
+    - npm install -g @apidevtools/swagger-cli
+
+  script:
+    - mkdir public
+    - swagger-cli bundle -t json $API_ROOT_FILE > $BUNDLED_JSON_FILE
+    - swagger-cli validate $BUNDLED_JSON_FILE
+
+  artifacts:
+    paths:
+      - public
+    expire_in: 2 days
+  only:
+    - develop
+
+pages:
+  stage: deploy
+  before_script:
+    - apk add --update npm
+    - npm install swagger-ui-dist@3.22.1
+  script:
+    - cp -rp node_modules/swagger-ui-dist/* ./public
+    - 'sed -i "s@.*url.*@url: \"api.json\",@" ./public/index.html'
+  artifacts:
+    paths:
+      - public
+    expire_in: 2 days
+  only:
+    - develop