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:
2025-12-26 15:00:06 +08:00
parent 7def817482
commit b34e1ef872
11 changed files with 999 additions and 32 deletions

View File

@@ -0,0 +1,100 @@
#!/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 "$@"