Page History

Sync with Casablanca Unprotected Interfaces

TODO: add protocol to each port - to determine suitability for HTTP/HTTPS or multi-protocol proxy for ingress

NodePorts are used to allow client applications, that run outside of Kubernetes, access to ONAP components deployed by OOM.

A NodePort maps an externally reachable port to an internal port of an ONAP microservice.

It should be noted that the use of NodePorts is temporary. An alternative solution is currently being scoped for the Dublin Release.

But for now, this page is used to track NodePort assignments.

All ONAP project teams that have microservices that need to provide external access for clients, must update this wiki page to reserve NodePorts and prevent ONAP deployment failures due to NodePort conflicts.

If a service is only accessed by other services within the same kubernetes deployment (ie. databases, backend services with no external northbound APIs) then please DO NOT reserve

a NodePort as they are a very limited resource. The service name and its Internal Port (<service name>.port) should be used instead (ie. vid.8443)

To reserve a NodePort search the table below for the text "FREE_PORT".

If it is determined that an existing reservation is no longer required, please add the text "FREE_PORT" to indicate its availability.

Developer Checklist

Verify unused nodeports

Before using a particular nodeport - verify there is no conflict by deploying the entire system and checking services or the tables below.

Get the nodeport of a particular service

# human readable list
kubectl get services --all-namespaces | grep robot
# machine readable number
kubectl get --namespace onap -o jsonpath="{.spec.ports[0].nodePort}" services robot)

Node Port Reservations 302 prefix

Node Port Reservations (304 node port prefix range)

This table is for documenting node ports that are reserved outside of a typical ONAP deployment.

Even though the ports listed below may appear in ONAP Helm Charts, they are not used at runtime unless enabled through configuration.

For example, there may be a need to reserve node ports (even temporarily) for use in POC or for demo code, that currently exists in the ONAP codebase.

This port does not seem to be configurable from a Helm Chart.

Mike Elliott will raise issue to see if it can be made configurable within either the 302 or 304 ranges.

Overview:

20180719: 2 ports left in 302 = 

30259
30269

The purpose of this document is to keep track of which node ports are currently being used by various containers with the intent to make node port allocation of new services easier until we move to dynamic ports for most of the components

These are a list of externally exposed ports in OOM - there are also extensive lists of all internal ports below.

ONAP Services List

http://onap.readthedocs.io/en/latest/submodules/appc.git/docs/APPC%20User%20Guide/APPC%20User%20Guide.html#interfaces-summary

SDC API (older June 2017)

see ONAP on Kubernetes#ListofContainers

kubectl get svc --all-namespaces -o go-template='{{range .items}}{{range.spec.ports}}{{if .nodePort}}{{.name}} | {{.port}} | {{.nodePort}}{{"\n"}}{{end}}{{end}}{{end}}'

Raw output (Not updated)

...

logdemonode

(logging-analtyics project)

...

get svc --all-namespaces -o go-template='{{range .items}}{{range.spec.ports}}{{if .nodePort}}{{.nodePort}} | {{.name}} | {{.port}}{{"\n"}}{{end}}{{end}}{{end}}' | sort

Updated 25 Jul 2018

...

As of 20171109 - filtered to include only containers that expose ports

...

model-loader-service

...

30210

...

30229

...

30232

...

aai-ssl

...

30233

...

APPC

...

appc-9090

...

dgbuilder

...

30228

...

clamp

...

8080

...

30295

...

30254

...

logdemonode

(optional RI example)

...

30280

...

30282

...

30208

...

kubectl get services --all-namespaces | grep nodes

see ONAP on Kubernetes#ListofContainers

...

PREFIX 300

...

PREFIX 302

...

30256 (SDC)

30257 (SDC)

30208 (SDNC)

...

30261 (SDNC)

30262 (SDNC)

30263 (SDNC)

30264 (SDNC)

30265 (SDNC)

30266 (SDNC)

...

30241 (BUSCONTROLLER - http)

30242 (BUSCONTROLLER - https)

...

30246(AAI/ESR)

30247(AAI/ESR)

...

30255 (LOG)

30258 (LOG) logdemonode

...

30275 (OOF-OSDF)

30276 (OOF-HAS-API)

30277 (OOF-HAS-2)

30278 (OOF-HAS-3)

30279 (OOF-HAS-4)

30280 (OOF-HAS-5)

30281 (OOF-HAS-MUSIC)

30284 (CLAMP-DASH-KIBANA)

...

30272 (MYSQL)

30273 (MYSQL)

30234 (POMBA)

30249 (POMBA)

30259 unused

30269 unused

PREFIX 304

...

PREFIX 308

...