docs/release-process/identifying-managed-projects.rst

   1 *******************************************************
   2 Identifying Managed Projects in an OpenDaylight Version
   3 *******************************************************
   4
   5 What are Managed Projects?
   6 ==========================
   7
   8 Managed Projects are simply projects that take part in the :ref:`Managed
   9 Release Process <managed-release>`. Managed Projects are either core components
  10 of OpenDaylight or have demonstrated their maturity and ability to successfully
  11 take part in the Managed Release.
  12
  13 For more information, see the full description of :ref:`Managed Projects
  14 <managed-projects>`.
  15
  16 What is a Managed Distribution?
  17 ===============================
  18
  19 Managed Projects are aggregated together by a POM file that defines a Managed
  20 Distribution. The Managed Distribution is the focus of OpenDaylight
  21 development. It's continuously built, tested, packaged and released into
  22 Continuous Delivery pipelines. As prescribed by the Managed Release Process,
  23 Managed Distributions are eventually blessed as formal OpenDaylight releases.
  24
  25 NB: OpenDaylight's Fluorine release actually included Managed and Self-Managed
  26 Projects, but the community is working towards the formal release being exactly
  27 the Managed Distribution, with an option for Self-Managed Projects to release
  28 independently on top of the Managed Distribution later.
  29
  30 Finding the Managed Projects given a Managed Distribution
  31 =========================================================
  32
  33 Given a Managed Distribution (``.tar.gz``, ``.zip``, RPM, Deb), the Managed
  34 Projects that constitute it can be found in the `taglist.log` file in the root
  35 of the archive.
  36
  37 `taglist.log` files are of the format:
  38
  39 .. code::
  40
  41         <Managed Project> <Git SHA of built commit> <Codename of release>
  42
  43 Finding the Managed Projects Given a Branch
  44 ===========================================
  45
  46 To find the current set of Managed Projects in a given OpenDaylight branch,
  47 examine the `integration/distribution/features/repos/index/pom.xml`_ file that defines the Managed Distribution.
  48
  49 .. _integration/distribution/features/repos/index/pom.xml: https://git.opendaylight.org/gerrit/gitweb?p=integration/distribution.git;a=blob;f=features/repos/index/pom.xml