添加 xxxigcc 软件包更新功能和完整文档系统

- 新增 xxxigcc_update.yaml playbook 用于软件包更新和服务管理
- 支持 APT 更新、软件包安装、服务启用和启动
- 添加更新流程架构文档、使用指南和参考文档
- 更新项目索引和核心组件概览
- 采用标准 Ansible 模块实现幂等性操作
This commit is contained in:
2025-12-25 11:54:31 +08:00
parent 18c6780028
commit ea3913dddf
6 changed files with 164 additions and 84 deletions

72
xxxigcc_update.yaml Normal file
View File

@@ -0,0 +1,72 @@
---
- name: XXXigCC 更新和服务启动脚本
hosts: all
become: yes
vars:
# 服务配置
package_name: "xxxigcc"
service_name: "xxxigcc-daemon.service"
tasks:
- name: 更新 APT 软件包缓存
ansible.builtin.apt:
update_cache: yes
register: apt_update
changed_when: apt_update.cache_updated
- name: 显示 APT 缓存更新结果
ansible.builtin.debug:
msg: "APT 软件包缓存已更新"
- name: 安装或更新 xxxigcc 软件包
ansible.builtin.apt:
name: "{{ package_name }}"
state: latest
register: package_install
- name: 显示软件包安装结果
ansible.builtin.debug:
msg: "{{ package_name }} 软件包已{{ '更新' if package_install.changed else '确认为最新版本' }}"
- name: 启用 xxxigcc-daemon 服务开机自启
ansible.builtin.systemd:
name: "{{ service_name }}"
enabled: yes
register: service_enabled
- name: 显示服务启用结果
ansible.builtin.debug:
msg: "{{ service_name }} 已设置为开机自启"
- name: 启动 xxxigcc-daemon 服务
ansible.builtin.systemd:
name: "{{ service_name }}"
state: started
register: service_started
- name: 显示服务启动结果
ansible.builtin.debug:
msg: "{{ service_name }} 已启动"
- name: 验证服务运行状态
ansible.builtin.systemd:
name: "{{ service_name }}"
register: service_status
- name: 显示服务状态信息
ansible.builtin.debug:
msg: |
服务状态:
- 服务名称: {{ service_name }}
- 运行状态: {{ service_status.status.ActiveState }}
- 开机自启: {{ 'enabled' if service_enabled.enabled else 'disabled' }}
- name: 显示操作总结
ansible.builtin.debug:
msg: |
操作完成总结:
- APT 缓存: 已更新
- 软件包: {{ package_name }} {{ '(已更新)' if package_install.changed else '(已是最新)' }}
- 服务自启: {{ service_name }} (已启用)
- 服务状态: {{ service_name }} (已启动)