MSB can run as docker, it's very handy to try it at your laptop.
Run MSB microservices on the same host using host network
MSB consists of multiple microservices, for testing, the easiest way is to run them in the same host by using host network.
1. Run the Consul dockers.
sudo docker run -d --net=host --name msb_consul consul:0.9.3
2. Run the MSB dockers.
Login the ONAP docker registry first: docker login -u docker -p docker nexus3.onap.org:10001
sudo docker run -d --net=host --name msb_discovery nexus3.onap.org:10001/onap/msb/msb_discovery
sudo docker run -d --net=host -e "ROUTE_LABELS=visualRange:1" --name msb_internal_apigateway nexus3.onap.org:10001/onap/msb/msb_apigateway
3. Explore the MSB portal.
4. Register your REST service to MSB via curl
For testing, we can register the services via curl. MSB is working with OOM team to register the services automatically when deploying the ONAP components.
curl -X POST \
-H "Content-Type: application/json" \
-d '{"serviceName": "aai", "version": "v8", "url": "/aai/v8","protocol": "REST", "path": "/aai/v8", "nodes": [ {"ip": "10.74.215.65","port": "8443"}]}' \
"http://127.0.0.1:10081/api/microservices/v1/services"
5.Access the rest service via api gateway
curl http://127.0.0.1/api/aai/v8/cloud-infrastructure/cloud-regions
Run MSB microservices using default docker network
In case that you don't want to use host network to set up the MSB dockers, you need to export the port and specify the environment variables to let msb components know each other.
1. Run the Consul dockers.
sudo docker run -d -p 8500:8500 --name msb_consul consul:0.9.3
CONSUL_IP=`sudo docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' msb_consul`
2. Run the MSB dockers.
Login the ONAP docker registry first: docker login -u docker -p docker nexus3.onap.org:10001
sudo docker run -d -p 10081:10081 -e CONSUL_IP=$CONSUL_IP --name msb_discovery nexus3.onap.org:10001/onap/msb/msb_discovery
DISCOVERY_IP=`sudo docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' msb_discovery`
sudo docker run -d -p 80:80 -e CONSUL_IP=$CONSUL_IP -e SDCLIENT_IP=$DISCOVERY_IP -e "ROUTE_LABELS=visualRange:1" --name msb_internal_apigateway nexus3.onap.org:10001/onap/msb/msb_apigateway
Run MSB microservices with kubernetes
The chart for MSB running in kubernetes cluster is available here: