Setting up a Keystone development environment

这个文档描述了为了开发，怎么样从GitHub repository中获取KeyStone的源码。

从包安装keystone，可参考地址(keystone's user document)http://docs.openstack.org/

 Prerequisites(预备知识)

这个文档假设你使用的是：

    ubuntu 11.10， Fedora 15，或Mac OS X Lion

    python

并在你的系统中下列工具是可使用的：

    git

    setuptools

    pip

提醒：如果你的系统版本或者工具的版本和上面的不一样，那么请你配置好它们。

Getting the latest code(获取最新代码)

从GitHub respository拷贝一份代码：

git clone https://github.com/openstack/keystone.git

完成之后，你就：

cd keystone

Install dependencies(安装依赖)

keystone主要依赖下列：

requirements.txt        运行keystone需要此文件

test-requirements.txt        激活keystone的自身的开发和测试

这些依赖可以从PyPi中安装

尽管如此，除了pip你的系统可能还需要其他的依赖。

这些依赖可能要先于pip安装，安装的方式也取决于你的平台系统。

在Ubuntu11.10下如是安装：

sudo apt-get install python-dev libxml2-dev libxslt1-dev libsqlite3-dev libssl-dev libldap2-dev

在Fedora 15下如是安装:

    sudo yum install python-sqlite2 python-lxml python-greenlet-devel python-ldap

在Mac OSX Lion下如是安装:

    sudo port install py-ldap

PyPi Packages and VirtualEnv

我们建议在一个虚拟环境中建立keystone，虚拟环境中只要你依赖的python环境，能够让keystone的运行环境保持干净。

在keystone的目录下有一个脚本可以简单的实现这个：

python tools/install_venv.py

这个将在本地目录.venv下创建一个虚拟环境，一旦创建你可以使用shell命令激活这个virtualenv:

source .venv/bin/activate

这个虚拟环境也可以使用命令解除：

deactivate

如果你想直接在你的系统环境中使用keystone，你可以直接在你的系统中安装依赖：

pip install -r requirements.txt

pip install -r test-requirements.txt

python setup.py develop

Verifying keystone is set up(验证keystone是否安装好)

>>> import keystone

>>>