* README.md: information about proxmox::vm::openvz (#3).

This commit is contained in:
gardouille 2015-01-26 16:45:36 +01:00
parent aeeacbbe3e
commit f2138eca84
2 changed files with 30 additions and 6 deletions

View File

@ -1,13 +1,13 @@
--------------------------------------- ---------------------------------------
##### Changes ##### Changes
* README.md: Add examples, a table of contents. * README.md: Add examples, a table of contents, information about proxmox::vm::openvz (#3).
* Correct indentation, double quote, ... * Correct indentation, double quote, ...
* (#2) Add an array and a file to load additionnal modules. * (#2) Add an array and a file to load additionnal modules.
* Correct module's dependencies. * Correct module's dependencies.
* (#9) Add a puppetlabs-firewall rule. * (#9) Add a puppetlabs-firewall rule.
* (#3) Add a new class and subclass: proxmox::vm::openvz to manage OpenVZ CT. * (#3) Add a new class and subclass: proxmox::vm::openvz to manage OpenVZ CT.
* (#3) Add a new fact to calculate venet's network with /24 instead of /32. * (#3) Add a new fact to calculate venet's network with /24 instead of /32.)
--------------------------------------- ---------------------------------------

View File

@ -20,7 +20,7 @@
## Overview ## Overview
The proxmox module provide a simple way to manage Proxmox hypervisor and (soon) it's virtual machines (KVM/OpenVZ) with Puppet. The proxmox module provide a simple way to manage Proxmox hypervisor and OpenVZ network's configuration with Puppet.
## Module Description ## Module Description
@ -37,6 +37,7 @@ The proxmox module automates installing Proxmox on Debian systems.
* Users and group permissions for WebGUI. * Users and group permissions for WebGUI.
* WebGUI's service (pveproxy) * WebGUI's service (pveproxy)
* Kernel modules loaded at the boot time * Kernel modules loaded at the boot time
* OpenVZ network's configuration
### Beginning with Proxmox ### Beginning with Proxmox
@ -60,7 +61,19 @@ class { 'proxmox::hypervisor':
**Note**: The module will automatically reboot the system on the PVE Kernel. You will need to start again the puppet agent. **Note**: The module will automatically reboot the system on the PVE Kernel. You will need to start again the puppet agent.
### VM ### VM
...
Only OpenVZ is supported right now but the vm's class will check-it by it self:
```
include proxmox::vm
```
#### proxmox::vm::openvz
Automatically call by the `proxmox::vm` class, it will manage network configuration, but only few configurations are possible:
* Only one Virtual Ethernet device (aka veth) and it will work with **DHCP**.
* If a veth is available, it will be the main network's interface (set the default gateway throught eth0).
* If a veth is available, only one Virtual Network device (aka venet) as chance to work (the first one), because all others routes will be flushed.
* If there are only venet: no changes.
## Reference ## Reference
@ -70,6 +83,8 @@ class { 'proxmox::hypervisor':
* `proxmox::hypervisor`: Install the Proxmox hypervisor on the system. * `proxmox::hypervisor`: Install the Proxmox hypervisor on the system.
* `proxmox::vm`: Manage virtual machines and containers.
### Defined types ### Defined types
* `proxmox::hypervisor::group`: Manage groups for Proxmox WebGUI and set permissions. * `proxmox::hypervisor::group`: Manage groups for Proxmox WebGUI and set permissions.
@ -114,12 +129,21 @@ proxmox::hypervisor::user { 'marvin':
* `pveproxy_service_enabled`: If set to 'true', Puppet will ensure the WebGUI's service is running. Can be 'true' or 'false'. Defaults to 'true'. * `pveproxy_service_enabled`: If set to 'true', Puppet will ensure the WebGUI's service is running. Can be 'true' or 'false'. Defaults to 'true'.
* `pve_modules_list`: The list of additionnal modules to load at boot time. * `pve_modules_list`: The list of additionnal modules to load at boot time.
* `pve_modules_file_path`: The configuration file that will contain the modules list. Defaults to '/etc/modules-load.d/proxmox.conf'. * `pve_modules_file_path`: The configuration file that will contain the modules list. Defaults to '/etc/modules-load.d/proxmox.conf'.
* `pve_modules_file_content`: Template file to use to generate the previous configuration file. Defaults to 'proxmox/hypervisor/proxmox_modules.conf.erb'. * `pve_modules_file_content`: Template file used to generate the previous configuration file. Defaults to 'proxmox/hypervisor/proxmox_modules.conf.erb'.
#### proxmox::vm
* `vm_interfaces_path`: The main network configuration's file. Defaults to '/etc/network/interfaces'.
* `vm_interfaces_content`: Template file used to generate the previous configuration file. Defaults to 'proxmox/vm/openvz_interfaces.erb'.
* `vm_interfaces_tail_path`: A second network configuration file that will be concatenated in the main. Defaults to '/etc/network/interfaces.tail'.
* `vm_interfaces_tail_content`: Template file used to generate the previous configuration file. Defaults to 'proxmox/vm/openzv_interfaces.tail.erb'.
* `network_service_name`: Network's service name. Defaults to 'networking'.
* `network_service_manage`: If set to 'true', Puppet will manage the network's service. Can be 'true' or 'false'. Defaults to 'true'.
* `network_service_enabled`: If set to 'true', Puppet will ensure the network's service is running. Can be 'true' or 'false'. Defaults to 'true'.
Limitations Limitations
----------- -----------
This module will work only on Debian 7.x versions. This module will only work on Debian 7.x versions.
Development Development
----------- -----------