Wang Defa
b34e1ef872
## 功能概述 实现了智能远程库加载机制，允许脚本从远程 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 自动删除
101 lines
3.0 KiB
Bash
Executable File
101 lines
3.0 KiB
Bash
Executable File
#!/bin/bash
|
||
# ============================================================================
|
||
# 文件名: hybrid_loader_template.sh
|
||
# 描述: 混合模式加载器模板 - 自动选择本地或远程库
|
||
# 作者: Cloud Tools Project
|
||
# 版本: 1.0.0
|
||
# ============================================================================
|
||
|
||
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)"
|
||
use_remote=true
|
||
# 检查本地库是否存在
|
||
elif [[ -f "${PROJECT_ROOT}/common/logging.sh" ]] && [[ -f "${PROJECT_ROOT}/common/error_handler.sh" ]]; then
|
||
echo "[INFO] 使用本地公共库"
|
||
# shellcheck disable=SC1091
|
||
source "${PROJECT_ROOT}/common/logging.sh"
|
||
# shellcheck disable=SC1091
|
||
source "${PROJECT_ROOT}/common/error_handler.sh"
|
||
return 0
|
||
else
|
||
echo "[WARN] 本地库不存在，使用远程库"
|
||
use_remote=true
|
||
fi
|
||
|
||
# 使用远程库
|
||
if [[ "$use_remote" == "true" ]]; then
|
||
if command -v curl &>/dev/null; then
|
||
echo "[INFO] 使用 curl 下载远程库..."
|
||
# 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 下载远程库..."
|
||
# 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] 请检查网络连接或安装 curl/wget" >&2
|
||
exit 1
|
||
fi
|
||
}
|
||
|
||
# 加载公共库
|
||
load_common_libs
|
||
|
||
#
|
||
# 主函数
|
||
#
|
||
main() {
|
||
log_info "============ 混合加载器示例 ============"
|
||
log_info "使用混合模式的公共库"
|
||
|
||
# 显示加载信息
|
||
if [[ "${FORCE_REMOTE:-0}" == "1" ]]; then
|
||
log_warning "当前使用远程库（强制模式）"
|
||
elif [[ -f "${PROJECT_ROOT}/common/logging.sh" ]]; then
|
||
log_success "当前使用本地库"
|
||
else
|
||
log_warning "当前使用远程库（自动回退）"
|
||
fi
|
||
|
||
# 测试功能
|
||
log_info "测试日志功能..."
|
||
log_success "日志功能正常"
|
||
|
||
log_info "测试错误处理..."
|
||
if check_command "bash"; then
|
||
log_success "命令检查功能正常"
|
||
fi
|
||
|
||
log_success "所有测试通过！"
|
||
}
|
||
|
||
# 执行主函数
|
||
main "$@"
|