community.general.one_service module – Deploy and manage OpenNebula services

Note

This module is part of the community.general collection (version 6.6.9).

It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.one_service.

Synopsis

• Manage OpenNebula services

Parameters

Parameter	Comments
api_password string	Password of the user to login into OpenNebula OneFlow API server. If not set then the value of the ONEFLOW_PASSWORD environment variable is used.
api_url string	URL of the OpenNebula OneFlow API server. It is recommended to use HTTPS so that the username/password are not transferred over the network unencrypted. If not set then the value of the ONEFLOW_URL environment variable is used.
api_username string	Name of the user to login into the OpenNebula OneFlow API server. If not set then the value of the ONEFLOW_USERNAME environment variable is used.
cardinality integer	Number of VMs for the specified role.
custom_attrs dictionary	Dictionary of key/value custom attributes which will be used when instantiating a new service. Default: {}
force boolean	Force the new cardinality even if it is outside the limits. Choices: false ← (default) true
group_id integer	ID of the group which will be set as the group of the service.
mode string	Set permission mode of a service instance in octet format, for example 0600 to give owner use and manage and nothing to group and others.
owner_id integer	ID of the user which will be set as the owner of the service.
role string	Name of the role whose cardinality should be changed.
service_id integer	ID of a service instance that you would like to manage.
service_name string	Name of a service instance that you would like to manage.
state string	present - instantiate a service from a template specified with template_id or template_name. absent - terminate an instance of a service specified with template_id or template_name. Choices: "present" ← (default) "absent"
template_id integer	ID of a service template to use to create a new instance of a service.
template_name string	Name of service template to use to create a new instance of a service.
unique boolean	Setting unique=true will make sure that there is only one service instance running with a name set with service_name when instantiating a service from a template specified with template_id or template_name. Check examples below. Choices: false ← (default) true
wait boolean	Wait for the instance to reach RUNNING state after DEPLOYING or COOLDOWN state after SCALING. Choices: false ← (default) true
wait_timeout integer	How long before wait gives up, in seconds. Default: 300

Attributes

Attribute	Support	Description
check_mode	Support: full	Can run in check_mode and return changed status prediction without modifying target.
diff_mode	Support: none	Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode.

Examples

- name: Instantiate a new service
  community.general.one_service:
    template_id: 90
  register: result

- name: Print service properties
  ansible.builtin.debug:
    msg: result

- name: Instantiate a new service with specified service_name, service group and mode
  community.general.one_service:
    template_name: 'app1_template'
    service_name: 'app1'
    group_id: 1
    mode: '660'

- name: Instantiate a new service with template_id and pass custom_attrs dict
  community.general.one_service:
    template_id: 90
    custom_attrs:
      public_network_id: 21
      private_network_id: 26

- name: Instantiate a new service 'foo' if the service doesn't already exist, otherwise do nothing
  community.general.one_service:
    template_id: 53
    service_name: 'foo'
    unique: true

- name: Delete a service by ID
  community.general.one_service:
    service_id: 153
    state: absent

- name: Get service info
  community.general.one_service:
    service_id: 153
  register: service_info

- name: Change service owner, group and mode
  community.general.one_service:
    service_name: 'app2'
    owner_id: 34
    group_id: 113
    mode: '600'

- name: Instantiate service and wait for it to become RUNNING
  community.general.one_service:
    template_id: 43
    service_name: 'foo1'

- name: Wait service to become RUNNING
  community.general.one_service:
    service_id: 112
    wait: true

- name: Change role cardinality
  community.general.one_service:
    service_id: 153
    role: bar
    cardinality: 5

- name: Change role cardinality and wait for it to be applied
  community.general.one_service:
    service_id: 112
    role: foo
    cardinality: 7
    wait: true

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key	Description
group_id integer	service’s group id Returned: success Sample: 1
group_name string	service’s group name Returned: success Sample: "one-users"
mode integer	service’s mode Returned: success Sample: 660
owner_id integer	service’s owner id Returned: success Sample: 143
owner_name string	service’s owner name Returned: success Sample: "ansible-test"
roles list / elements=string	list of dictionaries of roles, each role is described by name, cardinality, state and nodes ids Returned: success Sample: [{"cardinality": 1, "ids": [123, 456], "name": "foo", "state": "RUNNING"}, {"cardinality": 2, "ids": [452, 567, 746], "name": "bar", "state": "RUNNING"}]
service_id integer	service id Returned: success Sample: 153
service_name string	service name Returned: success Sample: "app1"
state string	state of service instance Returned: success Sample: "RUNNING"

Authors

• Milan Ilic (@ilicmilan)

Collection links

• Issue Tracker
• Repository (Sources)
• Submit a bug report
• Request a feature
• Communication