Building and Installing the MicroShift RPMs
Building the RPMs
MicroShift binary with systemd unit file and the required SELinux submodule can be built as an RPM using make on an RPM-based distribution.
Install the MicroShift build dependencies and the RPM specific build-time packages.
sudo dnf install -y git golang rpm-build selinux-policy-devel container-selinux
Clone the repository and cd into it:
The available community documentation is not currently compatible with the latest MicroShift source code. To build the latest MicroShift RPMs, follow the instructions in the openshift/microshift GitHub repository.
Otherwise, use the 4.8.0-microshift-2022-04-20-141053 branch when working with the source repository and these instructions.
git clone -b 4.8.0-microshift-2022-04-20-141053 https://github.com/openshift/microshift.git
cd microshift
Build the SELinux and MicroShift RPMs with:
make rpm
RPMs will be placed in ./packaging/rpm/_rpmbuild/RPMS/. There are two RPMs that will be required to install:
packaging/rpm/_rpmbuild/RPMS/noarch/microshift-selinux-*
packaging/rpm/_rpmbuild/RPMS/x86_64/microshift-*
Installing the RPMs
Enable the CRI-O repository:
command -v subscription-manager &> /dev/null \
&& subscription-manager repos --enable rhocp-4.8-for-rhel-8-x86_64-rpms
sudo dnf module enable -y cri-o:1.21
sudo dnf module enable -y cri-o:1.21
Install the MicroShift and the SELinux policies:
sudo dnf localinstall -y packaging/rpm/_rpmbuild/RPMS/noarch/microshift-selinux-*
sudo dnf localinstall -y packaging/rpm/_rpmbuild/RPMS/x86_64/microshift-*
Running the RPMs
Start CRI-O and MicroShift services:
sudo systemctl enable crio --now
sudo systemctl enable microshift --now
To install OpenShift and Kubernetes clients, follow Getting Started: Install Clients.
To configure the kubeconfig, follow Getting Started: Copy Kubeconfig.
It is now possible to run oc or kubectl commands against the MicroShift environment.
Verify that MicroShift is running:
oc get pods -A
You can stop MicroShift service with systemd:
sudo systemctl stop microshift
- cluster data at
/var/lib/microshiftand/var/lib/kubelet, will not be deleted upon stopping services. Upon a restart, the cluster state will persist as long as the storage is intact.
Check MicroShift with
sudo podman ps
sudo critcl ps
For more on running MicroShift, refer to the user documentation