netactuate.compute.node (1.1.1) — module

Manage virtual machines on NetActuate infrastructure.

Authors: Dennis Durling (@tahoe)

preview | supported by community

Install collection

Install with ansible-galaxy collection install netactuate.compute:==1.1.1


Add to requirements.yml

  collections:
    - name: netactuate.compute
      version: 1.1.1

Description

Deploy newly purchaced packages.

Build, destroy, start and stop previously built packages.

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Running
  hosts: all
  remote_user: root
  gather_facts: no
  netactuate.compute.node:
    state: running
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Stopped
  hosts: all
  remote_user: root
  gather_facts: no
  netactuate.compute.node:
    state: stopped

Inputs

    
name:
    description:
    - Custom display name of the instances.
    - Host name will be set to C(name) if not specified.
    - Either C(name) or C(hostname) is required.

state:
    choices:
    - present
    - running
    - stopped
    - terminated
    default: running
    description:
    - Desired state of the instance.

mbpkgid:
    description:
    - The purchased package ID the node is associated with.
    - Required as purchasing new nodes is not yet available here.

hostname:
    description:
    - Hostname of the node. C(name) can only be a valid hostname.
    - Either C(name) is required.

location:
    description:
    - Name or id of physical location the node should be built in.
    - Required.
    - Note, Currently once this is set it cannot be changed from ansible.

auth_token:
    description:
    - API Key which should be set in ENV variable HOSTVIRTUAL_API_KEY
    - C(auth_token) is required.

ssh_public_key:
    description:
    - Path to the ssh key that will be used for node authentication.
    - C(ssh_public_key) is required for host authentication setup.

operating_system:
    description:
    - Either the ID or full name of the OS to be installed on the node.
    - C(operating_system) is required.
    - NOTE, to many choices to list here. Will provide a script for customers to list
      OSes.

Outputs

hostname:
  description: Device FQDN
  returned: success
  sample: a.b.com
  type: string
id:
  description: Device UUID.
  returned: success
  sample: 5551212
  type: string
ip_addresses:
  description: Dictionary of configured IP addresses.
  returned: success
  sample: '[{ "address": "8.8.8.8", "address_family": "4", "public": "true" }]'
  type: dict
private_ipv4:
  description: Private IPv4 Address
  returned: success
  sample: 10.100.11.129
  type: string
public_ipv6:
  description: Public IPv6 Address
  returned: success
  sample: ::1
  type: string
state:
  description: Device state
  returned: success
  sample: running
  type: string