← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/ppa.txt

  • Committer: Martin Pool
  • Date: 2010-07-21 09:58:42 UTC
  • mfrom: (4797.58.7 2.1)
  • mto: (5050.3.13 2.2)
  • mto: This revision was merged to the branch mainline in revision 5365.
  • Revision ID: mbp@canonical.com-20100721095842-hz0obu8gl0x05nty
merge up 2.1 to 2.2

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
 
 
24
21
<https://launchpad.net/~bzr-beta-ppa/+archive>
25
22
    Beta releases.
26
23
 
27
24
<https://launchpad.net/~bzr-nightly-ppa/+archive>
28
25
    Automatic nightly builds from trunk.
29
26
 
 
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
 
30
32
We build a distinct package for each distrorelease.  
31
33
If you upload a release-specific version, you should add a suffix to the
32
34
package version, e.g. ``bzr.1.3-1~bazaar1~dapper1``.
40
42
 
41
43
The packaging information is kept in branches of bzr on Launchpad, named
42
44
like
43
 
<https://code.launchpad.net/~bzr/ubuntu/hardy/bzr/bzr-ppa>.
 
45
<https://code.launchpad.net/~bzr/bzr/packaging-hardy>.
44
46
or
45
 
<lp:~bzr/ubuntu/hardy/bzr/bzr-ppa>.  These branches are intended to be used
 
47
<lp:~bzr/bzr/packaging-hardy>.  These branches are intended to be used
46
48
with the ``bzr-builddeb`` plugin.
47
49
 
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
 
 
71
50
Preconditions
72
51
-------------
73
52
 
76
55
 
77
56
* You must have a GPG key registered to your Launchpad account.
78
57
 
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::
 
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::
88
78
 
89
79
    [DEFAULT]
90
80
    default_host_main = notspecified
113
103
Packaging Bazaar
114
104
----------------
115
105
 
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
 
 
149
106
Short form
150
107
~~~~~~~~~~
151
108
 
157
114
  export PACKAGE="bzr"
158
115
  export UBUNTU_RELEASES="dapper hardy intrepid jaunty karmic"
159
116
  ~/dev/bzr/bzr.dev/tools/packaging/update-packaging-branches.sh
160
 
  * Optionaly merge debian unstable. 
161
117
  ~/dev/bzr/bzr.dev/tools/packaging/update-changelogs.sh
162
118
  ~/dev/bzr/bzr.dev/tools/packaging/update-control.sh 1.16 1.17 1.18
163
119
  ~/dev/bzr/bzr.dev/tools/packaging/build-packages.sh
164
 
  dput ppa:bzr/proposed ${PACKAGE}_$VERSION*.changes
 
120
  dput bzr-beta-ppa ${PACKAGE}_$VERSION*.changes
165
121
 
166
122
Rinse and repeat for all the plugins by changing VERSION and PACKAGE.
167
123
 
203
159
 
204
160
#. Checkout (or update) the packaging branch for each supported release::
205
161
 
206
 
      bzr co lp:~bzr/ubuntu/hardy/bzr/bzr-ppa
 
162
      bzr co lp:~bzr/bzr/packaging-hardy
207
163
 
208
164
   There is a script available to help::
209
165
 
210
166
      tools/packaging/update-packaging-branches.sh
211
167
 
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
 
 
216
168
#. The ``bzr-builddeb`` step will download the original tarball if you do
217
169
   not already have it, putting it into a ``tarballs`` directory.
218
170
 
268
220
 
269
221
#. Build the source packages::
270
222
 
271
 
      cd bzr-$DISTRO; bzr builddeb -S
 
223
      cd packaging-$DISTRO; bzr builddeb -S
272
224
 
273
225
   This will create a ``.changes`` file.  If you didn't configure builddeb
274
226
   to automatically sign them, you can use ::
282
234
 
283
235
      tools/packaging/build-packages.sh
284
236
 
285
 
#. Upload into the PPA for each release::
286
 
 
287
 
     dput dput ppa:bzr/proposed bzr*1.17-1*.changes
 
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.
288
247
 
289
248
#. You should soon get an "upload accepted" mail from Launchpad, which
290
249
   means that your package is waiting to be built.  You can then track its
326
285
summary of current package versions with::
327
286
 
328
287
  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``
339
288
 
340
289
 
341
290
..