feat: 代码标准化和文件重命名

## 新增功能
- 创建统一的公共函数库 (common/logging.sh, common/error_handler.sh)
- 添加功能演示脚本 (common/demo_usage.sh)
- 完善的使用文档 (common/README.md)

## 代码重构
- 重构所有脚本使用统一的公共库
- 为所有函数添加完整的文档注释
- 统一代码格式(4空格缩进、严格模式)
- 标准化错误处理和日志输出

## 文件重命名
- gcp/create_ai_project.sh → gcp/create_ai_projects.sh (单复数统一)
- gcp/delete_all_project.sh → gcp/delete_all_projects.sh (单复数统一)
- linux/install_ohmyzsh.sh → linux/install_oh_my_zsh.sh (专有名词规范)
- linux/create_raid0_with_ext4.sh → linux/create_raid0_array.sh (简化命名)
- common/example.sh → common/demo_usage.sh (更具描述性)

## 技术改进
- 使用 readonly 声明常量
- 启用 set -euo pipefail 严格模式
- 统一的 ANSI 颜色日志输出
- 完善的命令重试机制
- 栈追踪支持
This commit is contained in:
2025-12-26 14:47:18 +08:00
commit 7def817482
11 changed files with 2312 additions and 0 deletions

142
linux/create_raid0_array.sh Normal file
View File

@@ -0,0 +1,142 @@
#!/bin/bash
# ============================================================================
# 文件名: create_raid0_array.sh
# 描述: 创建并配置 RAID 0 存储阵列
# 作者: Cloud Tools Project
# 版本: 2.0.0
# 警告: 此操作将删除目标磁盘上的所有数据
# ============================================================================
set -euo pipefail
# 获取脚本目录
readonly SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
readonly PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
# 加载公共库
source "${PROJECT_ROOT}/common/logging.sh"
source "${PROJECT_ROOT}/common/error_handler.sh"
# 配置
readonly MOUNT_POINT="/mnt/raid0"
# 检查 root 权限
check_root
#
# 检查并安装依赖工具
#
# 参数:
# $1 - 工具名称
#
check_and_install() {
local tool=$1
if ! command -v "$tool" &> /dev/null; then
log_warning "$tool 未安装,正在尝试安装..."
if command -v apt-get &> /dev/null; then
run_command "安装 $tool" bash -c "apt-get update && apt-get install -y $tool"
elif command -v yum &> /dev/null; then
run_command "安装 $tool" yum install -y "$tool"
else
log_error "无法安装 $tool,请手动安装后重试"
exit 1
fi
fi
}
#
# 主函数 - 创建 RAID 0 阵列
#
main() {
log_info "============ RAID 0 创建程序 ============"
# 检查依赖
check_and_install mdadm
check_and_install lsblk
log_success "所有依赖已满足"
# 获取系统盘
local system_disk
system_disk=$(mount | grep " / " | cut -d' ' -f1 | sed 's/[0-9]*//g')
log_info "检测到系统盘: ${system_disk}"
# 获取可用磁盘
local disks
disks=$(lsblk -dno NAME | sed -e '/^loop/d' -e '/^sr/d' -e "/^${system_disk##*/}$/d" | sed 's/^/\/dev\//')
if [ -z "$disks" ]; then
log_warning "没有找到除系统盘以外的硬盘"
exit 0
fi
# 检查磁盘数量
local disk_count
disk_count=$(echo "$disks" | wc -l)
if [ "$disk_count" -lt 2 ]; then
log_error "至少需要两个磁盘来创建 RAID 0只找到 $disk_count 个可用磁盘"
exit 1
fi
log_info "找到以下磁盘可用于 RAID 0:"
echo "$disks"
# 确认操作
echo
read -p "是否继续创建 RAID 0? 这将删除这些磁盘上的所有数据 (y/n): " -n 1 -r
echo
if [[ ! $REPLY =~ ^[Yy]$ ]]; then
log_warning "操作已取消"
exit 1
fi
# 删除现有 RAID 配置
mdadm --stop /dev/md0 2>/dev/null || true
mdadm --zero-superblock $disks 2>/dev/null || true
# 创建 RAID 0 阵列
log_info "正在创建 RAID 0 阵列..."
run_command "创建 RAID" mdadm --create /dev/md0 --level=0 --raid-devices="$disk_count" $disks
# 检查状态
if mdadm --detail /dev/md0 | grep -q 'State : clean'; then
log_success "RAID 0 阵列创建成功"
mdadm --detail /dev/md0
else
log_error "RAID 0 阵列创建失败"
exit 1
fi
# 更新配置
log_info "正在更新 mdadm.conf..."
mdadm --detail --scan >> /etc/mdadm/mdadm.conf
# 创建文件系统
log_info "正在创建 ext4 文件系统..."
run_command "创建文件系统" mkfs.ext4 -F /dev/md0
# 创建挂载点
mkdir -p "$MOUNT_POINT"
# 获取 UUID
local raid_uuid
raid_uuid=$(blkid -s UUID -o value /dev/md0)
# 更新 fstab
log_info "正在更新 /etc/fstab..."
echo "UUID=$raid_uuid $MOUNT_POINT ext4 defaults 0 0" >> /etc/fstab
# 挂载
log_info "正在挂载 RAID 阵列..."
if mount -a; then
log_success "RAID 0 阵列已成功创建、格式化并挂载"
log_success "挂载点: $MOUNT_POINT"
else
log_error "挂载 RAID 阵列失败"
exit 1
fi
log_warning "注意: 建议重启系统以确保所有配置生效"
}
# 执行主函数
main "$@"

107
linux/install_oh_my_zsh.sh Normal file
View File

@@ -0,0 +1,107 @@
#!/bin/bash
# ============================================================================
# 文件名: install_oh_my_zsh.sh
# 描述: 安装和配置 Oh My Zsh 及常用插件
# 作者: Cloud Tools Project
# 版本: 2.0.0
# ============================================================================
set -euo pipefail
# 获取脚本目录
readonly SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
readonly PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
# 加载公共库
source "${PROJECT_ROOT}/common/logging.sh"
source "${PROJECT_ROOT}/common/error_handler.sh"
# 配置路径
readonly INSTALL_DIR="${HOME}/.oh-my-zsh"
readonly ZSH_CONFIG="${HOME}/.zshrc"
readonly ZSH_CUSTOM="${INSTALL_DIR}/custom"
#
# 检查并安装缺失的软件包
#
# 参数:
# $@ - 要检查的软件包列表
#
check_and_install_packages() {
local packages=("$@")
local missing_packages=()
for package in "${packages[@]}"; do
if ! check_command "$package"; then
missing_packages+=("$package")
fi
done
if [[ ${#missing_packages[@]} -gt 0 ]]; then
log_warning "缺少以下软件包: ${missing_packages[*]}"
if command -v apt-get &>/dev/null; then
run_command "安装软件包" apt-get update
run_command "安装软件包" apt-get install -y "${missing_packages[@]}"
else
log_error "只支持 apt-get 包管理器"
exit 1
fi
fi
log_success "所有软件包已安装"
}
#
# 安装 Oh My Zsh
#
install_zsh() {
log_info "安装 zsh..."
run_command "更新软件包" sudo apt update
run_command "安装 zsh" sudo apt install zsh -y
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"
}
#
# 主函数
#
main() {
log_info "============ Oh My Zsh 安装程序 ============"
check_and_install_packages "sudo" "git" "curl" "zsh"
if [ ! -d "$INSTALL_DIR" ]; then
install_zsh
else
log_success "oh-my-zsh 已安装"
fi
# 安装插件
if [ ! -d "$ZSH_CUSTOM/plugins/zsh-autosuggestions" ]; then
log_info "安装 zsh-autosuggestions..."
run_command "克隆插件" git clone https://github.com/zsh-users/zsh-autosuggestions "$ZSH_CUSTOM/plugins/zsh-autosuggestions"
fi
if [ ! -d "$ZSH_CUSTOM/plugins/zsh-syntax-highlighting" ]; then
log_info "安装 zsh-syntax-highlighting..."
run_command "克隆插件" git clone https://github.com/zsh-users/zsh-syntax-highlighting.git "$ZSH_CUSTOM/plugins/zsh-syntax-highlighting"
fi
log_success "安装完成"
# 配置 .zshrc
log_info "修改 .zshrc 文件..."
cp "$ZSH_CONFIG" "$ZSH_CONFIG.bak"
sed -i 's/plugins=(git)/plugins=(git zsh-autosuggestions zsh-syntax-highlighting extract)/' "$ZSH_CONFIG"
sed -i 's/ZSH_THEME="robbyrussell"/ZSH_THEME="random"/' "$ZSH_CONFIG"
log_success "配置完成"
# 设置默认 shell
log_info "设置 zsh 为默认 shell..."
chsh -s /bin/zsh
log_success "设置完成"
log_info "重启 zsh..."
zsh
}
# 执行主函数
main "$@"

View File

@@ -0,0 +1,94 @@
#!/bin/bash
# ============================================================================
# 文件名: repartition_disks.sh
# 描述: 删除所有现有分区并创建新的 GPT 分区表(除了系统盘)
# 作者: Cloud Tools Project
# 版本: 2.0.0
# 警告: 此操作将删除目标磁盘上的所有数据
# ============================================================================
set -euo pipefail
# 获取脚本目录
readonly SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
readonly PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
# 加载公共库
source "${PROJECT_ROOT}/common/logging.sh"
source "${PROJECT_ROOT}/common/error_handler.sh"
# 检查 root 权限
check_root
#
# 检查并安装依赖工具
#
# 参数:
# $1 - 工具名称
#
check_and_install() {
local tool=$1
if ! command -v "$tool" &> /dev/null; then
log_warning "$tool 未安装,正在尝试安装..."
if command -v apt-get &> /dev/null; then
run_command "安装 $tool" bash -c "apt-get update && apt-get install -y $tool"
elif command -v yum &> /dev/null; then
run_command "安装 $tool" yum install -y "$tool"
else
log_error "无法安装 $tool,请手动安装后重试"
exit 1
fi
fi
}
#
# 主函数 - 重新分区所有非系统盘
#
main() {
log_info "============ 磁盘重新分区程序 ============"
# 检查依赖
check_and_install lsblk
check_and_install parted
check_and_install wipefs
log_success "所有依赖已满足"
# 获取系统盘
local system_disk
system_disk=$(mount | grep " / " | cut -d' ' -f1 | sed 's/[0-9]*//g')
log_info "检测到系统盘: ${system_disk}"
# 获取可用磁盘
local disks
disks=$(lsblk -dno NAME | sed -e '/^loop/d' -e '/^sr/d' -e "/^${system_disk##*/}$/d")
if [ -z "$disks" ]; then
log_warning "没有找到除系统盘以外的硬盘"
exit 0
fi
# 处理每个磁盘
for disk in $disks; do
log_info "正在处理硬盘: /dev/${disk}"
log_warning "删除 /dev/${disk} 上的所有分区..."
run_command "清除分区签名" wipefs -a "/dev/${disk}"
log_warning "在 /dev/${disk} 上创建新的 GPT 分区表..."
run_command "创建分区表" parted -s "/dev/${disk}" mklabel gpt
log_warning "在 /dev/${disk} 上创建新分区..."
run_command "创建分区" parted -s "/dev/${disk}" mkpart primary 0% 100%
log_info "刷新分区表..."
run_command "刷新分区" partprobe "/dev/${disk}"
log_success "完成处理 /dev/${disk}"
echo
done
log_success "所有操作完成"
}
# 执行主函数
main "$@"