feat: config gNBs and UPFs

[patriciareinoso]

Inventory Service

This feature adds endpoints to configure gNBs and UPFs.

gNB

• GET /config/v1/inventory/gnb
• POST inventory/gnb/:gnb-name
• DELETE inventory/gnb/:gnb-name

UPF

• GET /config/v1/inventory/upf
• POST inventory/gnb/:upf-hostname
• DELETE inventory/gnb/:upf-hostname

Usage

gNB

Get all gNBs

curl -v "${WEBUI_IP}:5000/config/v1/inventory/gnb"

Add a new gNB. tac parameter is mandatory.

curl -v "${WEBUI_IP}:5000/config/v1/inventory/gnb/gnb-2" \
--header 'Content-Type: application/json' \
--data '{
  "tac": "123"
}'

Remove a gNB.

curl -v -X DELETE "${WEBUI_IP}:5000/config/v1/inventory/gnb/gnb-2"

UPF

Get all UPFs

curl -v "${WEBUI_IP}:5000/config/v1/inventory/upf"

Add a new UPF. port parameter is mandatory.

curl -v "${WEBUI_IP}:5000/config/v1/inventory/upf/upf-1" \
--header 'Content-Type: application/json' \
--data '{
  "port": "123"
}'

Remove a UPF.

curl -v -X DELETE "${WEBUI_IP}:5000/config/v1/inventory/upf/upf-1"

Rationale

Canonical builds its own UI for WebConsole (we call it NMS). The NMS needs to retrieve a list of UPF and gNB to configure Network Slices, these parameters can be dynamically configured. Since the NMS is exported in static files and served by the Webconsole (#191), the NMS needs to retrieve these parameters from a webconsole service.

[thakurajayL]

Provide sample UPF list file and gNB list file.

[patriciareinoso]

@gruyaume these changes do not use the build tag ui. is that ok?

[gruyaume]

@gruyaume these changes do not use the build tag ui. is that ok?

I think that's fine, they are not directly related to the ui and they won't break any existing behaviour.

[gruyaume]

Approving assuming this has been tested manually as well

[gruyaume]

Thank you for the tests :)

[patriciareinoso]

@thakurajayL can we move forward with this PR?

[thakurajayL]

DO you plan to port as 8805 or some other non standard port? SMF may be using default 8805 port.

[patriciareinoso]

We are using port 8805 and we intend to maintain consistency with the SMF by using the same port.

[thakurajayL]

Would like to know how UPF port is used and what it should be.

[patriciareinoso]

The UPF port is specified in the parameters when creating a new network slice.

    "upf": {
      "upf-name": "upf-external.testpcf.svc.cluster.local",
      "upf-port": "8805"
    }

We are keeping the UPF parameters consistent with what is asked for network slice creation, even if we use 8805.