Gitiles
Code Review Sign In
gerrit.opencord.org / xos / 89704b1455f843eadb2832109ba7e511d2b8e98c
commit89704b1455f843eadb2832109ba7e511d2b8e98c[log] [tgz]
authorScott Baker <smbaker@gmail.com>Tue May 07 16:42:11 2019 -0700
committerScott Baker <smbaker@gmail.com>Tue May 14 13:33:17 2019 -0700
treede98b12283dff8a18275de07279f4c0856451bb0
parent4447685930b6d7d2344e60c0e4965b7e4e61040a [diff]
SEBA-580 Add uuid to backupoperation;
Add version endpoint

Change-Id: I7e2877332e7005fc74b3fda7cfb16a8cbf9c4b64
12 files changed
tree: de98b12283dff8a18275de07279f4c0856451bb0
  1. .dockerignore
  2. .gitignore
  3. .gitreview
  4. Dockerfile.client
  5. Dockerfile.core
  6. LICENSE.txt
  7. Makefile
  8. README.md
  9. VERSION
  10. book.json
  11. docs/
  12. lib/
  13. requirements.txt
  14. scripts/
  15. testservice/
  16. tox.ini
  17. 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.