feat: 为所有脚本添加远程库加载支持
## 功能概述 实现了智能远程库加载机制，允许脚本从远程 Gitea 仓库动态下载公共库， 同时保留本地库优先的策略，确保脚本可以独立运行而不依赖本地项目结构。 ## 变更内容 ### 新增文件 - **common/remote_loader.sh**: 核心远程加载器 - 支持 curl/wget 双重下载方式 - 临时文件自动清理机制 - 环境变量可配置仓库 URL - **examples/remote_example.sh**: 纯远程模式示例 - 演示完全独立的远程加载脚本 - 适合单文件分发场景 - **examples/hybrid_loader_template.sh**: 混合模式模板 - 本地优先 + 远程回退策略 - 适合仓库内脚本 - **examples/REMOTE_LOADER_README.md**: 完整使用文档 - 三种使用模式详解 - 故障排除指南 - 最佳实践建议 ### 更新脚本（版本 2.1.0） 所有主要脚本均升级到 2.1.0 版本，支持智能库加载： - **linux/create_raid0_array.sh** - **linux/repartition_disks.sh** - **linux/install_oh_my_zsh.sh** - **gcp/create_ai_projects.sh** - **gcp/delete_all_projects.sh** - **oci/create_instance.sh** - **common/demo_usage.sh** ## 加载策略 1. 检查 FORCE_REMOTE=1 环境变量 → 强制远程 2. 检查本地库存在性 → 优先使用本地 3. 本地不存在 → 自动回退远程 4. 远程失败 → 友好错误提示 ## 使用示例 ### 本地模式（默认） ```bash ./linux/create_raid0_array.sh ``` ### 强制远程模式 ```bash FORCE_REMOTE=1 ./linux/create_raid0_array.sh ``` ### 自定义仓库 URL ```bash REMOTE_LIB_URL=https://example.com/repo ./script.sh ``` ## 技术特性 - ✅ 向后兼容：默认使用本地库，行为不变 - ✅ 离线可用：本地库存在时无需网络 - ✅ 独立分发：支持单文件脚本分发 - ✅ 错误处理：详细的错误信息和诊断建议 - ✅ 环境可配：REMOTE_LIB_URL 和 FORCE_REMOTE - ✅ 自动清理：临时文件通过 trap 自动删除
This commit is contained in:
@@ -3,17 +3,75 @@
|
||||
# 文件名: demo_usage.sh
|
||||
# 描述: 公共函数库功能演示和使用示例
|
||||
# 作者: Cloud Tools Project
|
||||
# 版本: 1.0.0
|
||||
# 版本: 2.1.0（支持远程库加载）
|
||||
# ============================================================================
|
||||
|
||||
set -euo pipefail # 启用严格模式
|
||||
set -euo pipefail
|
||||
|
||||
# 获取脚本目录
|
||||
# ============================================================================
|
||||
# 远程库加载配置
|
||||
# ============================================================================
|
||||
|
||||
# 远程仓库 URL（可通过环境变量覆盖）
|
||||
readonly REMOTE_BASE_URL="${REMOTE_LIB_URL:-https://gitea.bcde.io/wangdefa/tools/raw/branch/main}"
|
||||
|
||||
# 获取脚本目录（用于本地加载）
|
||||
readonly SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||
readonly PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
|
||||
|
||||
#
|
||||
# 智能加载公共库
|
||||
#
|
||||
# 加载策略：
|
||||
# 1. 如果 FORCE_REMOTE=1，强制使用远程库
|
||||
# 2. 否则尝试使用本地库
|
||||
# 3. 本地库不存在时自动回退到远程库
|
||||
#
|
||||
load_common_libs() {
|
||||
local use_remote=false
|
||||
|
||||
# 检查是否强制远程
|
||||
if [[ "${FORCE_REMOTE:-0}" == "1" ]]; then
|
||||
echo "[INFO] 强制使用远程库 (FORCE_REMOTE=1)" >&2
|
||||
use_remote=true
|
||||
# 检查本地库是否存在
|
||||
elif [[ -f "${PROJECT_ROOT}/common/logging.sh" ]] && [[ -f "${PROJECT_ROOT}/common/error_handler.sh" ]]; then
|
||||
# shellcheck disable=SC1091
|
||||
source "${PROJECT_ROOT}/common/logging.sh"
|
||||
# shellcheck disable=SC1091
|
||||
source "${PROJECT_ROOT}/common/error_handler.sh"
|
||||
return 0
|
||||
else
|
||||
echo "[WARN] 本地库不存在，使用远程库" >&2
|
||||
use_remote=true
|
||||
fi
|
||||
|
||||
# 使用远程库
|
||||
if [[ "$use_remote" == "true" ]]; then
|
||||
if command -v curl &>/dev/null; then
|
||||
echo "[INFO] 使用 curl 下载远程库..." >&2
|
||||
# shellcheck disable=SC1090
|
||||
if source <(curl -fsSL "${REMOTE_BASE_URL}/common/remote_loader.sh" 2>/dev/null); then
|
||||
return 0
|
||||
fi
|
||||
elif command -v wget &>/dev/null; then
|
||||
echo "[INFO] 使用 wget 下载远程库..." >&2
|
||||
# shellcheck disable=SC1090
|
||||
if source <(wget -qO- "${REMOTE_BASE_URL}/common/remote_loader.sh" 2>/dev/null); then
|
||||
return 0
|
||||
fi
|
||||
fi
|
||||
|
||||
echo "[ERROR] 无法加载公共库" >&2
|
||||
echo "[ERROR] - 本地库不存在" >&2
|
||||
echo "[ERROR] - 远程下载失败（需要 curl 或 wget）" >&2
|
||||
echo "[ERROR] - 仓库 URL: ${REMOTE_BASE_URL}" >&2
|
||||
exit 1
|
||||
fi
|
||||
}
|
||||
|
||||
# 加载公共库
|
||||
source "${SCRIPT_DIR}/logging.sh"
|
||||
source "${SCRIPT_DIR}/error_handler.sh"
|
||||
load_common_libs
|
||||
|
||||
#
|
||||
# 示例 1: 基本日志使用
|
||||
|
||||
105
common/remote_loader.sh
Executable file
105
common/remote_loader.sh
Executable file
@@ -0,0 +1,105 @@
|
||||
#!/bin/bash
|
||||
# ============================================================================
|
||||
# 文件名: remote_loader.sh
|
||||
# 描述: 远程公共库加载器 - 从 Gitea 仓库下载并加载公共库
|
||||
# 作者: Cloud Tools Project
|
||||
# 版本: 1.0.0
|
||||
# ============================================================================
|
||||
|
||||
# 远程仓库 URL 配置
|
||||
readonly REMOTE_BASE_URL="${REMOTE_LIB_URL:-https://gitea.bcde.io/wangdefa/tools/raw/branch/main}"
|
||||
|
||||
# 临时目录用于存储下载的文件
|
||||
readonly REMOTE_TMP_DIR="$(mktemp -d)"
|
||||
|
||||
# 清理函数 - 在脚本退出时删除临时文件
|
||||
cleanup_remote_libs() {
|
||||
if [[ -d "$REMOTE_TMP_DIR" ]]; then
|
||||
rm -rf "$REMOTE_TMP_DIR"
|
||||
fi
|
||||
}
|
||||
|
||||
# 注册退出时的清理函数
|
||||
trap cleanup_remote_libs EXIT INT TERM
|
||||
|
||||
#
|
||||
# 从远程下载单个文件
|
||||
#
|
||||
# 参数:
|
||||
# $1 - 相对路径（例如：common/logging.sh）
|
||||
#
|
||||
# 返回:
|
||||
# 下载文件的本地路径
|
||||
#
|
||||
download_remote_file() {
|
||||
local relative_path="$1"
|
||||
local remote_url="${REMOTE_BASE_URL}/${relative_path}"
|
||||
local local_file="${REMOTE_TMP_DIR}/$(basename "$relative_path")"
|
||||
|
||||
# 尝试使用 curl 下载
|
||||
if command -v curl &>/dev/null; then
|
||||
if curl -fsSL "$remote_url" -o "$local_file" 2>/dev/null; then
|
||||
echo "$local_file"
|
||||
return 0
|
||||
fi
|
||||
# 尝试使用 wget 下载
|
||||
elif command -v wget &>/dev/null; then
|
||||
if wget -q "$remote_url" -O "$local_file" 2>/dev/null; then
|
||||
echo "$local_file"
|
||||
return 0
|
||||
fi
|
||||
else
|
||||
echo "[ERROR] 未找到 curl 或 wget 命令，无法下载远程库" >&2
|
||||
return 1
|
||||
fi
|
||||
|
||||
echo "[ERROR] 无法下载远程库: $remote_url" >&2
|
||||
return 1
|
||||
}
|
||||
|
||||
#
|
||||
# 加载远程公共库
|
||||
#
|
||||
# 此函数会下载并 source 所有必需的公共库
|
||||
#
|
||||
load_remote_libs() {
|
||||
echo "[INFO] 正在从远程仓库加载公共库..."
|
||||
echo "[INFO] 仓库地址: $REMOTE_BASE_URL"
|
||||
|
||||
# 必需的库文件列表
|
||||
local required_libs=(
|
||||
"common/logging.sh"
|
||||
"common/error_handler.sh"
|
||||
)
|
||||
|
||||
# 下载并加载每个库文件
|
||||
for lib in "${required_libs[@]}"; do
|
||||
echo "[INFO] 下载 $lib ..."
|
||||
|
||||
local local_path
|
||||
if local_path=$(download_remote_file "$lib"); then
|
||||
echo "[SUCCESS] 已下载: $lib"
|
||||
|
||||
# 加载库文件
|
||||
# shellcheck disable=SC1090
|
||||
if source "$local_path"; then
|
||||
echo "[SUCCESS] 已加载: $lib"
|
||||
else
|
||||
echo "[ERROR] 无法加载远程库: $lib" >&2
|
||||
echo "[ERROR] 脚本执行中止" >&2
|
||||
exit 1
|
||||
fi
|
||||
else
|
||||
echo "[ERROR] 无法下载远程库: $lib" >&2
|
||||
echo "[ERROR] 脚本执行中止" >&2
|
||||
echo "[ERROR] 请检查网络连接或仓库 URL: $REMOTE_BASE_URL" >&2
|
||||
exit 1
|
||||
fi
|
||||
done
|
||||
|
||||
echo "[SUCCESS] 所有远程库加载完成"
|
||||
echo ""
|
||||
}
|
||||
|
||||
# 执行加载
|
||||
load_remote_libs
|
||||
Reference in New Issue
Block a user