Files
hyperv-demo/README.md

59 lines
1.8 KiB
Markdown

# Hyper-V Windows Server Automation
Enterprise-grade automation for Windows Server VM lifecycle management on Hyper-V using Ansible Automation Platform, GitOps, and Infrastructure as Code practices.
## Overview
This project demonstrates automated Windows Server VM management including:
- **Provisioning**: Automated VM creation using autounattend.xml
- **Configuration Management**: Day-2 operations and application deployment
- **Patch Management**: Automated Windows updates via git commits
- **CMDB Integration**: ServiceNow CMDB synchronization
- **Event-Driven Automation**: Future EDA integration
## Quick Start
```bash
# Install required collections
ansible-galaxy collection install -r collections/requirements.yml
# Run VM provisioning
ansible-playbook playbooks/provision-vm.yml -e vm_name=DEMO-WEB01
# Patch management
ansible-playbook playbooks/patch-vms.yml --limit windows_servers
# Install IIS demo application
ansible-playbook playbooks/install-iis.yml --limit web_servers
```
## Project Structure
```
.
├── ansible.cfg # Ansible configuration
├── playbooks/ # Playbooks by use case
│ ├── provision-vm.yml
│ ├── patch-vms.yml
│ ├── install-iis.yml
│ └── sync-cmdb.yml
├── roles/ # Custom roles
├── group_vars/ # Group variables
├── host_vars/ # Host-specific variables
└── collections/ # Ansible collections
└── requirements.yml
```
## Prerequisites
- Ansible Automation Platform 2.x
- Hyper-V Server or Windows Server with Hyper-V role
- Windows Server ISO images
- ServiceNow instance (for CMDB integration)
- Active Directory domain (for authentication)
## Documentation
See [CLAUDE.md](CLAUDE.md) for detailed architectural documentation and development guidance.