#!/bin/bash # # Copyright (c) 2018 Intel Corporation # # SPDX-License-Identifier: Apache-2.0 set -o errexit set -o pipefail set -o errtrace [ -n "$DEBUG" ] && set -x script_name="${0##*/}" script_dir="$(dirname $(readlink -f $0))" AGENT_VERSION=${AGENT_VERSION:-} GO_AGENT_PKG=${GO_AGENT_PKG:-github.com/kata-containers/agent} AGENT_BIN=${AGENT_BIN:-kata-agent} AGENT_INIT=${AGENT_INIT:-no} KERNEL_MODULES_DIR=${KERNEL_MODULES_DIR:-""} OSBUILDER_VERSION="unknown" DOCKER_RUNTIME=${DOCKER_RUNTIME:-runc} GO_VERSION="null" export GOPATH=${GOPATH:-${HOME}/go} lib_file="${script_dir}/../scripts/lib.sh" source "$lib_file" handle_error() { local exit_code="${?}" local line_number="${1:-}" echo "Failed at $line_number: ${BASH_COMMAND}" exit "${exit_code}" } trap 'handle_error $LINENO' ERR # Default architecture ARCH=$(uname -m) # distro-specific config file typeset -r CONFIG_SH="config.sh" # optional arch-specific config file typeset -r CONFIG_ARCH_SH="config_${ARCH}.sh" # Name of an optional distro-specific file which, if it exists, must implement the # build_rootfs() function. typeset -r LIB_SH="rootfs_lib.sh" # rootfs distro name specified by the user typeset distro= # Absolute path to the rootfs root folder typeset ROOTFS_DIR # Absolute path in the rootfs to the "init" executable / symlink. # Typically something like "${ROOTFS_DIR}/init typeset init= #$1: Error code if want to exit different to 0 usage() { error="${1:-0}" cat < Specify the agent version. Overrides the AGENT_VERSION environment variable. -h Show this help message. -l List the supported Linux distributions and exit immediately. -o Specify the version of osbuilder to embed in the rootfs yaml description. -r Specify the rootfs base directory. Overrides the ROOTFS_DIR environment variable. -t DISTRO Print the test configuration for DISTRO and exit immediately. Environment Variables: AGENT_BIN Name of the agent binary (used when running sanity checks on the rootfs). Default value: ${AGENT_BIN} AGENT_INIT When set to "yes", use ${AGENT_BIN} as init process in place of systemd. Default value: no AGENT_VERSION Version of the agent to include in the rootfs. Default value: ${AGENT_VERSION:-} AGENT_SOURCE_BIN Path to the directory of agent binary. If set, use the binary as agent but not build agent package. Default value: DISTRO_REPO Use host repositories to install guest packages. Default value: GO_AGENT_PKG URL of the Git repository hosting the agent package. Default value: ${GO_AGENT_PKG} GRACEFUL_EXIT If set, and if the DISTRO configuration specifies a non-empty BUILD_CAN_FAIL variable, do not return with an error code in case any of the build step fails. This is used when running CI jobs, to tolerate failures for specific distributions. Default value: KERNEL_MODULES_DIR Path to a directory containing kernel modules to include in the rootfs. Default value: ROOTFS_DIR Path to the directory that is populated with the rootfs. Default value: <${script_name} path>/rootfs- USE_DOCKER If set, build the rootfs inside a container (requires Docker). Default value: DOCKER_RUNTIME Docker runtime to use when USE_DOCKER is set. Default value: runc Refer to the Platform-OS Compatibility Matrix for more details on the supported architectures: https://github.com/kata-containers/osbuilder#platform-distro-compatibility-matrix EOT exit "${error}" } get_distros() { cdirs=$(find "${script_dir}" -maxdepth 1 -type d) find ${cdirs} -maxdepth 1 -name "${CONFIG_SH}" -printf '%H\n' | while read dir; do basename "${dir}" done } get_test_config() { local -r distro="$1" [ -z "$distro" ] && die "No distro name specified" local config="${script_dir}/${distro}/config.sh" source ${config} echo -e "INIT_PROCESS:\t\t$INIT_PROCESS" echo -e "ARCH_EXCLUDE_LIST:\t\t${ARCH_EXCLUDE_LIST[@]}" } check_function_exist() { function_name="$1" [ "$(type -t ${function_name})" == "function" ] || die "${function_name} function was not defined" } docker_extra_args() { local args="" case "$1" in ubuntu | debian) # Requred to chroot args+=" --cap-add SYS_CHROOT" # debootstrap needs to create device nodes to properly function args+=" --cap-add MKNOD" ;& suse) # Required to mount inside a container args+=" --cap-add SYS_ADMIN" # When AppArmor is enabled, mounting inside a container is blocked with docker-default profile. # See https://github.com/moby/moby/issues/16429 args+=" --security-opt apparmor:unconfined" ;; *) ;; esac echo "$args" } setup_agent_init() { agent_bin="$1" init_bin="$2" [ -z "$agent_bin" ] && die "need agent binary path" [ -z "$init_bin" ] && die "need init bin path" info "Install $agent_bin as init process" mv -f "${agent_bin}" ${init_bin} OK "Agent is installed as init process" } copy_kernel_modules() { local module_dir="$1" local rootfs_dir="$2" [ -z "$module_dir" ] && die "need module directory" [ -z "$rootfs_dir" ] && die "need rootfs directory" local dest_dir="${rootfs_dir}/lib/modules" info "Copy kernel modules from ${KERNEL_MODULES_DIR}" mkdir -p "${dest_dir}" cp -a "${KERNEL_MODULES_DIR}" "${dest_dir}/" OK "Kernel modules copied" } error_handler() { [ "$?" -eq 0 ] && return if [ -n "$GRACEFUL_EXIT" ] && [ -n "$BUILD_CAN_FAIL" ]; then info "Detected a build error, but $distro is allowed to fail (BUILD_CAN_FAIL specified), so exiting sucessfully" touch "$(dirname ${ROOTFS_DIR})/${distro}_fail" exit 0 fi } # Compares two SEMVER-style versions passed as arguments, up to the MINOR version # number. # Returns a zero exit code if the version specified by the first argument is # older OR equal than / to the version in the second argument, non-zero exit # code otherwise. compare_versions() { typeset -i -a v1=($(echo "$1" | awk 'BEGIN {FS = "."} {print $1" "$2}')) typeset -i -a v2=($(echo "$2" | awk 'BEGIN {FS = "."} {print $1" "$2}')) # Sanity check: first version can't be all zero [ "${v1[0]}" -eq "0" ] && \ [ "${v1[1]}" -eq "0" ] && \ die "Failed to parse version number" # Major [ "${v1[0]}" -gt "${v2[0]}" ] && { false; return; } # Minor [ "${v1[0]}" -eq "${v2[0]}" ] && \ [ "${v1[1]}" -gt "${v2[1]}" ] && { false; return; } true } check_env_variables() { # Fetch the first element from GOPATH as working directory # as go get only works against the first item in the GOPATH [ -z "$GOPATH" ] && die "GOPATH not set" GOPATH_LOCAL="${GOPATH%%:*}" [ "$AGENT_INIT" == "yes" -o "$AGENT_INIT" == "no" ] || die "AGENT_INIT($AGENT_INIT) is invalid (must be yes or no)" [ -n "${KERNEL_MODULES_DIR}" ] && [ ! -d "${KERNEL_MODULES_DIR}" ] && die "KERNEL_MODULES_DIR defined but is not an existing directory" [ -n "${OSBUILDER_VERSION}" ] || die "need osbuilder version" } # Builds a rootfs based on the distro name provided as argument build_rootfs_distro() { [ -n "${distro}" ] || usage 1 distro_config_dir="${script_dir}/${distro}" # Source config.sh from distro rootfs_config="${distro_config_dir}/${CONFIG_SH}" source "${rootfs_config}" # Source arch-specific config file rootfs_arch_config="${distro_config_dir}/${CONFIG_ARCH_SH}" if [ -f "${rootfs_arch_config}" ]; then source "${rootfs_arch_config}" fi [ -d "${distro_config_dir}" ] || die "Not found configuration directory ${distro_config_dir}" if [ -z "$ROOTFS_DIR" ]; then ROOTFS_DIR="${script_dir}/rootfs-${OS_NAME}" fi if [ -e "${distro_config_dir}/${LIB_SH}" ];then rootfs_lib="${distro_config_dir}/${LIB_SH}" info "rootfs_lib.sh file found. Loading content" source "${rootfs_lib}" fi CONFIG_DIR=${distro_config_dir} check_function_exist "build_rootfs" if [ -z "$INSIDE_CONTAINER" ] ; then # Capture errors, but only outside of the docker container trap error_handler ERR fi mkdir -p ${ROOTFS_DIR} detect_go_version || die "Could not detect the required Go version for AGENT_VERSION='${AGENT_VERSION:-master}'." echo "Required Go version: $GO_VERSION" if [ -z "${USE_DOCKER}" ] ; then #Generate an error if the local Go version is too old foundVersion=$(go version | sed -E "s/^.+([0-9]+\.[0-9]+\.[0-9]+).*$/\1/g") compare_versions "$GO_VERSION" $foundVersion || \ die "Your Go version $foundVersion is older than the minimum expected Go version $GO_VERSION" else image_name="${distro}-rootfs-osbuilder" generate_dockerfile "${distro_config_dir}" docker build \ --build-arg http_proxy="${http_proxy}" \ --build-arg https_proxy="${https_proxy}" \ -t "${image_name}" "${distro_config_dir}" # fake mapping if KERNEL_MODULES_DIR is unset kernel_mod_dir=${KERNEL_MODULES_DIR:-${ROOTFS_DIR}} docker_run_args="" docker_run_args+=" --rm" docker_run_args+=" --runtime ${DOCKER_RUNTIME}" if [ -z "${AGENT_SOURCE_BIN}" ] ; then docker_run_args+=" --env GO_AGENT_PKG=${GO_AGENT_PKG}" else docker_run_args+=" --env AGENT_SOURCE_BIN=${AGENT_SOURCE_BIN}" docker_run_args+=" -v ${AGENT_SOURCE_BIN}:${AGENT_SOURCE_BIN}" fi docker_run_args+=" $(docker_extra_args $distro)" # Relabel volumes so SELinux allows access (see docker-run(1)) if command -v selinuxenabled > /dev/null && selinuxenabled ; then for volume_dir in "${script_dir}" \ "${ROOTFS_DIR}" \ "${script_dir}/../scripts" \ "${kernel_mod_dir}" \ "${GOPATH_LOCAL}"; do chcon -Rt svirt_sandbox_file_t "$volume_dir" done fi #Make sure we use a compatible runtime to build rootfs # In case Clear Containers Runtime is installed we dont want to hit issue: #https://github.com/clearcontainers/runtime/issues/828 docker run \ --env https_proxy="${https_proxy}" \ --env http_proxy="${http_proxy}" \ --env AGENT_VERSION="${AGENT_VERSION}" \ --env ROOTFS_DIR="/rootfs" \ --env AGENT_BIN="${AGENT_BIN}" \ --env AGENT_INIT="${AGENT_INIT}" \ --env GOPATH="${GOPATH_LOCAL}" \ --env KERNEL_MODULES_DIR="${KERNEL_MODULES_DIR}" \ --env EXTRA_PKGS="${EXTRA_PKGS}" \ --env OSBUILDER_VERSION="${OSBUILDER_VERSION}" \ --env INSIDE_CONTAINER=1 \ --env SECCOMP="${SECCOMP}" \ --env DEBUG="${DEBUG}" \ -v "${script_dir}":"/osbuilder" \ -v "${ROOTFS_DIR}":"/rootfs" \ -v "${script_dir}/../scripts":"/scripts" \ -v "${kernel_mod_dir}":"${kernel_mod_dir}" \ -v "${GOPATH_LOCAL}":"${GOPATH_LOCAL}" \ $docker_run_args \ ${image_name} \ bash /osbuilder/rootfs.sh "${distro}" exit $? fi build_rootfs ${ROOTFS_DIR} } # Used to create a minimal directory tree where the agent can be instaleld. # This is used when a distro is not specified. prepare_overlay() { pushd "${ROOTFS_DIR}" > /dev/null mkdir -p ./etc ./lib/systemd ./sbin ./var ln -sf ./usr/lib/systemd/systemd ./init ln -sf ../../init ./lib/systemd/systemd ln -sf ../init ./sbin/init # Kata sytemd unit file mkdir -p ./etc/systemd/system/basic.target.wants/ ln -sf /usr/lib/systemd/system/kata-containers.target ./etc/systemd/system/basic.target.wants/kata-containers.target popd > /dev/null } # Setup an existing rootfs directory, based on the OPTIONAL distro name # provided as argument setup_rootfs() { info "Create symlink to /tmp in /var to create private temporal directories with systemd" pushd "${ROOTFS_DIR}" >> /dev/null if [ "$PWD" != "/" ] ; then rm -rf ./var/cache/ ./var/lib ./var/log ./var/tmp fi ln -s ../tmp ./var/ # For some distros tmp.mount may not be installed by default in systemd paths if ! [ -f "./etc/systemd/system/tmp.mount" ] && \ ! [ -f "./usr/lib/systemd/system/tmp.mount" ] && [ "$AGENT_INIT" != "yes" ]; then local unitFile="./etc/systemd/system/tmp.mount" info "Install tmp.mount in ./etc/systemd/system" mkdir -p `dirname "$unitFile"` cp ./usr/share/systemd/tmp.mount "$unitFile" || cat > "$unitFile" << EOT # This file is part of systemd. # # systemd is free software; you can redistribute it and/or modify it # under the terms of the GNU Lesser General Public License as published by # the Free Software Foundation; either version 2.1 of the License, or # (at your option) any later version. [Unit] Description=Temporary Directory (/tmp) Documentation=man:hier(7) Documentation=https://www.freedesktop.org/wiki/Software/systemd/APIFileSystems ConditionPathIsSymbolicLink=!/tmp DefaultDependencies=no Conflicts=umount.target Before=local-fs.target umount.target After=swap.target [Mount] What=tmpfs Where=/tmp Type=tmpfs Options=mode=1777,strictatime,nosuid,nodev EOT fi popd >> /dev/null [ -n "${KERNEL_MODULES_DIR}" ] && copy_kernel_modules ${KERNEL_MODULES_DIR} ${ROOTFS_DIR} info "Create ${ROOTFS_DIR}/etc" mkdir -p "${ROOTFS_DIR}/etc" case "${distro}" in "ubuntu" | "debian") echo "I am ubuntu or debian" chrony_conf_file="${ROOTFS_DIR}/etc/chrony/chrony.conf" chrony_systemd_service="${ROOTFS_DIR}/lib/systemd/system/chrony.service" ;; *) chrony_conf_file="${ROOTFS_DIR}/etc/chrony.conf" chrony_systemd_service="${ROOTFS_DIR}/usr/lib/systemd/system/chronyd.service" ;; esac info "Configure chrony file ${chrony_conf_file}" cat >> "${chrony_conf_file}" <