~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-08-24 23:20:14 UTC
  • mfrom: (5365.5.29 2.3-btree-chk-leaf)
  • Revision ID: pqm@pqm.ubuntu.com-20100824232014-nu9owzel2zym2jk2
(jam) Use a custom C type for CHK index entries, saves memory

Show diffs side-by-side

added added

removed removed

Lines of Context:
13
13
 
14
14
  __ https://help.launchpad.net/PPAQuickStart
15
15
 
16
 
As of June 2008, there are three PPAs:
 
16
As of June 2010, there are three PPAs:
17
17
 
18
18
<https://launchpad.net/~bzr/+archive>
19
 
    Final released versions.
 
19
    Final released versions and updates.
 
20
 
 
21
<https://launchpad.net/~bzr/+archive/proposed>
 
22
    Proposed uploads to move into ~bzr, awaiting testing.
20
23
 
21
24
<https://launchpad.net/~bzr-beta-ppa/+archive>
22
 
    Releases and release candidates.
 
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.  (As of May 2008, Edgy Eft is no longer supported.)
31
 
 
32
 
We build a distinct package for each distrorelease.  As of bzr 1.5, Dapper
33
 
uses ``python-support`` and later distributions use ``python-central``.
 
30
We build a distinct package for each distrorelease.  
34
31
If you upload a release-specific version, you should add a suffix to the
35
32
package version, e.g. ``bzr.1.3-1~bazaar1~dapper1``.
36
33
 
 
34
Dapper uses the ``python-support`` framework and later distributions use
 
35
``python-central``.  This has little effect on everyday packaging but does
 
36
mean that some of the control files are quite different.
 
37
 
37
38
Every package is first uploaded into the beta ppa.  For final release
38
39
versions it is also copied to the main PPA.
39
40
 
44
45
<lp:~bzr/bzr/packaging-hardy>.  These branches are intended to be used
45
46
with the ``bzr-builddeb`` plugin.
46
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
 
47
71
Preconditions
48
72
-------------
49
73
 
52
76
 
53
77
* You must have a GPG key registered to your Launchpad account.
54
78
 
55
 
* Configure ``dput`` to upload to our PPA with this section in your
56
 
  ``~/.dput.cf``::
57
 
 
58
 
    [bzr-beta-ppa]
59
 
    fqdn = ppa.launchpad.net
60
 
    method = ftp
61
 
    incoming = ~bzr-beta-ppa/ubuntu
62
 
    login = anonymous
63
 
    allow_unsigned_uploads = 0
64
 
 
65
 
    [bzr-ppa]
66
 
    fqdn = ppa.launchpad.net
67
 
    method = ftp
68
 
    incoming = ~bzr/ubuntu
69
 
    login = anonymous
70
 
    allow_unsigned_uploads = 0
71
 
 
72
 
  You may also want to add these lines to prevent inadvertently attempting
73
 
  to upload into Ubuntu or Debian, which will give a somewhat unclear
74
 
  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::
75
88
 
76
89
    [DEFAULT]
77
90
    default_host_main = notspecified
100
113
Packaging Bazaar
101
114
----------------
102
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
 
103
149
Short form
104
150
~~~~~~~~~~
105
151
 
111
157
  export PACKAGE="bzr"
112
158
  export UBUNTU_RELEASES="dapper hardy intrepid jaunty karmic"
113
159
  ~/dev/bzr/bzr.dev/tools/packaging/update-packaging-branches.sh
 
160
  * Optionaly merge debian unstable. 
114
161
  ~/dev/bzr/bzr.dev/tools/packaging/update-changelogs.sh
115
162
  ~/dev/bzr/bzr.dev/tools/packaging/update-control.sh 1.16 1.17 1.18
116
163
  ~/dev/bzr/bzr.dev/tools/packaging/build-packages.sh
117
 
  dput bzr-beta-ppa ${PACKAGE}_$VERSION*.changes
 
164
  dput ppa:bzr/proposed ${PACKAGE}_$VERSION*.changes
118
165
 
119
166
Rinse and repeat for all the plugins by changing VERSION and PACKAGE.
120
167
 
162
209
 
163
210
      tools/packaging/update-packaging-branches.sh
164
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
 
165
216
#. The ``bzr-builddeb`` step will download the original tarball if you do
166
217
   not already have it, putting it into a ``tarballs`` directory.
167
218
 
231
282
 
232
283
      tools/packaging/build-packages.sh
233
284
 
234
 
#. Upload into the beta PPA for each release::
235
 
 
236
 
     dput bzr-beta-ppa bzr*1.17-1*.changes
237
 
 
238
 
#. For final release versions, also copy it into the ``~bzr`` PPA::
239
 
 
240
 
     dput bzr-ppa ../bzr_1.17-1\~bazaar1\~hardy1\_source.changes
241
 
 
242
 
   Alternatively, you can use Launchpad's "copy" feature to copy the
243
 
   packages between repositories.
 
285
#. Upload into the PPA for each release::
 
286
 
 
287
     dput dput ppa:bzr/proposed bzr*1.17-1*.changes
244
288
 
245
289
#. You should soon get an "upload accepted" mail from Launchpad, which
246
290
   means that your package is waiting to be built.  You can then track its
282
326
summary of current package versions with::
283
327
 
284
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``
285
339
 
286
340
 
287
341
..