livekit安装脚本详解

livekit安装脚本详解

在私有化部署时，官网是执行了一个脚本。接下来将对这个脚本进行解析。

livekit脚本解析

脚本最终地址是：

https://raw.githubusercontent.com/livekit/livekit/master/install-livekit.sh

脚本内容解析：

在使用未定义的变量时脚本会立即退出。

set -u

确保错误处理函数会捕获来自任何子进程的错误。

set -o errtrace

当任何命令出现错误时，脚本立即退出。

set -o errexit

确保管道中的所有命令都必须成功，才能返回成功状态。

set -o pipefail

常量定义,定义GitHub存储库名称为livekit

REPO="livekit"

INSTALL_PATH="/usr/local/bin"

指定安装路径为/usr/local/bin。

INSTALL_PATH="/usr/local/bin"

日志和错误处理函数,log(): 打印日志消息。

log()  { printf "%b\n" "$*"; }

abort(): 打印错误消息并终止脚本执行。

abort() {
  printf "%s\n" "$@" >&2
  exit 1
}

获取最新版本函数，通过GitHub API获取LiveKit最新发布的版本号。

get_latest_version()
{
  latest_version=$(curl -s https://api.github.com/repos/livekit/$REPO/releases/latest | grep -oP '"tarball_url": ".*/tarball/v\K([^/]*)(?=")')
  printf "%s" "$latest_version"
}

检查是否使用了Bash,确保脚本在Bash环境中运行，否则终止脚本。

if [ -z "${BASH_VERSION:-}" ]
then
  abort "This script requires bash"
fi

检查安装路径是否存在,检查指定的安装路径是否存在，如果不存在则终止脚本。

if [ ! -d ${INSTALL_PATH} ]
then
  abort "Could not install, ${INSTALL_PATH} doesn't exist"
fi

检查是否有写入权限，如果当前用户对安装路径没有写权限，则使用sudo命令来提升权限。

SUDO_PREFIX=""
if [ ! -w ${INSTALL_PATH} ]
then
  SUDO_PREFIX="sudo"
  log "sudo is required to install to ${INSTALL_PATH}"
fi

检查cURL是否已安装，确保cURL已安装，否则终止脚本。

if ! command -v curl >/dev/null
then
  abort "cURL is required and is not found"
fi

操作系统检查，确保脚本在Linux系统上运行，如果是MacOS或其他非Linux系统则终止脚本。

OS="$(uname)"
if [[ "${OS}" == "Darwin" ]]
then
  abort "Installer not supported on MacOS, please install using Homebrew."
elif [[ "${OS}" != "Linux" ]]
then
  abort "Installer is only supported on Linux."
fi

架构检查与修正，检查系统架构并将其转换为标准格式，用于下载适配的二进制文件。

ARCH="$(uname -m)"

# fix arch on linux
if [[ "${ARCH}" == "aarch64" ]]
then
  ARCH="arm64"
elif [[ "${ARCH}" == "x86_64" ]]
then
  ARCH="amd64"
fi

获取最新版本和下载地址，获取最新的版本号，并构建对应架构的下载地址。

VERSION=$(get_latest_version)
ARCHIVE_URL="https://github.com/livekit/$REPO/releases/download/v${VERSION}/${REPO}_${VERSION}_linux_${ARCH}.tar.gz"

验证版本格式，确保版本号符合语义化版本（SemVer）格式，否则终止脚本。

if ! [[ "${VERSION}" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]
then
  abort "Invalid version: ${VERSION}"
fi

打印安装版本和下载URL的信息。

log "Installing ${REPO} ${VERSION}"
log "Downloading from ${ARCHIVE_URL}..."

下载并解压安装文件，使用cURL下载压缩包，并通过tar解压到指定的安装路径。

curl -s -L "${ARCHIVE_URL}" | ${SUDO_PREFIX} tar xzf - -C "${INSTALL_PATH}" --wildcards --no-anchored "$REPO*"

打印安装成功信息，打印安装成功后的路径信息。

log "\nlivekit-server is installed to $INSTALL_PATH\n"

总结：该脚本主要是通过bash进行一些环境的检测，比如目录路径、权限等检测，还有根据系统去下载相对应的livekit可执行程序，并解压到bin目录下。

在任何目录下都能运行 livekit-server ，因为它已经被安装到一个在 PATH 中的目录 (/usr/local/bin)。系统自动查找这个目录中的可执行文件，所以你可以直接运行命令，而不需要指定完整路径。