52 lines
1.3 KiB
Markdown
52 lines
1.3 KiB
Markdown
# 如何更新 XXXigCC 的 Pool URL
|
||
|
||
## 0. 版本兼容性
|
||
|
||
**重要提示**：
|
||
- 支持 Ansible 2.14 及以上版本
|
||
- 已移除 `warn: false` 参数，确保兼容性
|
||
- 使用 `ansible.builtin.shell` 模块替代传统 `command` 模块
|
||
|
||
## 1. 准备工作
|
||
|
||
在更新 XXXigCC 的 Pool URL 之前，请确保：
|
||
- 已安装 Ansible 2.14 或更高版本
|
||
- 已安装 `jq` 工具
|
||
- 有权限修改 `/etc/xxxigcc/config.json`
|
||
- 有权限重启 `xxxigcc-daemon.service`
|
||
|
||
## 2. 更新步骤
|
||
|
||
1. **准备变量文件**：
|
||
创建一个 `xxxigcc_update_vars.yml` 文件，包含以下关键变量：
|
||
```yaml
|
||
new_pool_url: "https://new-pool.example.com"
|
||
# 可选：验证旧 URL（如需）
|
||
old_pool_url: "https://old-pool.example.com"
|
||
```
|
||
|
||
2. **执行 Playbook**：
|
||
```bash
|
||
ansible-playbook xxxigcc_update_pool_url.yaml -e @xxxigcc_update_vars.yml
|
||
```
|
||
|
||
## 3. 操作说明
|
||
|
||
- Playbook 将自动备份原始配置文件
|
||
- 更新 `pools[0].url` 字段
|
||
- 清理 `/var/log/xxxigcc` 目录下的日志文件
|
||
- 重启 `xxxigcc-daemon.service`
|
||
|
||
## 4. 故障排除
|
||
|
||
- 如果更新失败，检查：
|
||
1. 变量文件格式
|
||
2. URL 地址正确性
|
||
3. 系统权限
|
||
4. Ansible 版本兼容性
|
||
|
||
## 5. 安全注意事项
|
||
|
||
- 仅在可信环境中执行此 Playbook
|
||
- 谨慎使用 `old_pool_url` 参数
|
||
- 确保 Ansible 版本满足最低要求 |