- 新增 gitea_repo_setup.yaml playbook 用于管理 Gitea APT 仓库 - 支持删除旧源、下载 GPG 密钥、配置新源和自动更新 APT 缓存 - 添加仓库配置架构文档和使用指南 - 采用部分参数化设计,支持自定义仓库 URL 和所有者
38 lines
875 B
Markdown
38 lines
875 B
Markdown
# Gitea 仓库配置架构
|
|
|
|
## 1. 身份定义
|
|
|
|
- **组件**: Gitea APT 仓库配置管理
|
|
- **目的**: 自动化 APT 仓库源配置过程
|
|
|
|
## 2. 核心组件
|
|
|
|
- `playbooks/gitea_repo_setup.yaml`: 主要配置逻辑
|
|
- `ansible.builtin.file`: 目录管理
|
|
- `ansible.builtin.get_url`: 密钥下载
|
|
- `ansible.builtin.template`: 源文件生成
|
|
- `ansible.builtin.apt`: 缓存更新
|
|
|
|
## 3. 执行流程
|
|
|
|
1. **目录准备**
|
|
- 检查并创建 `/etc/apt/keyrings/`
|
|
- 删除旧的仓库源文件
|
|
|
|
2. **密钥管理**
|
|
- 下载 GPG 公钥
|
|
- 确保密钥正确导入
|
|
|
|
3. **源配置**
|
|
- 生成 `wangdefa.list`
|
|
- 配置仓库 URL 和签名信息
|
|
|
|
4. **缓存刷新**
|
|
- 触发 `apt update`
|
|
- 记录更新日志
|
|
|
|
## 4. 设计原则
|
|
|
|
- 幂等性:可安全重复执行
|
|
- 参数化:关键配置可动态调整
|
|
- 模块化:遵循 Ansible 最佳实践 |