ubuntu-packaging-guide-team team mailing list archive

[Jonathan Riddell <jriddell@xxxxxxxxxx>]

Jonathan Riddell has proposed merging lp:~jr/ubuntu-packaging-guide/06-chroots into lp:ubuntu-packaging-guide with lp:~jr/ubuntu-packaging-guide/05-patches as a prerequisite.

Requested reviews:
  Ubuntu Packaging Guide Team (ubuntu-packaging-guide-team)

For more details, see:
https://code.launchpad.net/~jr/ubuntu-packaging-guide/06-chroots/+merge/68566

Add a brief chroot guide


-- 
https://code.launchpad.net/~jr/ubuntu-packaging-guide/06-chroots/+merge/68566
Your team Ubuntu Packaging Guide Team is requested to review the proposed merge of lp:~jr/ubuntu-packaging-guide/06-chroots into lp:ubuntu-packaging-guide.

=== added file 'chroots.rst'
--- chroots.rst	1970-01-01 00:00:00 +0000
+++ chroots.rst	2011-07-20 16:17:11 +0000
@@ -0,0 +1,53 @@
+=============
+Using Chroots
+=============
+
+If you are running one version of Ubuntu but working on packages for
+another versions you can create the environment of the other version with a
+``chroot``.
+
+A ``chroot`` allows you to have a full filesystem from another distribution
+which you can work in quite normally.  It avoids the overhead of running a
+full virtual machine.
+
+Creating a Chroots
+------------------
+
+Use the command ``debootstrap`` to create a new chroot::
+
+    $ sudo debootstrap oneiric oneiric/
+
+This will create a directory ``oneiric`` and install a minimal oneiric system
+into it.
+
+If your version of ``debootstrap`` does not know about oneiric you can try
+upgrading to the version in ``backports``.
+
+You can then work inside the chroot::
+
+    $ sudo chroot oneiric
+
+Where you can install or remove any package you wish without affecting your
+main system.
+
+You might want to copy your GPG/ssh keys and Bazaar configuration into the
+chroot so you can access and sign packages directly.
+
+    $ sudo mkdir oneiric/home/<username>
+    $ sudo cp -r ~/.gnupg ~/.ssh ~/.bazaar oneiric/home/<username>
+
+For more information on chroots see our `Debootstrap Chroot wiki page`_.
+
+Alternatives
+------------
+
+Full virtual machines can be useful for packaging and testing programmes.
+
+You can also set up pbuilder to pause when it comes across a build failure.
+
+Amazon's `EC2 cloud computers`_ allow you to hire a computer paying a few US
+cents per hour, you can set up Ubuntu machines of any supported version and
+package on those.
+
+.. _`Debootstrap Chroot wiki page`: https://wiki.kubuntu.org/DebootstrapChroot
+.. _`EC2 cloud computers`: https://help.ubuntu.com/community/EC2StartersGuide

=== modified file 'index.rst'
--- index.rst	2011-07-20 16:17:11 +0000
+++ index.rst	2011-07-20 16:17:11 +0000
@@ -48,6 +48,7 @@
    udd-merging
    udd-patchsys
    udd-newpackage
+   chroots
    traditional-packaging