docker compose override files for testing with locally modified executables.

ci-scripts/yaml_files/5g_rfsimulator/README.md

@@ -535,3 +535,14 @@ snssais:
 ```
 
 The `ST` and `SD` values shall also match.
+
+
+# 6. Running with local changes
+
+You can run the testcase with local changes by substituting the gNB and/or UE executables. The local-override.yaml file  includes an image build service as well as code compilation service.
+This is necessary as the executable has to be linked against the same libraries that are present in the executing image.
+This might take a while the first time but other that that is very fast. Here is a list of commands (wait between each command)
+
+docker compose -f docker-compose.yaml -f local-override.yaml up -d mysql oai-amf oai-smf oai-upf oai-ext-dn
+docker compose -f docker-compose.yaml -f local-override.yaml up -d oai-gnb
+docker-compose -f docker-compose.yaml -f local-override.yaml up -d oai-nr-ue

ci-scripts/yaml_files/5g_rfsimulator/local-override.yaml

+include:
+  - ../local_common_overrides/build_images.yaml
+  - ../local_common_overrides/rebuild_nr_softmodems.yaml
+services:
+  oai-gnb:
+    privileged: true
+    depends_on:
+      rebuild-nr-softmodems:
+        condition: service_completed_successfully
+  oai-nr-ue:
+    privileged: true
+    image: ue-local
+    depends_on:
+      build-ran-build:
+        condition: service_completed_successfully
+        restart: true
+      oai-gnb:
+        condition: service_started
+      rebuild-nr-softmodems:
+        condition: service_completed_successfully
+    container_name: local-oai-nr-ue
+    volumes:
+      - ../../../cmake_targets/ran_build/build/nr-uesoftmodem:/opt/oai-nr-ue/bin/nr-uesoftmodem
+      - ../../../cmake_targets/ran_build/build/librfsimulator.so:/usr/local/lib/librfsimulator.so 
+      - ../../../crashdumps/:/cores/

ci-scripts/yaml_files/5g_rfsimulator_tdd_dora/local-override.yaml

+include:
+  - ../local_common_overrides/build_images.yaml
+  - ../local_common_overrides/rebuild_nr_softmodems.yaml
+services:
+  oai-gnb:
+    privileged: true
+    depends_on:
+      rebuild-nr-softmodems:
+        condition: service_completed_successfully
+    # volumes:
+    # replace the gnb executable here
+  oai-nr-ue:
+    privileged: true
+    image: ue-local
+    depends_on:
+      build-ran-build:
+        condition: service_completed_successfully
+        restart: true
+      oai-gnb:
+        condition: service_started
+      rebuild-nr-softmodems:
+        condition: service_completed_successfully
+    container_name: local-oai-nr-ue
+    volumes:
+      - ../../../cmake_targets/ran_build/build/nr-uesoftmodem:/opt/oai-nr-ue/bin/nr-uesoftmodem
+      - ../../../cmake_targets/ran_build/build/librfsimulator.so:/usr/local/lib/librfsimulator.so 
+      - ../../../crashdumps/:/cores/

ci-scripts/yaml_files/local_common_overrides/build_images.yaml

+services:
+  build-ran-base:
+    image: ran-base
+    build:
+      context: ../../../
+      dockerfile: docker/Dockerfile.base.ubuntu20
+      tags:
+        - ran-base
+
+  build-ran-build:
+    image: ran-build
+    build:
+      context: ../../../
+      dockerfile: docker/Dockerfile.build.ubuntu20
+      tags:
+        - ran-build
+    depends_on:
+      build-ran-base:
+        condition: service_completed_successfully
+  
+  build-gnb-image:
+    image: gnb-local
+    build:
+      context: ../../../
+      dockerfile: docker/Dockerfile.gNB.ubuntu20
+      tags:
+        - gnb-local
+    depends_on:
+      build-ran-build:
+        condition: service_completed_successfully
+    entrypoint: ""
+    command: echo "gnb-image built"
+
+  build-ue-image:
+    image: ue-local
+    build:
+      context: ../../../
+      dockerfile: docker/Dockerfile.nrUE.ubuntu20
+      tags:
+        - ue-local
+    depends_on:
+      build-ran-build:
+        condition: service_completed_successfully
+    entrypoint: ""
+    command: echo "ue-image built"

ci-scripts/yaml_files/local_common_overrides/rebuild_nr_softmodems.yaml

+services:
+  rebuild-nr-softmodems:
+    image: ran-build
+    volumes:
+      - ../../../:/oai-dir/
+    command:
+      bash -c "cd /oai-dir/ && mkdir -p cmake_targets/ran_build/build && cd cmake_targets/ran_build/build && cmake ../../../ -GNinja && cmake --build . --target nr-uesoftmodem rfsimulator nr-softmodem"
+    entrypoint: ""
+    depends_on:
+      build-gnb-image:
+        condition: service_completed_successfully
+      build-ue-image:
+        condition: service_completed_successfully