quickrpm.sh

#!/bin/bash
set -euo pipefail

OWNER=${OWNER:-microshift-io}
REPO=${REPO:-microshift}
BRANCH=${BRANCH:-main}
TAG=${TAG:-latest}
RPM_SOURCE=${RPM_SOURCE:-github}  # Accepted values: github, copr-nightly
COPR_REPO=${COPR_REPO:-@microshift-io/microshift-nightly}

LVM_DISK="/var/lib/microshift-okd/lvmdisk.image"
VG_NAME="myvg1"

WORKDIR=$(mktemp -d /tmp/microshift-quickrpm-XXXXXX)
trap 'rm -rf "${WORKDIR}"' EXIT

function check_prerequisites() {
    # Supported platforms
    case "$(uname -m)" in
    x86_64|aarch64)
        ;;
    *)
        echo "ERROR: Unsupported platform: $(uname -m)"
        exit 1
    esac

    # Supported operating systems
    # shellcheck disable=SC1091
    source /etc/os-release
    case "${ID}" in
    centos|fedora|rhel)
        ;;
    *)
        echo "ERROR: Unsupported operating system: ${ID}"
        exit 1
    esac
}

# The CentOS 10 Stream does not include the containernetworking-plugins package
# in the AppStream repository. Download the package from CentOS 9 Stream because
# it is required by MicroShift 4.20 and older due to cri-o dependencies.
function centos10_cni_plugins() {
    # Check if the operating system is CentOS 10 Stream
    # shellcheck disable=SC1091
    source /etc/os-release
    if [ "${ID}" != "centos" ] || [ "${VERSION_ID}" != "10" ] ; then
        return 0
    fi

    # If containernetworking-plugins is already installed, exit
    if rpm -q containernetworking-plugins &>/dev/null; then
        return 0
    fi

    dnf install -y \
        --repofrompath=c9appstream,"https://mirror.stream.centos.org/9-stream/AppStream/$(uname -m)/os/" \
        --repo=c9appstream \
        --nogpgcheck \
        containernetworking-plugins
}

function download_script() {
    local -r script=$1
    local -r scriptpath="src/rpm/${script}"

    curscriptdir="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"

    # If the quickrpm.sh is executed from the repository, copy local script.
    # Otherwise, fetch them from the github.
    if [ -f "${curscriptdir}/../${scriptpath}" ]; then
        cp -v "${curscriptdir}/../${scriptpath}" "${WORKDIR}/${script}"
    else
        curl -fSsL --retry 5 --max-time 60 \
            "https://github.com/${OWNER}/${REPO}/raw/${BRANCH}/src/rpm/${script}" \
            -o "${WORKDIR}/${script}"
        chmod +x "${WORKDIR}/${script}"
    fi
}

function install_microshift_packages() {
    # Disable weak dependencies to avoid the deployment of the microshift-networking
    # RPM, which is not necessary when microshift-kindnet RPM is installed.
    dnf install -y --setopt=install_weak_deps=False \
        microshift microshift-kindnet microshift-topolvm

    # shellcheck disable=SC1091
    source /etc/os-release
    if [ "${ID}" == "fedora" ]; then
        # Fedora doesn't have old packages - downgrading greenboot is not possible.
        return 0
    fi

    # Pin the greenboot package to 0.15.z until the following issue is resolved:
    # https://github.com/fedora-iot/greenboot-rs/issues/132
    dnf install -y 'greenboot-0.15.*'
}

function install_rpms_copr() {
    dnf copr enable -y "${COPR_REPO}"

    "${WORKDIR}/create_repos.sh" -rhocp-mirror
    install_microshift_packages
    # Keep the repos, so the `dnf update` works for updated MicroShift RPMs and
    # updated dependencies.
}

function install_rpms() {
    # Download the RPMs from the release
    mkdir -p "${WORKDIR}/rpms"
    curl -L -s --retry 5 \
        "https://github.com/${OWNER}/${REPO}/releases/download/${TAG}/microshift-rpms-$(uname -m).tgz" | \
        tar zxf - -C "${WORKDIR}/rpms"

    # Create the RPM repository and install the RPMs
    "${WORKDIR}/create_repos.sh" -create "${WORKDIR}/rpms"
    install_microshift_packages
    "${WORKDIR}/create_repos.sh" -delete
}

function prepare_lvm_disk() {
    local -r lvm_disk="$1"
    local -r vg_name="$2"

    if [ -f "${lvm_disk}" ]; then
        echo "INFO: '${lvm_disk}' already exists. Clearing and reusing it."
        dd if=/dev/zero of="${lvm_disk}" bs=1M count=100 >/dev/null
        return 0
    fi

    mkdir -p "$(dirname "${lvm_disk}")"
    truncate --size=1G "${lvm_disk}"
}

function setup_lvm_service() {
    local -r lvm_disk="$1"
    local -r vg_name="$2"

    # Note that escaping quotes is necessary to avoid systemd parsing issues
    mkdir -p /etc/systemd/system/microshift.service.d
    cat > /etc/systemd/system/microshift.service.d/99-lvm-config.conf <<EOF
[Service]
ExecStartPre=/bin/bash -c 'vgs "${vg_name}" || vgcreate -f -y "${vg_name}" "\$(losetup --find --show --nooverlap "${lvm_disk}")"'
EOF
    systemctl daemon-reload
}

function start_microshift() {
    "${WORKDIR}/postinstall.sh"
    systemctl start microshift.service
}

# Check if the script is running as root
if [ "$(id -u)" -ne 0 ]; then
    echo "ERROR: This script must be run as root (use sudo)"
    exit 1
fi

# Update the 'latest' tag to the latest released version (only for github source)
if [ "${RPM_SOURCE}" == "github" ] && [ "${TAG}" == "latest" ] ; then
    dnf install -y jq
    TAG="$(curl -s --max-time 60 "https://api.github.com/repos/${OWNER}/${REPO}/releases/latest" | jq -r .tag_name)"
    if [ -z "${TAG}" ] || [ "${TAG}" == "null" ] ; then
        echo "ERROR: Could not determine the latest release tag from GitHub"
        exit 1
    fi
fi

# Run the procedures
check_prerequisites
centos10_cni_plugins
download_script create_repos.sh
download_script postinstall.sh

case "${RPM_SOURCE}" in
github)
    install_rpms
    ;;
copr-nightly)
    install_rpms_copr
    ;;
*)
    echo "ERROR: Unsupported RPM_SOURCE: ${RPM_SOURCE}. Use 'github' or 'copr-nightly'."
    exit 1
    ;;
esac
prepare_lvm_disk  "${LVM_DISK}" "${VG_NAME}"
setup_lvm_service "${LVM_DISK}" "${VG_NAME}"
start_microshift

# Follow-up instructions
echo
echo "MicroShift is running on the host"
echo "LVM disk:  ${LVM_DISK}"
echo "VG name:   ${VG_NAME}"
echo
echo "To verify that MicroShift pods are up and running, run the following command:"
echo " - sudo kubectl get pods -A --kubeconfig /var/lib/microshift/resources/kubeadmin/kubeconfig"
echo
echo "To uninstall MicroShift, run the following command:"
echo " - curl -s https://${OWNER}.github.io/${REPO}/quickclean.sh | sudo bash"