x/synergy-service

History

Vincent Llorens 524918a027 fix docs for packaging with Ubuntu Change-Id: I9ab22416c8302e340bef027761a4538c8501bc98 Sem-Ver: bugfix		2016-10-20 15:58:59 +02:00
..
debian	Release v1.1.0	2016-09-22 11:20:59 +02:00
docker	fix to get the synergy version when packaging	2016-10-18 11:48:14 +00:00
rpm	RPM: don't output errors on uninstallation	2016-10-04 16:59:30 +02:00
README.md	fix docs for packaging with Ubuntu	2016-10-20 15:58:59 +02:00

README.md

Packaging

Packaging for Ubuntu and CentOS using Docker

We provide Dockerfiles for CentOS 7 and Ubuntu 14.04. A Dockerfile for Ubuntu > 14.04 should work by just changing the "FROM" statement of the Ubuntu 14.04 Dockerfile. Using these, you can easily build rpm and deb packages for synergy-service without having to setup the build system on your own system.

The build process using Docker is made of 3 steps:

Build the docker image
Setup the build variables
Run the build with docker

If the build is successful, the package will be put in the build directory inside the synergy-service directory.

Example for CentOS 7

go into the directory that contains the Dockerfile for CentOS 7
```
cd synergy-service/packaging/docker/centos7
```

build the docker image and tag it

docker build -t synergy-centos7-builder .

launch the container
```
docker run -i -v /path/to/synergy-service:/tmp/synergy-service \
           synergy-centos7-builder
```
This actually mount the synergy-service directory to /tmp/synergy-service on the guest.
the resulting rpm should be in the build directory if successful

Example for Ubuntu 14.04

go into the directory that contains the Dockerfile for Ubuntu 14.04
```
cd synergy-service/packaging/docker/ubuntu-14.04
```

build the docker image and tag it

docker build -t synergy-ubuntu14.04-builder .

launch the container

docker run -i -v /path/to/synergy-service:/tmp/synergy-service \
           synergy-ubuntu14.04-builder

the resulting deb should be in the build directory if successful

Packaging for Ubuntu

Make sure you have the OpenStack/CloudArchive repository setup.

Install the necessary build packages:

debhelper
dh-systemd
build-essential
devscripts
git-core
python-all
python-pbr
python-setuptools

Make a gzip archive of synergy-service named python-synergy-service_VERSION.orig.tar.gz and place it at the same level as the synergy-service directory.
Copy synergy-service/packaging/debian to synergy-service/debian.
Go in the synergy-service directory and build with debuild -us -uc.

The resulting .deb file should be outputed at the same level as the synergy-service directory and .tar.gz archive.

Packaging for CentOS

Install the necessary build packages:

rpm-build
python-devel
python-setuptools

Setup your rpmbuild environment if not already done.

mkdir -p ~/rpmbuild/{BUILD,RPMS,SOURCES,SPECS,SRPMS}

Move synergy-service/packaging/rpm/python-synergy.spec to ~/rpmbuild/SPECS.

Create a source archive (where $VERSION is the current synergy-service version):

cd ~/rpmbuild/SOURCES
cp -r /path/to/synergy-service python-synergy-service-$VERSION
tar cjf python-synergy-service-$VERSION.tar.bz2 python-synergy-service-$VERSION

Go in ~/rpmbuild/SPECS and build with PBR_VERSION=$VERSION rpmbuild -ba python-synergy.spec.
The resulting RPM can be found in ~/rpmbuild/RPMS/noarch.