From a245d58cf2bedd7e5e000eabd1c05fdb142a1d63 Mon Sep 17 00:00:00 2001 From: Borjis131 Date: Tue, 2 Jul 2024 09:23:35 +0200 Subject: [PATCH] Update README.md and docs/configuration.md --- README.md | 2 +- docs/configuration.md | 33 +++++++++++++++++++++++++++++++-- 2 files changed, 32 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 3534652..277fd68 100644 --- a/README.md +++ b/README.md @@ -18,7 +18,7 @@ The Helm charts are available: ## Configure it -All the images (except `webui`) depend on the `base-open5gs` image to be built, after that each image is indepent. +All the images (except `webui`) depend on the `base-open5gs` image to be built, after that each image is independent. First, update the `.env` and `docker-bake.hcl` files with the desired values to use. diff --git a/docs/configuration.md b/docs/configuration.md index 73d3466..36212ba 100644 --- a/docs/configuration.md +++ b/docs/configuration.md @@ -25,6 +25,7 @@ You can use the Open5GS `open5gs-dbctl` script in the host to add users to the d The database Docker volume is marked with a label `org.open5gs.mongodb_version` indicating the `MONGODB_VERSION` selected in the `.env` file. This marks the version used for the mongo container. This label is needed to debug issues with users changing the mongo container version but keeping the Docker volumes created. +> [!WARNING] > When upgrading/downgrading the `MONGODB_VERSION` the existing `open5gs_db_data` and `open5gs_db_config` Docker volumes could cause problems/crashing. It is recommended to remove them. ### Network Function configuration @@ -68,8 +69,8 @@ global: mnc: "01" tac: 1 s_nssai: - sst: 1 - sd: "000001" + - sst: 1 + sd: "000001" dataNetwork: subnet: 10.45.0.0/16 gateway: 10.45.0.1 @@ -138,6 +139,34 @@ Each subchart comes defined with a value `enabled`, set it to true to deploy tha This chart needs a Kubernetes PersistentVolume created for the database. You can create it "by hand" or use an StorageClass. An example of this PersistentVolume can be found on `misc/examples/k8s-db-pv/persistentvolume.yaml`. +You can also define your StorageClass using the following syntax on the database configuration. The following example lets you change the container image for the database Helm chart, configure the service to use a NodePort and use the storageClass `local-path` to create the Kubernetes PersistentVolume: + +```yaml +db: + enabled: true + image: + registry: ghcr.io + repository: borjis131/db + tag: "6.0.11" + services: + db: + type: NodePort + nodePort: 30007 + storage: + volumeClaimTemplate: + spec: + storageClassName: "local-path" + resources: + requests: + storage: 2Gi + accessModes: + - ReadWriteOnce +``` +> [!NOTE] +> In this example, the local-path StorageClass being used comes from [here](https://github.com/rancher/local-path-provisioner) + +Find a complete example to work with Raspberry Pi on `misc/examples/open5gs-chart/values.yaml`. + ## Specific Network Function configuration ### AMF configuration