ansible
70b57d223f
New role for gathering detailed system information including CPU, GPU,
RAM, disk, network, and hypervisor details with JSON export capabilities.
Role capabilities:
- Comprehensive hardware detection (CPU, GPU, RAM, disk, network)
- Hypervisor detection (KVM, Proxmox, LXD, Docker, Podman, VMware, Hyper-V)
- System information gathering (OS, kernel, uptime, security modules)
- Health checks and validation tasks
- JSON export with timestamped backups
- Human-readable summary generation
- Support for multiple Linux distributions
Features:
- Modular task organization by information type
- Feature toggles for selective gathering
- CLAUDE.md compliant validation tasks including:
* Disk usage monitoring (>80% warnings)
* Memory usage statistics
* Top CPU and memory processes
* System uptime tracking
* Logged users reporting
- OS-specific variable handling
- DMI/SMBIOS hardware information
- SMART disk health status
- Network interface statistics
File structure:
roles/system_info/
├── README.md # Comprehensive documentation
├── defaults/main.yml # Configurable defaults
├── vars/main.yml # Role variables
├── meta/main.yml # Galaxy metadata
├── tasks/
│ ├── main.yml # Main task coordinator
│ ├── install.yml # Package installation
│ ├── gather_system.yml # OS and system info
│ ├── gather_cpu.yml # CPU details
│ ├── gather_gpu.yml # GPU detection
│ ├── gather_memory.yml # RAM information
│ ├── gather_disk.yml # Disk and LVM info
│ ├── gather_network.yml # Network configuration
│ ├── detect_hypervisor.yml # Virtualization detection
│ ├── export_stats.yml # JSON export
│ └── validate.yml # Health checks (CLAUDE.md compliant)
├── templates/
│ └── summary.txt.j2 # Human-readable summary
├── handlers/
│ └── main.yml # Service handlers
└── tests/
└── test.yml # Basic test playbook
Use cases:
- Infrastructure inventory for CMDB integration
- Capacity planning and resource optimization
- Hardware audit and compliance reporting
- Hypervisor and VM tracking
- System health monitoring
- Documentation generation
Output:
- JSON: ./stats/machines/<fqdn>/system_info.json
- Backup: ./stats/machines/<fqdn>/system_info_<timestamp>.json
- Summary: ./stats/machines/<fqdn>/summary.txt
Requirements:
- Ansible >= 2.9
- Root/sudo access for hardware information
- Packages: lshw, dmidecode, pciutils, usbutils, smartmontools, ethtool
Compliance:
- CLAUDE.md health check requirements implemented
- CIS Benchmark support for system auditing
- NIST compliance documentation support
- Security-first design with minimal system impact
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
53 lines
1.5 KiB
YAML
53 lines
1.5 KiB
YAML
---
|
|
# Test playbook for system_info role
|
|
- name: Test system_info role
|
|
hosts: localhost
|
|
become: true
|
|
gather_facts: true
|
|
|
|
vars:
|
|
system_info_stats_base_dir: "/tmp/ansible-test/stats/machines"
|
|
system_info_create_stats_dir: true
|
|
|
|
pre_tasks:
|
|
- name: Display test information
|
|
debug:
|
|
msg:
|
|
- "Testing system_info role"
|
|
- "Target: {{ ansible_fqdn }}"
|
|
- "Stats directory: {{ system_info_stats_base_dir }}"
|
|
|
|
roles:
|
|
- role: ../../system_info
|
|
|
|
post_tasks:
|
|
- name: Verify JSON file was created
|
|
stat:
|
|
path: "{{ system_info_stats_base_dir }}/{{ ansible_fqdn }}/system_info.json"
|
|
register: json_file_check
|
|
delegate_to: localhost
|
|
become: false
|
|
|
|
- name: Verify summary file was created
|
|
stat:
|
|
path: "{{ system_info_stats_base_dir }}/{{ ansible_fqdn }}/summary.txt"
|
|
register: summary_file_check
|
|
delegate_to: localhost
|
|
become: false
|
|
|
|
- name: Display test results
|
|
debug:
|
|
msg:
|
|
- "=== Test Results ==="
|
|
- "JSON file created: {{ json_file_check.stat.exists }}"
|
|
- "Summary file created: {{ summary_file_check.stat.exists }}"
|
|
- "Test {{ 'PASSED' if (json_file_check.stat.exists and summary_file_check.stat.exists) else 'FAILED' }}"
|
|
|
|
- name: Assert test passed
|
|
assert:
|
|
that:
|
|
- json_file_check.stat.exists
|
|
- summary_file_check.stat.exists
|
|
success_msg: "All tests passed successfully"
|
|
fail_msg: "Test failed - files were not created"
|