← Back to branch summary

~frankban/juju-quickstart/interactive-errors

« back to all changes in this revision

Viewing changes to HACKING.rst

  • Committer: Brad Crittenden
  • Date: 2014-06-11 14:55:45 UTC
  • mfrom: (77.1.2 packaging-tweaks)
  • Revision ID: bac@canonical.com-20140611145545-7j75d2xzy32rzwzq
Update HACKING doc.

Reference the two different packaging recipes for trusty and beyond and for
the pre-trusty series.

The packaging branches are now two separate series:
lp:juju-quickstart/packaging and lp:juju-quickstart/packaging-pre-trusty.
Referencing them in the recipes is cleaner than using bare branch names.

Also add a QA step for environments.yaml generation.

R=frankban
CC=
https://codereview.appspot.com/103310043

Show diffs side-by-side

added added

removed removed

Lines of Context:
HACKING.rst
77
77
~~~~~~~~~~~~~~
78
78
 
79
79
The general steps for manual QA (until we get a continuous integration set up
80
 
with functional tests) should be run on trusty and saucy. 
 
80
with functional tests) should be run on trusty and saucy.
81
81
 
82
82
* Ensure juju-quickstart is installed from the juju-gui/quickstart-beta PPA.::
83
83
 
97
97
    juju destroy-environment local -y
98
98
 
99
99
* Verify an environment that has already been bootstrapped is recogized and
100
 
  the GUI is deployed::
 
100
  the GUI is deployed.  This test also shows that a remote bundle is properly
 
101
  deployed.::
101
102
 
102
103
    juju bootstrap -e local
103
104
    juju quickstart -e local bundle:mediawiki/single
104
105
    juju destroy-environment local -y
105
106
 
 
107
* Prove that an environments.yaml file can be created and used::
 
108
 
 
109
    # Temporarily move the .juju directory out of the way.
 
110
    mv ~/.juju ~/.juju-saved
 
111
 
 
112
    # Run quickstart and select the first option:
 
113
    juju quickstart
 
114
 
 
115
    # Ensure the GUI deploys properly and ~/.juju/environments.yaml looks
 
116
    # reasonable.
 
117
 
 
118
    juju destroy-environment local -y
 
119
 
 
120
    # Delete the data in the generated directory and restore the original
 
121
    rm -rf ~/.juju
 
122
    mv ~/.juju-saved ~/.juju
 
123
 
106
124
Repeat above on ec2.
107
125
 
108
126
Creating PPA releases
113
131
series before trusty and trusty and later.  Consequently, there are two
114
132
packaging branches and two build recipes.  The two packaging branches are:
115
133
 
116
 
* lp:~juju-gui/juju-quickstart/packaging-trunk, and
117
 
* lp:~juju-gui/juju-quickstart/packaging-pre-trusty
 
134
* lp:juju-quickstart/packaging, and
 
135
* lp:juju-quickstart/packaging-pre-trusty
118
136
 
119
137
For the following instructions we'll use the -trunk version but the procedure
120
138
is the same for the -pre-trusty branch.
122
140
The packaging repository (including the ``debian`` directory) can be checked
123
141
out from lp:~juju-gui/juju-quickstart/packaging-trunk, e.g.::
124
142
 
125
 
    $ bzr branch lp:~juju-gui/juju-quickstart/packaging-trunk/ packaging-trunk
126
 
    $ cd packaging-trunk
 
143
    $ bzr branch lp:juju-quickstart/packaging packaging
 
144
    $ cd packaging
127
145
 
128
146
Check that the packaging version reflects the latest Quickstart version. The
129
147
packaging version can be found in the ``debian/changelog`` file present in the
141
159
At this point, edit the changelog as required, commit and push the changes back
142
160
to the packaging branch trunk, and follow the instructions below.
143
161
 
144
 
The recipe for creating packages is in
 
162
The procedure is analogous for pre-trusty series releases, just using the
 
163
other packaging branch.
 
164
 
 
165
The recipe for creating packages for trusty and beyond is in:
145
166
<https://code.launchpad.net/~juju-gui-charmers/+recipe/juju-quickstart-trunk-daily>.
 
167
 
 
168
The pre-trusty recipe is at:
 
169
<https://code.launchpad.net/~juju-gui-charmers/+recipe/juju-quickstart-pre-trusty-daily>.
 
170
 
146
171
We currently publish beta releases on the Juju Quickstart Beta PPA: see
147
172
<https://launchpad.net/~juju-gui/+archive/quickstart-beta/+packages>.
148
173
When a beta release is ready to be published, we move over the packages from