Skip to content

Latest commit

 

History

History
138 lines (97 loc) · 3.72 KB

README.md

File metadata and controls

138 lines (97 loc) · 3.72 KB
Raw

subscription-manager

The Subscription Manager package provides programs and libraries to allow users to manage subscriptions and yum repositories from the Candlepin.

Local Installation

In order to build, develop, and test locally, please follow instructions at candlepinproject.org.

For instructions on building the debian-packages of this project, see instructions in contrib/debian/README.source.

Due to unintuitive behavior with sys.path (see https://github.com/asottile/scratch/wiki/PythonPathSadness), python src/subscription_manager/scripts/subscription_manager.py does not work as expected. One can run the script like this instead:

PYTHONPATH=./src python -m subscription_manager.scripts.subscription_manager

Similar for other bin scripts:

PYTHONPATH=./src python -m subscription_manager.scripts.rct
# ... etc.

(You can also just export PYTHONPATH instead of setting it in each command).

Pipenv

There is experimental support for installation of subscription-manager using Pipenv. We tested installing subscription-manager using Pipenv only on following operating systems:

  • Fedora 30
  • RHEL/CentOS 7
  • RHEL/CentOS 8

We tested pipenv with Python 2 and Python 3. It is necessary to install following packages to your system, because binary module have to be compiled in virtual environment:

Python 2

dnf install -y pipenv gcc make python2-devel \
    openssl-devel intltool libnl3-devel

Python 3

dnf install -y pipenv gcc make python3-devel \
    openssl-devel intltool libnl3-devel

You can create virtual environment using following steps:

  1. Create virtual environment using Python 2 or Python 3 and it is necessary to use --site-packages argument, because virtual environment has to use rpm Python package installed in your system. It is not possible to install rpm Python package to virtual environment using pip/pipenv.

    Python 2:

    pipenv --site-packages --two

    Python 3:

    pipenv --site-packages --three

  2. Install required Python packages defined in Pipfile into virtual environment:

    pipevn install

  3. Start virtual environment:

    pipenv shell

  4. Build binary modules in virtual environment:

    python ./setup.py build

  5. Install subscription-manager into virtual environment:

    python ./setup.py install

  6. It should be possible to run subscription-manager in virtual environment

    sudo subscription-manager version

Development of the Subscription-Manager Deployment Ansible role

The Ansible role that is used for deploying subscription-manager can be found at https://github.com/candlepin/ansible-role-subman-devel. In order to test changes for this Ansible role you will need to check it out locally. This will pull the latest commit from this path and use it for deployment.

Cockpit

From the directory cockpit, the following commands can be used:

  • yarn install - fetch dependencies, and update the lockfile if necessary.
  • npm run build - do a build of the JavaScript source.
  • npm run watch - monitor the source for changes and rebuild the cockpit plugin when necessary.

See cockpit/README.md for more detailed information on cockpit development.

Testing

We run tests using pytest. See TESTING.md for more details.