# 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
├── inventory/                  # Inventory files
│   ├── production/
│   └── staging/
├── 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.