= Source Package Recipe Builds =

Build source packages from [[https://launchpad.net/bzr-builder|bzr-builder]] recipes, optionally on a daily basis.

As an upstream maintainer<<BR>>
I want to be able to build packages of my code using pre-existing packaging<<BR>>
So that users can try out the latest tip without installing from source.<<BR>>

As an Ubuntu enthusiast<<BR>>
I want to make a daily build of my favourite app available in a PPA<<BR>>
So that I & others can always be using the bleeding-edge.<<BR>>

This is not the elimination of sourcepackages as a step towards generating binary packages as proposed in [[https://wiki.ubuntu.com/NoMoreSourcePackages|No More Source Packages]].  Instead, it attempts to make that step trivial for many authors who otherwise wouldn't publish binaries.

== Rationale ==

We want to make it very, very easy for upstream application authors to get their applications into the hands of Ubuntu users. This allows said application authors to get feedback on their latest work from a large, eager body of open source users.  It allows those brave users who want the latest and greatest to get it easily.

This will, we hope, lead to a higher quality of Linux software in general, and thus a higher quality Ubuntu.


== Stakeholders ==

 * Upstreams
 * Ubuntu community leaders
 * Soyuz
 * Losas
 * Ubuntu OSAs
 * sabdfl

Some of these stakeholders only have an interest in ensuring the build farm is reliable even with this new feature.

== Constraints and Requirements ==

 * Must safely execute untrusted code when building source packages
 * Only the build farm provides for safe execution of untrusted code
 * Must use bzr-builder to generate debianized trees

=== Must ===

 * Provide daily builds, but may skip builds if the source is unchanged
 * Provide a web UI for creating recipes and requesting builds
 * Provide API for creating recipes and requesting builds
 * Allow users to use James Westby's imports (e.g. lp:ubuntu/foo) to provide the debian directory
 * Promptly provide full information on failed builds to the person who requested the build
 * Builds are performed in a timely manner (see [[LEP/BuildFarmScalabilty]] for more details)
 * Provide way to discover recipe-powered daily builds from a project or source package page
 * Allow recipes to be built from bzr 2a-format branches for any supported distorseries (whether or not the distroseries itself supports 2a).

=== Nice to have ===

 * Auto-scheduled Source Package Recipe Builds don't interfere with manually-scheduled ones
 * Users can cancel builds
 * Builds of recipes involving private branches are supported
 * Highlight PPAs or packages within PPAs that are generated from recipes
 * Renaming branches does not break recipes

=== Must not ===

 * Overload the build farm
 * Disable the build farm
 * Require any additional LOSA / buildd-admin intervention

== Workflows ==

 * Create a recipe based on a branch
 * Investigate a broken build triggered by a failure mail
 * ...?

== UI ==
The [[https://dev.launchpad.net/BuildBranchToArchiveUI|original design]] from the process led by Michael Nelson:
[[http://people.canonical.com/~michaeln/bfb/|mockups]]

The [[https://dev.launchpad.net/BuildBranchToArchiveUI/InitialCut|initial cut design]] implemented by Paul Hummer and Aaron Bentley:
[[http://people.canonical.com/~abentley/sprb-mockups/|mockups]]

== Success ==

 * [[https://lpstats.canonical.com/graphs/CodeRecipeBuildsDailyStatusCounts/|Daily totals of the results of the builds in the last 24 hours]]
 * [[https://lpstats.canonical.com/graphs/CodeRecipeTotalCounts/|Count the total number of recipes grouping on the branch namespace type and whether there is a daily build.]]
 * [[https://lpstats.canonical.com/graphs/CodeRecipeBaseTypeCounts/|The number of projects and packages that are used as recipe base branches.]]
 * [[https://lpstats.canonical.com/graphs/CodeRecipeOwnerCounts/|How many different people use recipes]]
 * [[https://lpstats.canonical.com/graphs/BuildersActiveVirtual/|Active builders and jobs queued]] – to see if we broke the build farm.
 * [[https://lpstats.canonical.com/graphs/CodeRecipeDelay|Build delay]] ­— to see if builds are being dispatched in a timely manner.

== Thoughts? ==