This document describes getting the source from keystone’s GitHub repository for development purposes.
To install keystone from packaging, refer instead to Keystone’s User Documentation.
This document assumes you are using:
And that you have the following tools available on your system:
Reminder: If you’re successfully using a different platform, or a different version of the above, please document your configuration here!
Make a clone of the code from our Github repository:
$ git clone https://github.com/openstack/keystone.git
When that is complete, you can:
$ cd keystone
Keystone maintains two lists of dependencies:
The first is the list of dependencies needed for running keystone, the second list includes dependencies used for active development and testing of keystone itself.
However, your system may need additional dependencies that pip (and by extension, PyPi) cannot satisfy. These dependencies should be installed prior to using pip, and the installation method may vary depending on your platform.
$ sudo apt-get install python-dev libxml2-dev libxslt1-dev libsasl2-dev libsqlite3-dev libssl-dev libldap2-dev
$ sudo yum install python-sqlite2 python-lxml python-greenlet-devel python-ldap
Mac OS X Lion (requires MacPorts):
$ sudo port install py-ldap
We recommend establishing a virtualenv to run keystone within. Virtualenv limits the python environment to just what you’re installing as depdendencies, useful to keep a clean environment for working on Keystone. The tools directory in keystone has a script already created to make this very simple:
$ python tools/install_venv.py
This will create a local virtual environment in the directory .venv. Once created, you can activate this virtualenv for your current shell using:
$ source .venv/bin/activate
The virtual environment can be disabled using the command:
You can also use tools\with_venv.sh to prefix commands so that they run within the virtual environment. For more information on virtual environments, see virtualenv.
If you want to run keystone outside of a virtualenv, you can install the dependencies directly into your system from the requires files:
# Install the dependencies for running keystone $ pip install -r tools/pip-requires # Install the dependencies for developing, testing, and running keystone $ pip install -r tools/test-requires # Use python setup.py to link Keystone into python's site-packages $ python setup.py develop
Once set up, either directly or within a virtualenv, you should be able to invoke python and import the libraries. If you’re using a virtualenv, don’t forget to activate it:
$ source .venv/bin/activate $ python
You should then be able to import keystone from your Python shell without issue:
>>> import keystone >>>
If you can import keystone successfully, you should be ready to move on to developing.
[If this is no longer an issue, please remove this section, thanks!]
On some OSes, specifically Fedora 15, the current versions of greenlet/eventlet segfault when running keystone. To fix this, install the development versions of greenlet and eventlet:
$ pip uninstall greenlet eventlet $ cd <appropriate working directory> $ hg clone https://bitbucket.org/ambroff/greenlet $ cd greenlet $ sudo python setup.py install $ cd <appropriate working directory> $ hg clone https://bitbucket.org/which_linden/eventlet $ cd greenlet $ sudo python setup.py install