MSB

Microservices Bus(MSB) provides a reliable, resilient and scalable communication and governance infrastructure to support ONAP Microservice Architecture including service registration/discovery, external API gateway, internal API gateway, client SDK, Swagger SDK, etc. It’s a pluggable architecture, plugins can be added to MSB to provide whatever functionalities you need, such as an auth plugin can be used to provide centralized authentication & authorization. MSB also provides a service portal to manage the REST APIs.

MSB is platform independent, while it is integrated with Kubernetes(OOM) to provide transparent service registration for ONAP microservices, MSB also supports OpenStack(Heat) and bare metal deployment.

Release Notes

Version: 1.2.4 Dublin Release

Release Date:2019-06-10

New Features

This release only contains some security improvements and a few fixes.

Security improvements * MSB-295 Nexus IQ Issue: bootstrap * MSB-320 Run API Gateway as a non-root user * MSB-321 Run Discovery as a non-root user * MSB-322 Run Kube2msb as a non-root user * MSB-328 Security issue reported by Nexus-iq : jetty-http * MSB-329 Security issue reported by Nexus-iq : spring-core * MSB-330 Security issue reported by Nexus-iq : commons-beanutils * MSB-331 Jackson datatype security issue

Bug Fixes

  • `MSB-98 No information is available to select proper node IP from registered services

    System Message: WARNING/2 (/home/docs/checkouts/readthedocs.org/user_builds/onap/checkouts/latest/docs/submodules/msb/apigateway.git/docs/release-notes.rst, line 36); backlink

    Inline interpreted text or phrase reference start-string without end-string.

  • `MSB-281 improve CLM for swagger sdk

    System Message: WARNING/2 (/home/docs/checkouts/readthedocs.org/user_builds/onap/checkouts/latest/docs/submodules/msb/apigateway.git/docs/release-notes.rst, line 37); backlink

    Inline interpreted text or phrase reference start-string without end-string.

  • `MSB-325 consul container is outdated

    System Message: WARNING/2 (/home/docs/checkouts/readthedocs.org/user_builds/onap/checkouts/latest/docs/submodules/msb/apigateway.git/docs/release-notes.rst, line 38); backlink

    Inline interpreted text or phrase reference start-string without end-string.

  • `MSB-326 non STAGING version on master

    System Message: WARNING/2 (/home/docs/checkouts/readthedocs.org/user_builds/onap/checkouts/latest/docs/submodules/msb/apigateway.git/docs/release-notes.rst, line 39); backlink

    Inline interpreted text or phrase reference start-string without end-string.

Known Issues

Security Notes

MSB code has been formally scanned during build time using NexusIQ and all Critical vulnerabilities have been addressed. The remaining issues are identified as false positive and their risk assessment have been documented as part of the project.

Quick Links:

Upgrade Notes

N/A

Deprecation Notes

N/A

Other

N/A

Version: 1.2.3

Release Date:2018-11-30

New Features

In Casablanca Release, MSB mainly focuses on the integration of Istio service mesh with ONAP to enhance OMSA, while keeping the Istio integration compatible with the existing MSB API Gateway approaches.

How to manage ONAP microservices with Istio service mesh:

Bug Fixes

  • MSB-196 IUI displays raw placeholder texts when failed to load translation
  • MSB-291 Incomplete Apache-2.0 header
  • MSB-293 Portal to MSB pairwise test failing in WindRiver with OOM deployment
  • MSB-294 Nexus IQ Issue: okhttp3
  • MSB-296 Nexus IQ Issue: guava
  • MSB-297 MSB CSIT failed
  • MSB-298 Release MSB artifact version 1.2.0
  • MSB-300 Incomplete Apache-2.0 header
  • MSB-301 Can’t access aai resource http url via msb api gateway

Known Issues

  • MSB-295 Nexus IQ Issue: bootstrap
  • MSB-198 MSB GUI can not register a service mapped to an HTTPS endpoint

Security Notes

System Message: WARNING/2 (/home/docs/checkouts/readthedocs.org/user_builds/onap/checkouts/latest/docs/submodules/msb/apigateway.git/docs/release-notes.rst, line 13); backlink

Duplicate explicit target name: “project”.

MSB code has been formally scanned during build time using NexusIQ and all Critical vulnerabilities have been addressed, items that remain open have been assessed for risk and actions to be taken in future release. The MSB open Critical security vulnerabilities and their risk assessment have been documented as part of the project.

Quick Links:

Upgrade Notes

N/A

Deprecation Notes

N/A

Other

N/A

Version: 1.1.0

Release Date:2018-06-07

New Features In Beijing release, MSB project mainly focused on the Platform Maturity requirements of ONAP, including the scalability and security. Some new features which were requested when integrated with other projects, such as websocket support, service registration at K8S Pod level, multiple versions of services, etc. have also been added to this release.

  • MSB-117 Support horizontal scaling
  • MSB-140 Providing HTTPS endpoint at API gateway
  • MSB-146 Support service registration at K8s Pod level
  • MSB-152 MSB JAVA SDK supports HTTPS service registration
  • MSB-156 Support websocket request forwarding
  • MSB-178 Support registering multiple versions under a service name
  • MSB-179 Integration MSB GUI to Portal project

Bug Fixes

  • MSB-92 Microservice delete is reporting 500, though it deleted the service
  • MSB-102 The msb client has heavy dependencies
  • MSB-150 Kube2msb doesn’t unregister service
  • MSB-153 MSB kube2msb registrator does not register LoadBalancer type service
  • MSB-187 MSB discovery API in swagger is not published
  • MSB-195 HTTP protocol used over HTTPS port

Known Issues

N/A

Security Notes

System Message: WARNING/2 (/home/docs/checkouts/readthedocs.org/user_builds/onap/checkouts/latest/docs/submodules/msb/apigateway.git/docs/release-notes.rst, line 13); backlink

Duplicate explicit target name: “project”.

MSB code has been formally scanned during build time using NexusIQ and all Critical vulnerabilities have been addressed, items that remain open have been assessed for risk and determined to be false positive. The MSB open Critical security vulnerabilities and their risk assessment have been documented as part of the project.

Quick Links:

Upgrade Notes

N/A

Deprecation Notes

N/A

Other

N/A

Version: 1.0.0

Release Date:2017-11-16

New Features Initial release of Microservices Bus (MSB) for Open Network Automation Platform (ONAP). MSB provides core functionalities to support ONAP microservices architecture, including SDK for rapid microservie development, infrastructure for service communication and tools for service governance.

The current release of MSB is mainly composed of the following components:

msb/apigateway

Provides client request routing, client request load balancing, transformation, such as https to http, authentication & authorization for service request with plugin of auth service provider, service request logging, service request rate-limiting, service monitoring, request result cache, solve cross-domain issue for web application and other functionalities with the pluggable architecture capability.

msb/discovery

Provides service registration and discovery for ONAP microservices, which leverage Consul and build an abstract layer on top of it to make it agnostic to the registration provider and add needed extension.

msb/java-sdk

Provides a JAVA SDK for rapid microservices development, including service registration, service discovery, request routing, load balancing, retry, etc.

msb/swagger-sdk

Swagger sdk helps to generate swagger.json and java client sdk during the build time, it also helps to provide the swagger.json at the given URI in the run time.

In the future release, MSB plans to provide service mesh for ONAP.

Bug Fixes

  • MSB-94 Vendor name(ZTE) on the MSB Portal tiltle
  • MSB-91 Duplicate class variable in service sub-classes
  • MSB-88 The path parameter has been lost when register services in demo project
  • MSB-87 MSB JAVA SDK dosen’t release stage binary
  • MSB-85 API Gateway UT coverage doesn’t show up in Sonar
  • MSB-74 Jenkins Integration Test job failed
  • MSB-73 Can’t register service by using MSB Api gateway 80 port
  • MSB-72 Unit test coverage data is incorrect
  • MSB-71 API Gateway service Registration and discovery api causes confusion
  • MSB-70 Swagger SDK site job build failed
  • MSB-69 Discovery checkstyle issue
  • MSB-68 Discovery daily build jenkins job failed
  • MSB-67 API Gateway check style warnning
  • MSB-66 API Gateway daily build failed
  • MSB-60 API gateway test coverage data not in snoar
  • MSB-59 Swagger SDK build failed
  • MSB-58 MSB Java SDK Jenkins merge job failed
  • MSB-57 Discovery site jenkins job failed
  • MSB-55 Discovery site jenkins job failed
  • MSB-54 API Gateway site jenkins job failed
  • MSB-21 Merge and daily jenkins job failed
  • MSB-17 Release version java daily job failed

Known Issues

  • MSB-92 Microservice delete is reporting 500, though it deleted the service

Security Issues

None

Upgrade Notes

This is an initial release

Deprecation Notes

N/A

Other

N/A

End of Release Notes