← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/ppa.txt

  • Committer: Canonical.com Patch Queue Manager
  • Date: 2010-09-01 08:02:42 UTC
  • mfrom: (5390.3.3 faster-revert-593560)
  • Revision ID: pqm@pqm.ubuntu.com-20100901080242-esg62ody4frwmy66
(spiv) Avoid repeatedly calling self.target.all_file_ids() in
 InterTree.iter_changes. (Andrew Bennetts)

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/ppa.txt
18
18
<https://launchpad.net/~bzr/+archive>
19
19
    Final released versions and updates.
20
20
 
 
21
<https://launchpad.net/~bzr/+archive/proposed>
 
22
    Proposed uploads to move into ~bzr, awaiting testing.
 
23
 
21
24
<https://launchpad.net/~bzr-beta-ppa/+archive>
22
25
    Beta releases.
23
26
 
24
27
<https://launchpad.net/~bzr-nightly-ppa/+archive>
25
28
    Automatic nightly builds from trunk.
26
29
 
27
 
We build packages for every supported Ubuntu release
28
 
<https://wiki.ubuntu.com/Releases>.  Packages need no longer be updated
29
 
when the release passes end-of-life because all users should
30
 
have upgraded by then.  
31
 
 
32
30
We build a distinct package for each distrorelease.  
33
31
If you upload a release-specific version, you should add a suffix to the
34
32
package version, e.g. ``bzr.1.3-1~bazaar1~dapper1``.
42
40
 
43
41
The packaging information is kept in branches of bzr on Launchpad, named
44
42
like
45
 
<https://code.launchpad.net/~bzr/bzr/packaging-hardy>.
 
43
<https://code.launchpad.net/~bzr/ubuntu/hardy/bzr/bzr-ppa>.
46
44
or
47
 
<lp:~bzr/bzr/packaging-hardy>.  These branches are intended to be used
 
45
<lp:~bzr/ubuntu/hardy/bzr/bzr-ppa>.  These branches are intended to be used
48
46
with the ``bzr-builddeb`` plugin.
49
47
 
 
48
**You should almost always upload to the beta ppa first** and then either 
 
49
upload again or copy the packages into the release ppa.  That reduces the 
 
50
risk of breaking the main archive from which people get bzr updates.
 
51
 
 
52
 
 
53
Supported releases
 
54
------------------
 
55
 
 
56
We build packages for every supported Ubuntu release
 
57
<https://wiki.ubuntu.com/Releases>.  Packages need no longer be updated
 
58
when the release passes end-of-life because all users should
 
59
have upgraded by then.  
 
60
 
 
61
As of August 2010, the following releases are supported:
 
62
 
 
63
* Maverick 
 
64
* Lucid LTS
 
65
* Karmic
 
66
* Jaunty (support ends October 2010)
 
67
* Hardy LTS
 
68
* Dapper LTS (supported but no longer updated for new releases)
 
69
 
 
70
 
50
71
Preconditions
51
72
-------------
52
73
 
55
76
 
56
77
* You must have a GPG key registered to your Launchpad account.
57
78
 
58
 
* Configure ``dput`` to upload to our PPA with this section in your
59
 
  ``~/.dput.cf``::
60
 
 
61
 
    [bzr-beta-ppa]
62
 
    fqdn = ppa.launchpad.net
63
 
    method = ftp
64
 
    incoming = ~bzr-beta-ppa/ubuntu
65
 
    login = anonymous
66
 
    allow_unsigned_uploads = 0
67
 
 
68
 
    [bzr-ppa]
69
 
    fqdn = ppa.launchpad.net
70
 
    method = ftp
71
 
    incoming = ~bzr/ubuntu
72
 
    login = anonymous
73
 
    allow_unsigned_uploads = 0
74
 
 
75
 
  You may also want to add these lines to prevent inadvertently attempting
76
 
  to upload into Ubuntu or Debian, which will give a somewhat unclear
77
 
  error::
 
79
On reasonably recent versions of Ubuntu you no longer need special dput
 
80
configuration, because you can just say ::
 
81
 
 
82
  dput ppa:bzr/proposed <source.changes
 
83
  
 
84
 
 
85
However, you may still want to add these lines to ``~/.dput.cf`` prevent 
 
86
inadvertently attempting to upload into Ubuntu or Debian, which will
 
87
give a somewhat unclear error::
78
88
 
79
89
    [DEFAULT]
80
90
    default_host_main = notspecified
103
113
Packaging Bazaar
104
114
----------------
105
115
 
 
116
Overview of packaging with builddeb
 
117
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
118
 
 
119
* First update the oldest supported branch, using ``bzr merge-upstream``.
 
120
 
 
121
* Run ``bzr builddeb -S -- -sa`` to build a source package, then put 
 
122
  that into the ppa.  
 
123
  
 
124
  (``-S`` says to make a source-only upload, which is
 
125
  required for Launchpad's builders.  ``--sa`` says to include the
 
126
  ``.orig.tgz`` even if this doesn't seem to be the first upload for an
 
127
  upstream release: this is often needed when rebuilding something that's
 
128
  previously been uploaded to Debian or Ubuntu or into a different PPA.)
 
129
 
 
130
* Now merge across that change into each supported branch with a 
 
131
  simple ``bzr merge``.
 
132
  
 
133
Locally testing builds
 
134
~~~~~~~~~~~~~~~~~~~~~~
 
135
 
 
136
It may be useful to locally test builds inside pbuilder.  You may want to 
 
137
use the script from <http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=255165> 
 
138
to wrap it.
 
139
 
 
140
Update all packages in proposed before copping the main ppa
 
141
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
142
 
 
143
If one updates bzr, and there are plugins that are not compatible with the
 
144
new version of bzr, this can cause pain for users using the ppa. In order to
 
145
avoid this, we first get all packages up to date in the proposed ppa, and then
 
146
copy them to the main ppa.
 
147
 
 
148
 
106
149
Short form
107
150
~~~~~~~~~~
108
151
 
114
157
  export PACKAGE="bzr"
115
158
  export UBUNTU_RELEASES="dapper hardy intrepid jaunty karmic"
116
159
  ~/dev/bzr/bzr.dev/tools/packaging/update-packaging-branches.sh
 
160
  * Optionaly merge debian unstable. 
117
161
  ~/dev/bzr/bzr.dev/tools/packaging/update-changelogs.sh
118
162
  ~/dev/bzr/bzr.dev/tools/packaging/update-control.sh 1.16 1.17 1.18
119
163
  ~/dev/bzr/bzr.dev/tools/packaging/build-packages.sh
120
 
  dput bzr-beta-ppa ${PACKAGE}_$VERSION*.changes
 
164
  dput ppa:bzr/proposed ${PACKAGE}_$VERSION*.changes
121
165
 
122
166
Rinse and repeat for all the plugins by changing VERSION and PACKAGE.
123
167
 
159
203
 
160
204
#. Checkout (or update) the packaging branch for each supported release::
161
205
 
162
 
      bzr co lp:~bzr/bzr/packaging-hardy
 
206
      bzr co lp:~bzr/ubuntu/hardy/bzr/bzr-ppa
163
207
 
164
208
   There is a script available to help::
165
209
 
166
210
      tools/packaging/update-packaging-branches.sh
167
211
 
 
212
#. Optionaly, merge the Debian unstable branch into each of the packaging
 
213
   branches. You can find the Debian unstable branch here:
 
214
   http://bzr.debian.org/pkg-bazaar/
 
215
 
168
216
#. The ``bzr-builddeb`` step will download the original tarball if you do
169
217
   not already have it, putting it into a ``tarballs`` directory.
170
218
 
220
268
 
221
269
#. Build the source packages::
222
270
 
223
 
      cd packaging-$DISTRO; bzr builddeb -S
 
271
      cd bzr-$DISTRO; bzr builddeb -S
224
272
 
225
273
   This will create a ``.changes`` file.  If you didn't configure builddeb
226
274
   to automatically sign them, you can use ::
234
282
 
235
283
      tools/packaging/build-packages.sh
236
284
 
237
 
#. Upload into the beta PPA for each release::
238
 
 
239
 
     dput bzr-beta-ppa bzr*1.17-1*.changes
240
 
 
241
 
#. For final release versions, also copy it into the ``~bzr`` PPA::
242
 
 
243
 
     dput bzr-ppa ../bzr_1.17-1\~bazaar1\~hardy1\_source.changes
244
 
 
245
 
   Alternatively, you can use Launchpad's "copy" feature to copy the
246
 
   packages between repositories.
 
285
#. Upload into the PPA for each release::
 
286
 
 
287
     dput dput ppa:bzr/proposed bzr*1.17-1*.changes
247
288
 
248
289
#. You should soon get an "upload accepted" mail from Launchpad, which
249
290
   means that your package is waiting to be built.  You can then track its
285
326
summary of current package versions with::
286
327
 
287
328
  apt-cache madison bzr
 
329
  
 
330
  
 
331
  
 
332
Packaging dependencies
 
333
----------------------
 
334
 
 
335
Some of our updates to bzr in previous releases require backports of our
 
336
dependencies.  Specific branches holding these backports:
 
337
 
 
338
 * ``lp:~bzr/ubuntu/dapper/configobj/dapper-backport``
288
339
 
289
340
 
290
341
..