Ansible Role: openvzmod

This role contains 2 modules to manage OpenVZ containers:

• openvz: Manage OpenVZ containers
• openvz_exec: Execute commands in the OpenVZ container

These modules is still quite immature. There are many missing features. Please file bugs at the GitHub issue tracker.

Ansible Galaxy: https://galaxy.ansible.com/list#/roles/3900

Module Options

openvz options

If this section doesn't show nicely in Ansible Galaxy Page, please refer to equeivalent in the GitHub page.

parameter	required	default	choices	comments
applyconfig	no			Parameter passed to vzctl set --applyconfig.
avnumproc	no			UBC parameter passed to vzctl set --avnumproc.
capability	no			Parameter passed to vzctl set --capability.
config	no			Parameter passed to vzctl create --config.
cpulimit	no			Parameter passed to vzctl set --cpulimit.
cpumask	no			Parameter passed to vzctl set --cpumask.
cpus	no			Parameter passed to vzctl set --cpus.
cpuunits	no			Parameter passed to vzctl set --cpuunits.
ctid	yes			Container ID or name to manage.
dcachesize	no			UBC parameter passed to vzctl set --dcachesize.
description	no			Parameter passed to vzctl set --description.
dgramrcvbuf	no			UBC parameter passed to vzctl set --dgramrcvbuf.
disabled	no		yes no	Parameter passed to vzctl set --disabled.
diskinodes	no			Parameter passed to vzctl set --diskinodes.
diskspace	no			Parameter passed to vzctl set --diskspace.
features	no			Parameter passed to vzctl set --features.
hostname	no			Parameter passed to vzctl set --hostname.
iolimit	no			Parameter passed to vzctl set --iolimit.
ioprio	no			Parameter passed to vzctl set --ioprio.
iopslimit	no			Parameter passed to vzctl set --iopslimit.
ipadd	no			Parameter passed to vzctl set --ipadd.
ipaddr	no			IP address settings in the idempotent way. Specify addresses in an array or a space delimited string.
ipdel	no			Parameter passed to vzctl set --ipdel.
iptables	no			Parameter passed to vzctl set --iptables.
kmemsize	no			UBC parameter passed to vzctl set --kmemsize.
layout	no			Parameter passed to vzctl create --layout.
lockedpages	no			UBC parameter passed to vzctl set --lockedpages.
mount_opts	no			Parameter passed to vzctl set --mount_opts.
name	no			Parameter passed to vzctl set --name.
nameserver	no			Parameter passed to vzctl set --nameserver.
netif	no			Network interface settings in the idempotent way. Specify interfaces in an array or a space delimited string.
netif_add	no			Parameter passed to vzctl set --netif_add.
netif_del	no			Parameter passed to vzctl set --netif_del.
nodemask	no			Parameter passed to vzctl set --nodemask.
numfile	no			UBC parameter passed to vzctl set --numfile.
numflock	no			UBC parameter passed to vzctl set --numflock.
numiptent	no			UBC parameter passed to vzctl set --numiptent.
numothersock	no			UBC parameter passed to vzctl set --numothersock.
numproc	no			UBC parameter passed to vzctl set --numproc.
numpty	no			UBC parameter passed to vzctl set --numpty.
numsiginfo	no			UBC parameter passed to vzctl set --numsiginfo.
numtcpsock	no			UBC parameter passed to vzctl set --numtcpsock.
onboot	no		yes no	Parameter passed to vzctl set --onboot.
oomguarpages	no			UBC parameter passed to vzctl set --oomguarpages.
ostemplate	no			Parameter passed to vzctl create --ostemplate.
othersockbuf	no			UBC parameter passed to vzctl set --othersockbuf.
physpages	no			UBC parameter passed to vzctl set --physpages.
private	no			Parameter passed to vzctl create --private.
privvmpages	no			UBC parameter passed to vzctl set --privvmpages.
quotatime	no			Parameter passed to vzctl set --quotatime.
quotaugidlimit	no			Parameter passed to vzctl set --quotaugidlimit.
ram	no			Parameter passed to vzctl set --ram.
root	no			Parameter passed to vzctl create --root.
searchdomain	no			Parameter passed to vzctl set --searchdomain.
shmpages	no			UBC parameter passed to vzctl set --shmpages.
state	no		started stopped present absent	Container target state.
swap	no			Parameter passed to vzctl set --swap.
swappages	no			UBC parameter passed to vzctl set --swappages.
tcprcvbuf	no			UBC parameter passed to vzctl set --tcprcvbuf.
tcpsndbuf	no			UBC parameter passed to vzctl set --tcpsndbuf.
userpasswd	no			Parameter passed to vzctl set --userpasswd.
vmguarpages	no			UBC parameter passed to vzctl set --vmguarpages.

openvz_exec options

If this section doesn't show nicely in Ansible Galaxy Page, please refer to equeivalent in the GitHub page.

parameter	required	default	choices	comments
ctid	yes			Container ID or name to execute commands.
exec	yes			Shell commands to execute in the container.

Requirements

None.

Role Variables

None.

Dependencies

None.

Example Playbook

---
- hosts: vzhost
  sudo: yes
  roles:
  - yaegashi.openvzmod
  tasks:
  - openvz:
      ctid: 1000
      state: started
      ostemplate: ubuntu-14.04-x86_64-minimal
      ram: 1G
      swap: 512M
      diskspace: 2G
      hostname: vzguest
      name: vzguest
      ipaddr:
      - 192.168.0.100
      - 192.168.0.101
      nameserver: 192.168.0.1
      userpasswd: ansible:secret
      description: Ubuntu trusty amd64 container

---
- hosts: vzhost
  sudo: yes
  roles:
  - yaegashi.openvzmod
  tasks:
  - openvz_exec:
      ctid: 1000
      exec: |
        adduser --system --group --uid 999 ansible
        adduser ansible sudo
        echo ansible:secret | chpasswd

TODO

Some other ideas for possible OpenVZ container management modules:

• openvz_snapshot: Manipulate ploop snapshots
• openvz_exec: Add support for executing a local script file
• Connection plugin for vzctl exec

License

GPLv3+

Author Information

YAEGASHI Takeshi