synergy-service/packaging/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:

1. Build the docker image

2. Setup the build variables

3. 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 .
  

• edit the file synergy-service/packaging/docker/build_env.sh to define environment variables.

• launch the container

  docker run -i -v /path/to/synergy-service:/tmp/synergy-service \
             --env-file=/path/to/synergy-service/packaging/docker/build_env.sh \
             synergy-centos7-builder
  

  This actually mount the synergy-service directory to /tmp/synergy-service on the guest. It also loads environment variables from the build_env.sh file.

• 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 .
  

• edit the file synergy-service/packaging/docker/build_env.sh to define environment variables.

• launch the container

  docker run -i -v /path/to/synergy-service:/tmp/synergy-service \
             --env-file=/path/to/synergy-service/packaging/docker/build_env.sh \
             synergy-ubuntu14.04-builder
  

• the resulting deb should be in the build directory if successful

Packaging for Ubuntu

1. Install the necessary build packages:

• debhelper
• dh-systemd
• build-essential
• devscripts
• python-all
• python-setuptools

2. Make a gzip archive of synergy-service named python-synergy-service_VERSION.orig.tar.gz.

3. Copy synergy-service/packaging/debian to synergy-service/debian.

4. Go in the synergy-service directory and build with debuild -us -uc.

Packaging for CentOS

1. Install the necessary build packages:

• rpm-build
• python-devel
• python-setuptools

2. Setup your rpmbuild environment if not already done.

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

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

4. 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
   

5. Go in ~/rpmbuild/SPECS and build with PBR_VERSION=$VERSION rpmbuild -ba python-synergy.spec.

6. The resulting RPM can be found in ~/rpmbuild/RPMS/noarch.