ManageIQ/manageiq-content

manageiq-core.manageiq-vmdb
=========

The `manageiq-core.manageiq-vmdb` role allows for users of ManageIQ to modify and/or change VMDB objects via an Ansible Playbook.
The role includes a module `manageiq_vmdb` which does all the heavy lifting needed to modify or change objects in the database.

Requirements
------------

The example playbook makes use of the `manageiq_vmdb` module which is also included as part of this role.

Role Variables
--------------

Validate Certs:
    `manageiq_validate_certs` defaults to `True`.
    If set to `False` in the `manageiq_connection` dictionary
    then the lookup will allow self signed certificates
    to be used when using SSL REST API connection urls.

ManageIQ:
    `manageiq_connection` is a dictionary with connection default keys.
    Use of this connection information is ONLY needed if the role is used outside of a ManageIQ
    appliance. A ManageIQ appliance passes in `manageiq_connection` via `extra_vars` so connection
    information is included automatically.
    Remember to use Ansible Vault for passwords.

```
    manageiq_connection:
        url: 'https://localhost.ssl:3000'
        username: 'admin'
        password: 'password'
        manageiq_validate_certs: false
```

Dependencies
------------

None

Example Playbook
----------------

An example which provisions a VM to EC2. The playbook
links that vm to a service in the ManageIQ VMDB using the
`manageiq_vmdb` module.
The example shows two ways to pass
the VMDB object to the module, either via an href slug or
via a variable.

```
- name: Service Linking VM's to an existing service
  hosts: localhost
  connection: local
  gather_facts: False

  vars:
  - key: db
  - name: db-test-provision-1
  - instance_type: t2.nano
  - security_group: sg-sdf234
  - image: ami-234234lkj
  - region: us-east-1
  - subnet: subnet-adsf098
  # Only needed if this playbook is NOT run on a ManageIQ Appliance
  - manageiq_connection:
      url: 'https://localhost.ssl:3000'
      username: 'admin'
      password: 'smartvm'
      manageiq_validate_certs: false

  roles:
  - manageiq-core.manageiq-vmdb

  tasks:
  - name: Get a vmdb object
    manageiq_vmdb:
      href: "services/80"
    register: vmdb_object

  - name: Create Ec2 Instance
    ec2:
      key_name: "{{ key }}"
      instance_tags: {Name: "{{ name }}"}
      group_id: "{{ security_group }}"
      instance_type: "{{ instance_type }}"
      region: "{{ region }}"
      image: "{{ image }}"
      wait: yes
      count: 1
      vpc_subnet_id: "{{ subnet }}"
      assign_public_ip: yes
    register: ec2

  - name: Service Linking via an href slug
    manageiq_vmdb:
      href: "href_slug::services/80"
      action: add_provider_vms
      data:
        uid_ems:
          - "{{ ec2.instances[0].id }}"
        provider:
          id: 24

  - name: Service Linking via an object
    manageiq_vmdb:
      vmdb: "{{ vmdb_object }}"
      action: add_provider_vms
      data:
        uid_ems:
          - "asdf234"
        provider:
          id: 24
```

License
-------

Apache