Gitiles
Code Review Sign In
gerrit.opencord.org / xos / be5ee1cfa362bf8a9fe5f8fcbf6ef927c10d68a1
commitbe5ee1cfa362bf8a9fe5f8fcbf6ef927c10d68a1[log] [tgz]
authorZack Williams <zdw@opennetworking.org>Mon Mar 18 15:33:07 2019 -0700
committerZack Williams <zdw@opennetworking.org>Tue Mar 19 14:03:51 2019 -0700
tree4656f774928f0b09f1b7897ec0ce25e1072bf6e1
parent23938ab206b174eedcbcd7961391b4c1b65ed3eb [diff]
[SEBA-496]

Update pip packages used in XOS containers, flatten containers
Fixed invalid YAML generated by xosgenx modeldefs.xtarget

Change-Id: Ic051170f3f9ef5a5d0dbba61aa6843458a435d49
26 files changed
tree: 4656f774928f0b09f1b7897ec0ce25e1072bf6e1
  1. .dockerignore
  2. .gitignore
  3. .gitreview
  4. LICENSE.txt
  5. Makefile
  6. README.md
  7. VERSION
  8. book.json
  9. containers/
  10. docs/
  11. lib/
  12. scripts/
  13. tox.ini
  14. xos/
README.md

XOS

XOS is a framework for operationalizing a collection of disaggregated services. It is packaged as a project in the Open CORD initiative, with source code managed through https://gerrit.opencord.org. It is also mirrored at https://github.com/opencord.

You can download and use XOS either as part of CORD (see the CORD Guide for details) or as a standalone component (see the XOS Guide for details).

Also visit the XOS Wiki Page for additional information.

Testing the XOS Core

Run make test to run all tests on the XOS codebase. This is what happens during the verify_xos_unit-test job in Jenkins.

Running these tests requires:

  • A Python 2.7, and one or more of Python 3.5, 3.6, or 3.7 development environment
    • Requires a C build system and the python header files (under ubuntu 16.04, apt install python2-dev python3-dev build-essential) to build packages with C extensions.
  • virtualenv
  • tox version 3.2 or later

This will run 3 sets of test targets, which can also be run individually:

  • lib-test: runs tox on each of the library modules stored in lib. These are tested against both Python 2 and 3 by running both nose2 and flake8.

    If you are making changes only to a specific library, it is recommended that you run tox directly inside that modules directory, which should run much more quickly than testing all the libraries.

  • xos-test: runs nose2 to test the xos directory. This code is not yet Python 3 or flake8 clean.

  • migration-test: Runs the xos-migrate tool on the XOS core modules. This verifies that the Django migrations have been properly created. If you've changed xosgenx or the core.xproto file you may need to generate new migrations. See docs/dev/xosmigrate.md for more information.

Additionally, a virtualenv will be created in venv-xos - you can source ./venv-xos/bin/activate if you'd like to run tools like xos-migrate manually.

Issues you may encounter when developing XOS

Testing errors that complain about missing compliers or header files: src/twisted/test/raiser.c:4:20: fatal error: Python.h: No such file or directory

You probably need to install a C build system and the Python development headers.

After making changes to the requirements.txt or other files, the changes don't seem to be register

You might need to clean up any files left behind by previous development work. make clean in the root Makefile should clean up most files. Additionally, git clean -ixd will let you interactively remove all ignored files and directories from your source tree.