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
|
Juju Quickstart
===============
Juju Quickstart is a Juju plugin which allows for easily setting up a Juju
environment in very few steps. The environment is bootstrapped and set up so
that it can be managed using a Web interface (the Juju GUI).
Bundle deployments are also supported, and allow for setting up a complete
topology of services in one simple command.
Creating a development environment
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The development environment is created in a virtualenv. The environment
creation requires the *make*, *pip* and *virtualenv* programs to be installed.
To do that, run the following::
$ make sysdeps
At this point, from the root of this branch, run the command::
$ make
This command will create a ``.venv`` directory in the branch root, ignored
by DVCSes, containing the development virtual environment with all the
dependencies.
Testing and debugging the application
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Run the tests::
$ make test
Run the tests and lint/pep8 checks::
$ make check
Display help about all the available make targets, including instructions on
setting up and running the application in the development environment::
$ make help
Installing the application
~~~~~~~~~~~~~~~~~~~~~~~~~~
To install Juju Quickstart in your local system, run the following::
$ sudo make install
This command will take care of installing the requirements and the application
itself.
Running the application
~~~~~~~~~~~~~~~~~~~~~~~
juju-core will recognize Juju Quickstart as a plugin once the application is
installed by the command above. At this point, the application can be started
by running ``juju quickstart``.
Run the following for the list of all available options::
$ juju quickstart --help
Assuming a Juju environment named ``local`` is properly configured in your
``~/.juju/environments.yaml`` file, here is an example invocation::
$ juju quickstart -e local
If you have not installed the application using ``sudo make install``, as
described above, you can run it locally using the virtualenv's Python
installation::
$ .venv/bin/python juju-quickstart --help
Creating PPA releases
~~~~~~~~~~~~~~~~~~~~~
The recipe for creating packages is in
<https://code.launchpad.net/~juju-gui-charmers/+recipe/juju-quickstart-daily>.
We currently publish releases on the Juju Quickstart Beta PPA: see
<https://launchpad.net/~juju-gui/+archive/quickstart-beta/+packages>.
Packages depend on `python-jujuclient` and `python-websocket-client` to be
available. They are available in saucy, and they are also stored in our PPA in
order to support previous Ubuntu releases.
|