ansible / ansible.builtin / v2.9.27 / module / one_service Deploy and manage OpenNebula services | "added in version" 2.6 of ansible.builtin" Authors: Milan Ilic (@ilicmilan) preview | supported by communityansible.builtin.one_service (v2.9.27) — module
pip
Install with pip install ansible==2.9.27
Manage OpenNebula services
# Instantiate a new service - one_service: template_id: 90 register: result
# Print service properties - debug: msg: result
# Instantiate a new service with specified service_name, service group and mode - one_service: template_name: 'app1_template' service_name: 'app1' group_id: 1 mode: '660'
# Instantiate a new service with template_id and pass custom_attrs dict - one_service: template_id: 90 custom_attrs: public_network_id: 21 private_network_id: 26
# Instantiate a new service 'foo' if the service doesn't already exist, otherwise do nothing - one_service: template_id: 53 service_name: 'foo' unique: yes
# Delete a service by ID - one_service: service_id: 153 state: absent
# Get service info - one_service: service_id: 153 register: service_info
# Change service owner, group and mode - one_service: service_name: 'app2' owner_id: 34 group_id: 113 mode: '600'
# Instantiate service and wait for it to become RUNNING - one_service: template_id: 43 service_name: 'foo1'
# Wait service to become RUNNING - one_service: service_id: 112 wait: yes
# Change role cardinality - one_service: service_id: 153 role: bar cardinality: 5
# Change role cardinality and wait for it to be applied - one_service: service_id: 112 role: foo cardinality: 7 wait: yes
mode: description: - Set permission mode of a service instance in octet format, e.g. C(600) to give owner C(use) and C(manage) and nothing to group and others. role: description: - Name of the role whose cardinality should be changed wait: default: false description: - Wait for the instance to reach RUNNING state after DEPLOYING or COOLDOWN state after SCALING type: bool force: default: false description: - Force the new cardinality even if it is outside the limits type: bool state: choices: - present - absent default: present description: - C(present) - instantiate a service from a template specified with C(template_id)/C(template_name). - C(absent) - terminate an instance of a service specified with C(service_id)/C(service_name). unique: default: false description: - Setting C(unique=yes) will make sure that there is only one service instance running with a name set with C(service_name) when - instantiating a service from a template specified with C(template_id)/C(template_name). Check examples below. type: bool api_url: description: - 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. group_id: description: - ID of the group which will be set as the group of the service owner_id: description: - ID of the user which will be set as the owner of the service service_id: description: - ID of a service instance that you would like to manage cardinality: description: - Number of VMs for the specified role template_id: description: - ID of a service template to use to create a new instance of a service api_password: description: - Password of the user to login into OpenNebula OneFlow API server. If not set then the value of the C(ONEFLOW_PASSWORD) environment variable is used. api_username: description: - Name of the user to login into the OpenNebula OneFlow API server. If not set then the value of the C(ONEFLOW_USERNAME) environment variable is used. custom_attrs: default: {} description: - Dictionary of key/value custom attributes which will be used when instantiating a new service. service_name: description: - Name of a service instance that you would like to manage wait_timeout: default: 300 description: - How long before wait gives up, in seconds template_name: description: - Name of service template to use to create a new instance of a service
group_id: description: service's group id returned: success sample: 1 type: int group_name: description: service's group name returned: success sample: one-users type: str mode: description: service's mode returned: success sample: 660 type: int owner_id: description: service's owner id returned: success sample: 143 type: int owner_name: description: service's owner name returned: success sample: ansible-test type: str roles: description: list of dictionaries of roles, each role is described by name, cardinality, state and nodes ids returned: success sample: '[{"cardinality": 1,"name": "foo","state": "RUNNING","ids": [ 123, 456 ]}, {"cardinality": 2,"name": "bar","state": "RUNNING", "ids": [ 452, 567, 746 ]}]' type: list service_id: description: service id returned: success sample: 153 type: int service_name: description: service name returned: success sample: app1 type: str state: description: state of service instance returned: success sample: RUNNING type: str