Packaging

Differences between revisions 6 and 7
Revision 6 as of 2010-10-04 08:32:41
Size: 5229
Editor: p5DDC2009
Comment:
Revision 7 as of 2011-08-16 15:58:28
Size: 4361
Editor: dholbach
Comment:
Deletions are marked like this. Additions are marked like this.
Line 15: Line 15:
 * '''Tutor(s)''' - Someone that knows packaging fairly well and can handle questions and some of the unexpected likely to come up. (Tutor needs to have experience with [[PackagingGuide]].)  * '''Tutor(s)''' - Someone that knows packaging fairly well and can handle questions and some of the unexpected likely to come up. (Tutor needs to have experience with the [[https://developer.ubuntu.com/packaging/|Packaging Guide]].)
Line 18: Line 18:
 * '''Packaging Playbook''' (''optional'') - We have a generic sheet that you can print out and hand out to attendees that people can follow along with the workflow. [[attachment:playbook.pdf]]
Line 24: Line 24:
 * Ask people to install the packages listed on [[PackagingGuide/Lists/ImportantDevelopmentPackages]].  * Ask people to install [[http://developer.ubuntu.com/packaging/html/getting-set-up.html|development packages]].
Line 29: Line 29:
 * Start out getting everyone set up ([[PackagingGuide/Complete|Packaging Guide]], chapter's "Introduction" and "Getting Started")  * Start out getting everyone set up ([[http://developer.ubuntu.com/packaging/html/|Packaging Guide]], chapter's "Introduction" and "Getting Started")
Line 31: Line 31:
 * The next step is to get everyone's GPG keys setup and make sure that they're available for signing the packages later on. This is also a good time to have a mini key signing party to get everyone introduced and to verify any GPG key issues are sorted out early. There's some good documentation for this on the [[https://help.ubuntu.com/community/GnuPrivacyGuardHowto|GnuPrivacyGuardHowto]]
 * {{{
sudo apt-get install devscripts build-essential wget fakeroot cdbs patchutils debhelper gobby dh-make
}}}
 * (bzr has an [[http://blogs.gnome.org/jamesh/2008/02/19/bzr-avahi/|avahi plugin]] that can be used so people can find each other's repositories on a local network).

Line 40: Line 33:
 * Follow the [[PackagingGuide/HandsOn]] (and [[PackagingGuide/Recipes]]) material.  * Follow the [[http://developer.ubuntu.com/packaging/html/|Packaging Guide]] material.
Line 42: Line 35:
  * Follow the [[PackagingGuide]] documentation.
Line 44: Line 36:
  * Then start with the [[PackagingGuide/Basic]] and walk through the packaging of `hello` together. A helpful hint is to keep one version back when you download initially. This gives you a chance to walk through upgrading the package to the latest source available later on.   * Then walk through the "Basic Overview of the debian/ Directory" together. A helpful hint is to keep one version back when you download initially. This gives you a chance to walk through upgrading the package to the latest source available later on.

In the Ubuntu community we always need more packagers. There are literally thousands of applications out there that need maintenance, and one of the major reasons why people choose Ubuntu is that there is a huge catalog of software that is ready to install and use. These thousands of applications are maintained by a large and growing community of community volunteers who help to package these applications and maintain high quality packages. As the number of applications grows though, we need more and more volunteers.

Generally if someone expresses an interest in packaging, we point them to MOTU/GettingStarted and off they go. Another great way to get people up to speed is with...Packaging Jams!

With a huge world-wide network of LoCoTeams, more and more teams are running Packaging Jams - special events in which people meet up and a few instructors show the attendees how to get involved with Ubuntu package maintenance. Not only are these events extremely valuable in attracting new packagers, but they are huge fun! This page offers a simple guide to running a Packaging Jam. Smile :)

Requirements

A Packaging Jam is very similar to any kind of jam, but it's a bit special. You need a few things:

  • Tutor(s) - Someone that knows packaging fairly well and can handle questions and some of the unexpected likely to come up. (Tutor needs to have experience with the Packaging Guide.)

  • A bit more time - A day with some spare time. As an example, the Michigan LoCo went from noon until 8pm on a Saturday. Progress will be slower than you might expect, so provide plenty of time.

  • Local Ubuntu Mirror (optional) - this is very helpful if the internet connectivity is weak or altogether lacking. A good how-to for setting up an ubuntu mirror can be found here: https://help.ubuntu.com/community/Debmirror.

You also want to provide some snacks and drinks to help people through their new packaging journey.

Asking people to prepare for the Jam

Running The Jam

Prerequisites

  • Check for connectivity, and watch out for people with different versions of Ubuntu running. For instance the mirror might only have gutsy and someone comes with feisty. It's not a deal killer, but adds for surprises.
  • Start out getting everyone set up (Packaging Guide, chapter's "Introduction" and "Getting Started")

  • Now suggest everyone use gobby for communicating things throughout the meeting. It makes for a great place for the person running the Jam to paste links, commands, and other notes for the group to follow. This really lets the people save the shared documents and everyone goes him with notes from the day's events. It also really eliminates the need for a projector or other method of sharing screens.

Holding the Session

  • Follow the Packaging Guide material.

  • Alternatively (if you plan to have more time):
    • First go through the Getting Started section to get everyone's packaging environment setup.
    • Then walk through the "Basic Overview of the debian/ Directory" together. A helpful hint is to keep one version back when you download initially. This gives you a chance to walk through upgrading the package to the latest source available later on.
    • After getting hello packaged try to update to the latest source version by using uupdate. This should be a nice quick exercise.

    • Once you get through packaging hello, see if anyone brought a packaging problem the group can work on together.
  • Plug MOTU/GettingStarted a couple of times. Smile :-)

  • Get help on #ubuntu-motu.

  • Find tasks on MOTU/TODO and fix them! Smile :-)


CategoryJam

Jams/Packaging (last edited 2016-10-27 07:44:00 by dholbach)