docs/distribution-job-builds.rst

   1 Distribution Job Builds
   2 =======================
   3
   4 Unlike autorelease builds, which build every project from source, distribution
   5 jobs only build a few Karaf features. This makes them much quicker (minutes
   6 instead of ~11 hours), and therefore suitable for CI testing. End-users like
   7 OPNFV should stick with autorelease jobs.
   8
   9
  10 Snapshot Builds
  11 ---------------
  12
  13 Distribution job builds are typically kicked off when a patch is merged into
  14 a project. Projects define `<project>`-merge-<branch> Jenkins jobs, which are
  15 kicked off by a Gerrit merge events. To find the merge job for a Gerrit, look
  16 for comments from the jenkins-releng user like "Build Started
  17 https://jenkins.opendaylight.org/releng/job/netvirt-merge-boron/216/".
  18
  19 Alternatively, browse a project's Jenkins tab and look at the recent runs.
  20 For example, go to https://jenkins.opendaylight.org/releng/, select Merge-Boron
  21 and you'll find the list of all projects merge jobs in the format
  22 `<project>`-merge-boron. Click any to view the recent build job details and
  23 logs.
  24
  25 For each active branch, snapshot builds created by distribution jobs can be
  26 found in the subdirs at `opendaylight.snapshot/org/opendaylight/integration
  27 /distribution-karaf/`_. The maven-metadata.xml tells about the different
  28 versions and the latest one. The different subdirectories (say, 0.5.2-SNAPSHOT)
  29 contain all the corresponding version (0.5.2 here) builds stored by time (time
  30 included in the artifact name).
  31
  32 Recent build artifacts info for a given branch can be found in the XML's
  33 `<content-item>` at `opendaylight.snapshot/content/org/opendaylight/integration
  34 /distribution-karaf/`_.
  35
  36
  37 Custom Distributions
  38 --------------------
  39
  40 Distributions can be built with an additional set of unmerged patches. `See
  41 this wiki`_.
  42
  43
  44 .. _opendaylight.snapshot/org/opendaylight/integration /distribution-karaf/: https://nexus.opendaylight.org/content/repositories/opendaylight.snapshot/org/opendaylight/integration/distribution-karaf/
  45 .. _opendaylight.snapshot/content/org/opendaylight/integration /distribution-karaf/: https://nexus.opendaylight.org/service/local/repositories/opendaylight.snapshot/content/org/opendaylight/integration/distribution-karaf/
  46 .. _See this wiki: https://wiki.opendaylight.org/view/Integration/Test/Running_System_Tests#Running_System_Tests_Using_Custom_Distribution_Built_From_Multiple_Patches