ansible-playbook/llmdoc/guides/xxxigcc-pool-url-update.md

如何更新 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 文件，包含以下关键变量：

   new_pool_url: "https://new-pool.example.com"
   # 可选：验证旧 URL（如需）
   old_pool_url: "https://old-pool.example.com"
   

2. 执行 Playbook：

   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 版本满足最低要求