Revision as of 16:44, 13 February 2012 (view source) Lbt (Talk | contribs) (add a systemd serrvice example) ← Older edit		Revision as of 07:06, 17 February 2012 (view source) Sonach (Talk | contribs) (→‎Setup) Newer edit →
Line 59:		Line 59:
	cd release-tools; make		cd release-tools; make
		+	Note: after doing "make", you should do "make update" to grab the rpm binaries.
	=== Update ===		=== Update ===

---

Revision as of 07:06, 17 February 2012

Mer provides the Mer Delivery System (MDS) to make it easy for vendors to track upstream Mer releases.

Contents 1 Overview 2 Operations 2.1 MDS tools 2.1.1 Installation 2.1.2 Update 2.2 Mer release(s) 2.2.1 Setup 2.2.2 Update 2.3 Setup an API service for Mer releases 2.3.1 Add the MDS project as a remote link 2.3.2 MDS Build Targets 2.3.3 Use MDS repos as a build target 2.4 Running under Systemd 3 Limitations

Overview

MDS is a small collection of tools that both supports distributing Mer binary releases and OBS build targets to vendors and accessing the local copy of the release from a private vendor-managed OBS.

Operations

MDS tools

Installation

The MDS is installed in the root of the data area which will store the Mer releases (several Gb). This may be a dedicated VM.

Ensure the system has the following installed:

• git
• python
• make
• smmap: http://pypi.python.org/pypi/smmap
• async: http://pypi.python.org/pypi/async
• gitdb: http://pypi.python.org/pypi/gitdb
• gitpython homepage: http://pypi.python.org/pypi/GitPython/0.3.2.RC1
• gitpython install guide: http://packages.python.org/GitPython/0.3.2/intro.html#installing-gitpython
• cpio

Get the release tools

git clone http://review.merproject.org/p/mer/release-tools

Update

The tools are updated periodically - simply run

git pull

Eventually:

git remote update

to update and then

git checkout vXXX

to obtain the version required.

Mer release(s)

Setup

This step will pull (using rsync) all the git repositories for the Mer packages (nb: this is a huge download).

It will then build a list of the packages, create a set of mappings and prepare the OBS event stream.

Finally the OBS projects are cloned and extracted ready for the API service.

Note: You might need to set rsync proxy:

export RSYNC_PROXY=proxy.company.com:8080

cd release-tools; make

Note: after doing "make", you should do "make update" to grab the rpm binaries.

Update

An update simply requires:

cd release-tools; make update

This will re-synchnronise the package git repos, the OBS projects and reset the 'latest' link.

It can be run periodically to ensure that up-to-date changes are available.

There is no mechanism at the moment to specify that certain releases should be made available.

Setup an API service for Mer releases

MDS runs a simple http server that emulates the OBS api for a static release.

To start this 'fake obs server' (hence the original name for the packages):

python tools/fakeobs.py 8001 &

Add the MDS project as a remote link

A local OBS can now add a 'remote link' to the MDS API service (FakeOBS) port 8001, /public, note, http, not-https. So assuming the MDS is running on a machine called 'mer' then this would work.

<project name="MerDS">
 <title>Mer Delivery System</title>
 <description>A 'remote link' to the MDS API service running against a local copy of Mer
 </description>
 <remoteurl>http://mer:8001/public</remoteurl>
 <person userid="Admin" role="maintainer"/>
 <person userid="Admin" role="bugowner"/>
</project>

MDS Build Targets

Mer supports a number of build targets for various release points and architectures.

These are organised as:

<link>:<area>:<arch>:<release>

So the build target:

MerDS:Core:armv6l:0.20120120.1

would build against the collection of packages that forms 'Core' built for the armv6l architecture.

Use MDS repos as a build target

Once your project is set-up, you can add Mer build targets to the OBS and they should start building automatically. Given a setup as above then a project meta would contain repositories similar to this:

<project name="MyMerUx">
  <title>MyMerUx</title>
  <description>
  A UX building against Mer
  </description>
  <person userid="Admin" role="maintainer"/>
  <person userid="Admin" role="bugowner"/>
  <repository name="MyMerUX_Mer_Core_i586">
    <path repository="Core_i586" project="MerDS:Core:i586"/>
    <arch>i586</arch>
  </repository>
</project>

Running under Systemd

MDS can (and should) be run as a service. This sample systemd service file may be useful:

[Unit]
Description=Mer Delivery System
After=multi-user.target

[Service]
User=david
Group=greaves
WorkingDirectory=/data/release-tools/
ExecStart=/usr/bin/python /data/release-tools/tools/fakeobs.py 8001

[Install]
WantedBy=multi-user.target

Limitations

There is no way to limit MDS to only certain architectures.

There is no way to see the list of build target releases or architectures.

You can [https://bugs.merproject.org/enter_bug.cgi?product=Mer%20Core log a bug] (against the .Release-tools component) or show up in #mer and poke Stskeeps if there's any questions.