Add free5GC as an example CNF

[marketa-zejdova]

Description

Introduce free5GC as an example CNF that is fully deployable and testable via the CNTi test suite.

Issues:

Refs: #2374

How has this been tested:

• Covered by existing integration testing
• Added integration testing to cover
• Verified all A/C passes
  • develop
  • master
  • tag/other branch
• Test environment
  • Shared Packet K8s cluster
  • New Packet K8s cluster
  • Kind cluster
• Have not tested

Types of changes:

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation update

Checklist:

Documentation

• My change requires a change to the documentation.
• I have updated the documentation accordingly.
• No updates required.

Code Review

• Does the test handle fatal exceptions, ie. rescue block

Issue

• Tasks in issue are checked off

[collivier]

@marketa-zejdova could we leverage public helm charts instead of duplicating all files in our tree ?

[collivier]

+ it would be great to cover this example cnf via gate jobs

[marketa-zejdova]

@marketa-zejdova could we leverage public helm charts instead of duplicating all files in our tree ?

For now, I used a local copy of the free5GC Helm chart as a temporary solution. The upstream chart is still missing some changes needed for this deployment to work reliably (mainly MongoDB storage and kind compatibility).

I also had to make a few adjustments on our side to get it running on kind.

Because of that, I didn’t want to pull the chart directly from their development branch, as it could introduce breaking changes.

I agree that copying the chart is not ideal long-term. Would it be better to reference a public Helm repository here, or possibly publish a stabilized version of this chart somewhere (if we have an internal Helm registry)?

[marketa-zejdova]

• it would be great to cover this example cnf via gate jobs

I agree this would be useful. We are planning to handle it in a follow-up PR.

[collivier]

That seems very good but Isn't the gtp part missing in this PR ?

2026-04-28T14:32:31.378359855Z [INFO][UPF][CFG] ==================================================
2026-04-28T14:32:31.378365705Z [INFO][UPF][Main] Log level is set to [info]
2026-04-28T14:32:31.378371000Z [INFO][UPF][Main] Report Caller is set to [false]
2026-04-28T14:32:31.378393793Z [INFO][UPF][Main] starting Gtpu Forwarder [gtp5g]
2026-04-28T14:32:31.378401749Z [INFO][UPF][Main] GTP Address: "10.244.2.3:2152"
2026-04-28T14:32:31.381402985Z [ERRO][UPF][Main] UPF Cli Run Error: open Gtp5g: open link: create: operation not supported

Is he kernel module loaded in your env ?

[marketa-zejdova]

That seems very good but Isn't the gtp part missing in this PR ?

2026-04-28T14:32:31.378359855Z [INFO][UPF][CFG] ==================================================
2026-04-28T14:32:31.378365705Z [INFO][UPF][Main] Log level is set to [info]
2026-04-28T14:32:31.378371000Z [INFO][UPF][Main] Report Caller is set to [false]
2026-04-28T14:32:31.378393793Z [INFO][UPF][Main] starting Gtpu Forwarder [gtp5g]
2026-04-28T14:32:31.378401749Z [INFO][UPF][Main] GTP Address: "10.244.2.3:2152"
2026-04-28T14:32:31.381402985Z [ERRO][UPF][Main] UPF Cli Run Error: open Gtp5g: open link: create: operation not supported

Is he kernel module loaded in your env ?

You’re right, I had it loaded in my env. I added UPF kernel requirements part into the README. Is that sufficient like that?

[martin-mat]

lgtm

[collivier]

make install is enough

[collivier]

@marketa-zejdova thank you for the update. please take my last comment into a 2nd PR if needed. It was merged very quickly. good work!

https://github.com/free5gc/gtp5g/blob/master/Makefile#L88