ovirt-ansible-vm-infra/README.en.md

# oVirt Virtual Machine Infrastructure

#### Description
The ovirt.vm-infra role manages the virtual machine infrastructure in oVirt. This role also creates inventory of created virtual machines it defines if wait_for_ip is set to true and state of virtual machine is running. All defined virtual machines are part of ovirt_vm inventory group. Role also creates ovirt_tag_{tag_name} groups if there are any tags assigned to a virtual machine and places all virtual machines with that tag to that inventory group.

Consider the following variable structure:

```yaml
vms:
  - name: myvm1
    tag: mytag1
    profile: myprofile

  - name: myvm2
    tag: mytag2
    profile: myprofile
```

The role will create inventory group ovirt_vm with both of the virtual machines - myvm1 and myvm2. The role also creates inventory group ovirt_tag_mytag1 with virtual machine myvm1 and inventory group ovirt_tag_mytag2 with virtual machine myvm2.

#### Requirements

* Ansible version 2.9 or higher
* Python SDK version 4.3 or higher
* python3-jmespath or python2-jmespath

#### Contribution

1.  Fork the repository
2.  Create Feat_xxx branch
3.  Commit your code
4.  Create Pull Request
Package Initialization 2020-03-05 10:43:52 +08:00			`# oVirt Virtual Machine Infrastructure`
Initial commit 2020-02-26 21:32:40 +08:00
			`#### Description`
Package Initialization 2020-03-05 10:43:52 +08:00			`The ovirt.vm-infra role manages the virtual machine infrastructure in oVirt. This role also creates inventory of created virtual machines it defines if wait_for_ip is set to true and state of virtual machine is running. All defined virtual machines are part of ovirt_vm inventory group. Role also creates ovirt_tag_{tag_name} groups if there are any tags assigned to a virtual machine and places all virtual machines with that tag to that inventory group.`
Initial commit 2020-02-26 21:32:40 +08:00
Package Initialization 2020-03-05 10:43:52 +08:00			`Consider the following variable structure:`
Initial commit 2020-02-26 21:32:40 +08:00
Package Initialization 2020-03-05 10:43:52 +08:00			```yaml
			`vms:`
			`- name: myvm1`
			`tag: mytag1`
			`profile: myprofile`
Initial commit 2020-02-26 21:32:40 +08:00
Package Initialization 2020-03-05 10:43:52 +08:00			`- name: myvm2`
			`tag: mytag2`
			`profile: myprofile`
			```
Initial commit 2020-02-26 21:32:40 +08:00
Package Initialization 2020-03-05 10:43:52 +08:00			`The role will create inventory group ovirt_vm with both of the virtual machines - myvm1 and myvm2. The role also creates inventory group ovirt_tag_mytag1 with virtual machine myvm1 and inventory group ovirt_tag_mytag2 with virtual machine myvm2.`
Initial commit 2020-02-26 21:32:40 +08:00
Package Initialization 2020-03-05 10:43:52 +08:00			`#### Requirements`

			`* Ansible version 2.9 or higher`
			`* Python SDK version 4.3 or higher`
			`* python3-jmespath or python2-jmespath`
Initial commit 2020-02-26 21:32:40 +08:00
			`#### Contribution`

			`1. Fork the repository`
			`2. Create Feat_xxx branch`
			`3. Commit your code`
			`4. Create Pull Request`