Installation

This chapter will guide you through all the steps needed to setup Cekit on your operating system.

Installing Cekit

We provide RPM packages for Fedora, CentOS, RHEL distribution. Cekit installation on other platforms is still possible via pip

Fedora / CentOS / RHEL

On RHEL derivatives we strongly suggest installing Cekit using the YUM/DNF package manager. We provide a COPR repository for Cekit which contains everything needed to install Cekit.

Fedora

Supported versions: 27, 28.

For Fedora we provide custom Copr repository. To enable the repository and install Cekit on your system please run:

yum install yum-plugin-copr
yum copr enable @cekit/cekit
yum install python2-cekit

RHEL

Supported versions: 7.x

For RHEL we provide custom Copr repository. To enable the repository and install Cekit on your system please run:

curl https://copr.fedorainfracloud.org/coprs/g/cekit/cekit/repo/epel-7/group_cekit-cekit-epel-7.repo -o /etc/yum.repos.d/cekit-epel-7.repo
yum install python2-cekit

Other systems

We strongly advise to use Virtualenv to install Cekit. Please consult your package manager for the correct package name.

To create custom Python virtual environment please run following commands on your system:

# Prepare virtual environment
virtualenv ~/cekit
source ~/cekit/bin/activate

# Install Cekit
# Execute the same command to upgrade to latest version
pip install -U cekit

# Now you are able to run Cekit
cekit --help

Note

Every time you want to use Cekit you must activate Cekit Python virtual environment by executing source ~/cekit/bin/activate

Build

To build container images you need one of the following:

  • docker
  • buildah

Test

For running tests you need:

  • docker
  • docker python bindings
  • behave
  • python-lxml

Upgrading

Fedora / CentOS / RHEL

On this platform you should be using RPM and our COPR repository for Cekit

Note: We assume, that you have this repository enabled on your system

Fedora

Supported versions: 25, 26, 27.

dnf update python3-cekit

CentOS & RHEL

Supported versions: 7.

yum update python2-cekit

Other systems

We suggest using pip and Virtualenv to host you Cekit.

# Activate virtual environment
source ~/cekit/bin/activate

pip install -U cekit

Upgrading from Concreate

Cekit and Concreate are the very same tool. Concreate was rename to Cekit in 2.0 release.

Fedora / CentOS / RHEL

You should be using RPM and yum/dnf to manage Cekit/Concreate installation here.

Fedora

Supported versions: 25, 26, 27.

dnf remove python3-concreate
dnf copr remove goldmann/concreate

dnf copr enable @cekit/cekit
dnf install python3-cekit

CentOS

Supported versions: 7.

yum remove python2-concreate
rm -rf  /etc/yum.repos.d/_copr_goldmann-concreate.repo

yum copr enable @cekit/cekit
yum install python2-cekit

RHEL

Supported versions: 7.
yum remove python2-concreate
rm -rf /etc/yum.repos.d/goldmann-concreate-epel-7.repo

curl https://copr.fedorainfracloud.org/coprs/g/cekit/cekit/repo/epel-7/group_cekit-cekit-epel-7.repo -o /etc/yum.repos.d/cekit-epel-7.repo
yum install python2-cekit

Other systems

We strongly advise to use Virtualenv to install Cekit. Please consult your package manager of choice for the correct package name.

# Activate virtual environment
source ~/cekit/bin/activate

pip uninstall concreate
pip install -U cekit

Dotfile migration

Concreate used ~/.concreate.d and ~/.concreate dot files to held its configuration. This was changed with Cekit. Cekit uses only ~/.cekit directory to host all its configuration files.

To migrate your configuration please run:

mv ~/.concreate.d ~/.cekit
mv ~/.concreate ~/.cekit/config