Installation¶
This chapter will guide you through all the steps needed to setup Cekit on your operating system.
Contents
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
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
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
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