#!/usr/bin/env bash # Copyright The kagent Authors. # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. # The install script is based off of the MIT-licensed script from glide, # the package manager for Go: https://github.com/Masterminds/glide.sh/blob/master/get : ${BINARY_NAME:="kagent"} : ${USE_SUDO:="true"} : ${DEBUG:="false"} : ${VERIFY_CHECKSUM:="true"} : ${KAGENT_INSTALL_DIR:="/usr/local/bin"} KAGENT_RELEASES="https://github.com/kagent-dev/kagent/releases" HAS_CURL="$(type "curl" &> /dev/null && echo true || echo false)" HAS_WGET="$(type "wget" &> /dev/null && echo true || echo false)" HAS_OPENSSL="$(type "openssl" &> /dev/null && echo true || echo false)" HAS_GPG="$(type "gpg" &> /dev/null && echo true || echo false)" HAS_GIT="$(type "git" &> /dev/null && echo true || echo false)" HAS_TAR="$(type "tar" &> /dev/null && echo true || echo false)" # initArch discovers the architecture for this system. initArch() { ARCH=$(uname -m) case $ARCH in armv5*) ARCH="armv5";; armv6*) ARCH="armv6";; armv7*) ARCH="arm";; aarch64) ARCH="arm64";; x86) ARCH="386";; x86_64) ARCH="amd64";; i686) ARCH="386";; i386) ARCH="386";; esac } # initOS discovers the operating system for this system. initOS() { OS=$(echo `uname`|tr '[:upper:]' '[:lower:]') case "$OS" in # Minimalist GNU for Windows mingw*|cygwin*|msys*) OS='windows';; esac EXT="" if [ "$OS" == "windows" ]; then EXT=".exe" fi } # runs the given command as root (detects if we are root already) runAsRoot() { if [ $EUID -ne 0 -a "$USE_SUDO" = "true" ]; then sudo "${@}" else "${@}" fi } # verifySupported checks that the os/arch combination is supported for # binary builds, as well whether or not necessary tools are present. verifySupported() { # Keep in sync with the release binaries built by go/Makefile. case "${OS}-${ARCH}" in darwin-amd64|darwin-arm64|linux-amd64|linux-arm64|windows-amd64) ;; *) echo "No prebuilt binary for ${OS}-${ARCH}." echo "To build from source, go to https://github.com/kagent-dev/kagent" exit 1 ;; esac if [ "${HAS_CURL}" != "true" ] && [ "${HAS_WGET}" != "true" ]; then echo "Either curl or wget is required" exit 1 fi if [ "${VERIFY_CHECKSUM}" == "true" ] && [ "${HAS_OPENSSL}" != "true" ]; then echo "In order to verify checksum, openssl must first be installed." echo "Please install openssl or set VERIFY_CHECKSUM=false in your environment." exit 1 fi if [ "${HAS_GIT}" != "true" ]; then echo "[WARNING] Could not find git. It is required for plugin installation." fi if [ "${HAS_TAR}" != "true" ]; then echo "[ERROR] Could not find tar. It is required to extract the kagent binary archive." exit 1 fi } # latestTag prints the tag of the release GitHub marks latest, read from the # redirect of /releases/latest. Unlike the GitHub API, it is not rate limited. latestTag() { if [ "${HAS_CURL}" == "true" ]; then curl -sSI "${KAGENT_RELEASES}/latest" 2>/dev/null else wget -S --spider --max-redirect=0 "${KAGENT_RELEASES}/latest" 2>&1 fi | tr -d '\r' | sed -n 's#^ *[Ll]ocation: .*/releases/tag/##p' | head -n 1 } # checkDesiredVersion resolves TAG: the --version argument, or else the release # GitHub marks latest. checkDesiredVersion() { if [ "x$DESIRED_VERSION" != "x" ]; then TAG=$DESIRED_VERSION return fi TAG=$( latestTag ) if [ "x$TAG" == "x" ]; then echo "Could not resolve the latest kagent release from ${KAGENT_RELEASES}/latest." echo "Use --version to choose a release." exit 1 fi } # checkKagentInstalledVersion checks which version of kagent is installed and # if it needs to be changed. It asks only the CLI, never a kagent server. checkKagentInstalledVersion() { if [[ -f "${KAGENT_INSTALL_DIR}/${BINARY_NAME}${EXT}" ]]; then local version version=$( "${KAGENT_INSTALL_DIR}/${BINARY_NAME}${EXT}" version --client 2>/dev/null \ | sed -n 's/.*"kagent_version": *"\([^"]*\)".*/\1/p' || true ) if [[ "$version" == "$TAG" ]]; then echo "kagent ${version} is already ${DESIRED_VERSION:-latest}" return 0 else echo "kagent ${TAG} is available. Changing from version ${version:-unknown}." return 1 fi else return 1 fi } # downloadFile downloads the latest binary package and also the checksum # for that binary. downloadFile() { KAGENT_DIST="kagent-$OS-$ARCH$EXT" DOWNLOAD_URL="$KAGENT_RELEASES/download/$TAG/$KAGENT_DIST" CHECKSUM_URL="$DOWNLOAD_URL.sha256" KAGENT_TMP_ROOT="$(mktemp -dt kagent-installer-XXXXXX)" KAGENT_TMP_FILE="$KAGENT_TMP_ROOT/$KAGENT_DIST" KAGENT_SUM_FILE="$KAGENT_TMP_ROOT/$KAGENT_DIST.sha256" echo "Downloading $DOWNLOAD_URL" if [ "${HAS_CURL}" == "true" ]; then curl -SsLf "$CHECKSUM_URL" -o "$KAGENT_SUM_FILE" curl -SsLf "$DOWNLOAD_URL" -o "$KAGENT_TMP_FILE" elif [ "${HAS_WGET}" == "true" ]; then wget -q -O "$KAGENT_SUM_FILE" "$CHECKSUM_URL" wget -q -O "$KAGENT_TMP_FILE" "$DOWNLOAD_URL" fi } # verifyFile verifies the SHA256 checksum of the binary package # and the GPG signatures for both the package and checksum file # (depending on settings in environment). verifyFile() { if [ "${VERIFY_CHECKSUM}" == "true" ]; then verifyChecksum fi } # installFile installs the kagent binary. installFile() { echo "Preparing to install $BINARY_NAME into ${KAGENT_INSTALL_DIR}" runAsRoot chmod +x "$KAGENT_TMP_FILE" runAsRoot cp "$KAGENT_TMP_FILE" "$KAGENT_INSTALL_DIR/$BINARY_NAME$EXT" echo "$BINARY_NAME installed into $KAGENT_INSTALL_DIR/$BINARY_NAME$EXT" } # verifyChecksum verifies the SHA256 checksum of the binary package. verifyChecksum() { printf "Verifying checksum... " local sum=$(openssl sha1 -sha256 ${KAGENT_TMP_FILE} | awk '{print $2}') local expected_sum=$(cat ${KAGENT_SUM_FILE} | awk '{print $1}') if [ "$sum" != "$expected_sum" ]; then echo "SHA sum of ${KAGENT_TMP_FILE} does not match. Aborting." exit 1 fi echo "Done." } # fail_trap is executed if an error occurs. fail_trap() { result=$? if [ "$result" != "0" ]; then if [[ -n "$INPUT_ARGUMENTS" ]]; then echo "Failed to install $BINARY_NAME with the arguments provided: $INPUT_ARGUMENTS" help else echo "Failed to install $BINARY_NAME" fi echo -e "\tFor support, go to https://github.com/kagent-dev/kagent." fi cleanup exit $result } # testVersion tests the installed client to make sure it is working. testVersion() { set +e KAGENT="$(command -v "$BINARY_NAME$EXT")" if [ "$?" = "1" ]; then echo "$BINARY_NAME not found. Is $KAGENT_INSTALL_DIR on your "'$PATH?' exit 1 fi set -e } # help provides possible cli installation arguments help () { echo "Accepted cli arguments are:" echo -e "\t[--help|-h ] ->> prints this help" echo -e "\t[--version|-v ] . When not defined it installs the release GitHub marks latest" echo -e "\te.g. --version v1.0.0" echo -e "\t[--no-sudo] ->> install without sudo (installs to \$HOME/bin instead of /usr/local/bin)" } # cleanup temporary files to avoid https://github.com/helm/helm/issues/2977 cleanup() { if [[ -d "${KAGENT_TMP_ROOT:-}" ]]; then rm -rf "$KAGENT_TMP_ROOT" fi } # checkHomeBinPath checks if $HOME/bin is in the user's PATH and provides warnings and instructions if it is missing. checkHomeBinPath() { case ":$PATH:" in *":$HOME/bin:"*) return 0 ;; esac echo "Warning: $HOME/bin is not in your PATH. You may need to add it to your PATH to use kagent." echo "You can add it by running:" cat <> ~/.bashrc # for bash echo 'export PATH="\$HOME/bin:\$PATH"' >> ~/.zshrc # for zsh echo 'export PATH="\$HOME/bin:\$PATH"' >> ~/.profile # for other shells EOF } # Execution #Stop execution on any error trap "fail_trap" EXIT set -e # Set debug if desired if [ "${DEBUG}" == "true" ]; then set -x fi # Parsing input arguments (if any) export INPUT_ARGUMENTS="${@}" set -u while [[ $# -gt 0 ]]; do case $1 in '--version'|-v) shift if [[ $# -ne 0 ]]; then export DESIRED_VERSION="${1}" if [[ "$1" != "v"* ]]; then echo "Expected version arg ('${DESIRED_VERSION}') to begin with 'v', fixing..." export DESIRED_VERSION="v${1}" fi else echo -e "Please provide the desired version. e.g. --version v0.1.0" exit 0 fi ;; '--no-sudo') USE_SUDO="false" KAGENT_INSTALL_DIR="$HOME/bin" if [ ! -d "$HOME/bin" ]; then mkdir -p "$HOME/bin" echo "Created directory $HOME/bin" fi checkHomeBinPath ;; '--help'|-h) help exit 0 ;; *) exit 1 ;; esac shift done set +u initArch initOS verifySupported checkDesiredVersion if ! checkKagentInstalledVersion; then downloadFile verifyFile installFile fi testVersion cleanup