1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
|
.. -*- mode: rst -*-
.. vim: ft=rst
.. _development-setup:
Environment setup for development
=================================
Checking Out a Copy of the Code
-------------------------------
* Check out a copy of the code::
git clone https://github.com/Bcfg2/bcfg2.git
.. note::
The URL above is read-only. If you are planning on submitting patches
upstream, please see :ref:`development-submitting-patches`.
* Add :file:`bcfg2/src/sbin` to your :envvar:`PATH` environment variable
* Add :file:`bcfg2/src/lib` to your :envvar:`PYTHONPATH` environment variable
Using a Virtual Environment for Development
-------------------------------------------
Bcfg2 is a pure Python program, and Python makes available certain
tools that simplify creating isolated environments. Such environments
are useful for running code under development, running code that needs
to be installed without actually installing it in system locations, or
running parallel, independent installations of the same packages.
One popular tool for doing this is `virtualenv
<http://pypi.python.org/pypi/virtualenv>`_. The following commands
will bootstrap an isolated environment where the Bcfg2 server can
run. They assume you are starting from an empty directory, on a
Posix-like system that has Python and the ``virtualenv`` package
installed (e.g., on Debian it is available as ``python-virtualenv``):
.. code-block:: sh
# Work in a scratch directory
mkdir test_env
cd test_env
# This creates the environment
virtualenv .
# "Activate" the environment. From this point forward, Python
# and its libraries will first be searched for in test_env and
# its subdirectories. When you begin a new session that should
# use this environment, re-execute this command.
. bin/activate
# The pip command is useful for installing python code from a
# variety of locations, including directly from git repositories
easy_install pip
# Install Bcfg2 from git. The -e puts the source in an editable
# git clone under the "src" dir.
pip install -e git://git.mcs.anl.gov/bcfg2.git#egg=Bcfg2
# Install a newer version of the Cheetah library, for example
pip install --upgrade cheetah
# If you want to run IPython from within the virtual
# environment, it will need to be installed locally, even if it
# is already available on the system, or else it won't find .
pip install --upgrade ipython
# Note, if you install IPython, deactivate and reactivate the
# virtualenv before attempting to use it.
deactivate
. bin/activate
.. note::
One caveat about this environment is that it assumes you have
already installed Bcfg2's dependencies on the system itself. Pip is
capable of building packages such as ``lxml`` that include native
code, but you will need to be sure its build-time prerequisites are
available.
Consider using the above commands to create an isolated Bcfg2
environment in the same directory as your Bcfg2
:term:`repository`. Copy your :file:`/etc/bcfg2.conf` file into a
local :file:`etc` directory, tweak the paths as needed and you can run
an independent Bcfg2 server as a non-root user. This is useful for
confirming a new release of Bcfg2 and all its tools works against your
current :term:`repository` before upgrading.
|
