Debian如何利用FetchDebian进行自动化部署 - 问答

Debian 使用 FetchDebian 实现自动化部署

一架构与总体思路

在可联网的“构建机”上用 FetchDebian 批量拉取所需软件包及其依赖，按业务清单生成离线仓库或离线安装包目录。
将离线内容通过 HTTP/NFS/USB 分发到目标机。
在目标机上配置本地 APT 源或直接用 dpkg 安装，实现无人值守、可重复的部署流程。

二构建机准备与配置

安装与基础配置
- 安装工具：sudo apt update && sudo apt install -y fetchdebian
- 配置文件：/etc/fetchdebian.conf（系统级），可选用户级 ~/.fetchdebianrc
- 常用配置项：mirror（镜像源）、distribution（发行版代号）、components（main contrib non-free）、architecture（amd64/arm64 等）、output（输出目录）、threads（并发数）
代理与网络
- 全局代理：在 /etc/environment 设置 http_proxy/https_proxy，然后 source /etc/environment
- APT 代理：在 /etc/apt/apt.conf 添加 Acquire::http::Proxy 与 Acquire::https::Proxy
常用命令范式
- 下载指定软件包及其依赖到本地目录：fetchdebian -p 包名（可多次指定包名）
- 下载源码包：fetchdebian -s 包名
- 指定版本：fetchdebian -v 包名=版本
- 指定输出目录：fetchdebian -o /path/to/dir 包名
- 使用指定镜像：fetchdebian -m http://mirror.example.com/debian/ 包名
- 说明：FetchDebian 主要负责“下载”，不直接改动系统的软件源配置。

三自动化下载与离线仓库构建

离线批量下载脚本（示例）

目标：按清单下载、生成 Packages.gz、提供本地 APT 源
示例清单文件：packages.txt（每行一个包名）

示例脚本：fetch-offline.sh

#!/usr/bin/env bash
set -Eeuo pipefail

OUTDIR="/var/cache/fetchdebian-offline"
APTDIR="$OUTDIR/apt"
PKGLIST="packages.txt"

mkdir -p "$APTDIR/"{pool,dists}
cd "$OUTDIR"

# 1) 下载包与依赖
while IFS= read -r pkg; do
  [[ -z "$pkg" || "$pkg" =~ ^# ]] && continue
  fetchdebian -p "$pkg" -o "$APTDIR/pool"
done < "$PKGLIST"

# 2) 生成 APT 索引（简易实现）
# 依赖关系解析与更完整的 Release/Packages 生成可用 apt-ftparchive 或 reprepro 替代
find "$APTDIR/pool" -name '*.deb' -exec dpkg-deb --show {} \; \
  | awk '{printf "Package: %s\nVersion: %s\nArchitecture: %s\n\n", $1, $2, $3}' \
  > "$APTDIR/dists/stable/main/binary-amd64/Packages"
gzip -9kf "$APTDIR/dists/stable/main/binary-amd64/Packages"

cat > "$APTDIR/dists/stable/Release" <<EOF
Archive: stable
Version: 1.0
Component: main
Architecture: amd64
Date: $(date -uR)
EOF

echo "离线仓库已生成：$APTDIR"

定时增量同步
- 方式一：cron 定时拉取
  - 编辑：sudo crontab -e
  - 示例：每天 02:00 同步一次
```
0 2 * * * /usr/bin/fetchdebian sync
```
- 方式二：在构建脚本中先执行增量同步，再按清单下载新增依赖
日志与排错
- 查看日志：sudo tail -f /var/log/fetchdebian.log
- 常见异常：镜像不可达、权限不足、磁盘空间不足、网络代理未生效。

四目标机离线部署与无人值守安装

离线安装软件包
- 方式 A（推荐）：配置本地 APT 源
  - 在目标机创建源文件：/etc/apt/sources.list.d/offline.list
```
deb [trusted=yes] file:///opt/offline-apt stable main
```
  - 复制构建机生成的 APT 目录到目标机：/opt/offline-apt
  - 更新索引并安装：sudo apt update && sudo apt install -y 包名
- 方式 B：直接 dpkg 安装
  - 将构建机生成的 .deb 目录（如 packages/）复制到目标机
  - 安装：sudo dpkg -i packages/*.deb
  - 若有依赖问题，可在联网环境用 apt-rdepends 预检，或在目标机上联网执行 sudo apt -f install 修复
无人值守安装与镜像部署
- 使用下载的 ISO 进行网络或无网络安装：将 ISO 写入 U 盘或挂载为 HTTP/NFS 源，PXE 引导后使用预置 preseed.cfg 实现全自动安装
- 校验镜像完整性：sha256sum -c file.iso.sha256（若提供校验文件）。

五实用建议与排错要点

选择与本地系统一致的 distribution/codename 与 architecture，components 建议包含 main contrib non-free（按需）。
并发下载建议从 threads=4 起步，结合带宽与 I/O 调整，避免过高导致连接失败或负载过大。
代理环境优先在构建机配置 /etc/environment 与 /etc/apt/apt.conf，确保 FetchDebian 与 APT 均走代理。
定期同步与变更可追溯：保留每次下载清单与生成脚本版本，便于回滚与审计。
日志优先：/var/log/fetchdebian.log 能快速定位镜像、权限、网络等问题。

0 赞

0 踩