proxmox/README.md

63 lines
1.1 KiB
Markdown
Raw Normal View History

2015-01-06 08:55:34 +01:00
# proxmox
## Overview
The proxmox module (will) provide a simple way to manage Proxmox hypervisor and it's virtual machines (KVM/OpenVZ) with Puppet.
2015-01-06 08:55:34 +01:00
## Module Description
The proxmox module automates installing Proxmox on Debian systems.
2015-01-06 08:55:34 +01:00
## Setup
### What proxmox affects:
2015-01-06 08:55:34 +01:00
* Package/service/configuration files for Proxmox
* A new `sources.list` file for Proxmox
* System repository
* The static table lookup for hostnames `hosts`
2015-01-06 08:55:34 +01:00
### Beginning with proxmox
2015-01-06 08:55:34 +01:00
To begin using proxmox module with default parameters, declare the hypervisor's class with `include proxmox::hypervisor`.
2015-01-06 08:55:34 +01:00
## Usage
2015-01-06 08:55:34 +01:00
### Hypervisor
2015-01-06 08:55:34 +01:00
```
class { 'proxmox::hypervisor':
2015-01-06 08:55:34 +01:00
}
```
2015-01-06 08:55:34 +01:00
**Note**: The module will automatically reboot the system on the PVE Kernel. You will need to start again the puppet agent.
### VM
...
2015-01-06 08:55:34 +01:00
## Reference
### Classes
* `proxmox`: Main class, do nothing right now.
* `proxmox::hypervisor`: Install the Proxmox hypervisor on the system.
Limitations
-----------
2015-01-06 08:55:34 +01:00
This module will work only on Debian 7.x versions.
2015-01-06 08:55:34 +01:00
Development
-----------
2015-01-06 08:55:34 +01:00
Free to send contributions, fork it, ...
2015-01-06 08:55:34 +01:00
License
-------
2015-01-06 08:55:34 +01:00
WTFPL (http://wtfpl.org/)
2015-01-06 08:55:34 +01:00