X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?a=blobdiff_plain;f=docs%2Fdeveloper-guide.rst;h=f2db426ac82c21fb0268810a272f8ca4418a475f;hb=6a289e8ccf5816ac6b5de417d6edffcb7b024471;hp=2f2447c4f06bcc2b1267965e29b2f8046f60d530;hpb=39c9ab62125be03194b4c433b4f9fa4617d0a65d;p=ric-plt%2Fa1.git diff --git a/docs/developer-guide.rst b/docs/developer-guide.rst index 2f2447c..f2db426 100644 --- a/docs/developer-guide.rst +++ b/docs/developer-guide.rst @@ -11,88 +11,25 @@ Developer Guide Tech Stack ---------- -The A1 Mediator is implemented in Python, currently version 3.8, and -depends on these third-party packages and technologies: +The A1 Mediator is implemented in Golang. -- OpenAPI3 -- Connexion -- Flask with Gevent serving -- Swagger -Version bumping A1 ------------------- +Running A1 Standalone +--------------------- -This project follows semver. When the version string changes, these -files must be updated: +The A1 container can be run standalone, which means using an in-memory mock +version of SDL and a static route table. The host machine must have the RMR +library and the environment must define the variable `prometheus_multiproc_dir` +with a value like /tmp. Alternately, use the following command to run A1 as +a Docker container, using a route table mounted as a file from this git +repository and exposing the server's HTTP port on the Docker host:: -#. ``setup.py`` -#. ``container-tag.yaml`` -#. ``integration_tests/a1mediator/Chart.yaml`` -#. ``docs/release-notes.rst`` -#. ``a1/openapi.yaml`` But note this is an API version, not a software version; there's no need to bump on non-API changes. -#. And over in the ric-plt/ric-dep repo that contains the A1 Mediator helm chart, files ``values.yaml`` and ``Chart.yaml``. + docker run -e USE_FAKE_SDL=True -p 10000:10000 -v `pwd`:/opt/route [DOCKER_IMAGE_ID_HERE] -It's convenient to use the Python utility `bumpversion` to maintain -the first three items. After setup (``pip install bumpversion``) you -can change the patch version like this:: +Then test the server with an invocation such as this:: - bumpversion --verbose patch + curl localhost:10000/a1-p/healthcheck -Or change the minor version like this:: - - bumpversion --verbose minor - -After the `bumpversion` utility has modified the files, update the -release notes then commit. - - -Version bumping RMR -------------------- - -A1 (Dockerfile), Dockerfile-Unit-Test, and all three integration test -receivers use an Alpine base image and install RMR from a base builder -image. Must update and rebuild all 5 containers in the A1 repo (or -just A1 itself for production usage). - -In addition these items in this repo must be kept in sync: - -#. ``rmr-version.yaml`` controls what rmr gets installed for unit - testing in Jenkins -#. ``integration_tests/install_rmr.sh`` is a useful script for a - variety of local testing. - -Version bumping Python ----------------------- - -If you want to update the version of python; for example this was -recently done to move from 3.7 to 3.8, update these files: - -#. ``Dockerfile`` -#. ``Dockerfile-Unit-Test`` -#. ``tox.ini`` - -Unit Testing ------------- - -Running the unit tests requires the python packages ``tox`` and ``pytest``. - -The RMR library is also required during unit tests. If running -directly from tox (outside a Docker container), install RMR using the -script in the integration_tests directory: ``install_rmr.sh``. - -Upon completion, view the test coverage like this: - -:: - - tox - open htmlcov/index.html - -Alternatively, you can run the unit tests in Docker (this is somewhat -less nice because you don't get the pretty HTML) - -:: - - docker build --no-cache -f Dockerfile-Unit-Test . Integration testing -------------------