mirror of
https://github.com/ansible-collections/community.general.git
synced 2024-09-14 20:13:21 +02:00
6158b5f56b
* influxdb_retention_policy: ensure duration parameters are idempotent (#2281)
* add changelog for pr #2284
(cherry picked from commit aea12899cc)
Co-authored-by: Xabier Napal <naxabier@gmail.com>
302 lines
11 KiB
Python
302 lines
11 KiB
Python
#!/usr/bin/python
|
|
|
|
# Copyright: (c) 2016, Kamil Szczygiel <kamil.szczygiel () intel.com>
|
|
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
|
|
|
|
from __future__ import absolute_import, division, print_function
|
|
|
|
__metaclass__ = type
|
|
|
|
DOCUMENTATION = r'''
|
|
---
|
|
module: influxdb_retention_policy
|
|
short_description: Manage InfluxDB retention policies
|
|
description:
|
|
- Manage InfluxDB retention policies.
|
|
author: "Kamil Szczygiel (@kamsz)"
|
|
requirements:
|
|
- "python >= 2.6"
|
|
- "influxdb >= 0.9"
|
|
- requests
|
|
options:
|
|
database_name:
|
|
description:
|
|
- Name of the database.
|
|
required: true
|
|
type: str
|
|
policy_name:
|
|
description:
|
|
- Name of the retention policy.
|
|
required: true
|
|
type: str
|
|
duration:
|
|
description:
|
|
- Determines how long InfluxDB should keep the data. If specified, it
|
|
should be C(INF) or at least one hour. If not specified, C(INF) is
|
|
assumed. Supports complex duration expressions with multiple units.
|
|
required: true
|
|
type: str
|
|
replication:
|
|
description:
|
|
- Determines how many independent copies of each point are stored in the cluster.
|
|
required: true
|
|
type: int
|
|
default:
|
|
description:
|
|
- Sets the retention policy as default retention policy.
|
|
type: bool
|
|
default: false
|
|
shard_group_duration:
|
|
description:
|
|
- Determines the time range covered by a shard group. If specified it
|
|
must be at least one hour. If none, it's determined by InfluxDB by
|
|
the rentention policy's duration. Supports complex duration expressions
|
|
with multiple units.
|
|
type: str
|
|
version_added: '2.0.0'
|
|
extends_documentation_fragment:
|
|
- community.general.influxdb
|
|
|
|
'''
|
|
|
|
EXAMPLES = r'''
|
|
# Example influxdb_retention_policy command from Ansible Playbooks
|
|
- name: Create 1 hour retention policy
|
|
community.general.influxdb_retention_policy:
|
|
hostname: "{{influxdb_ip_address}}"
|
|
database_name: "{{influxdb_database_name}}"
|
|
policy_name: test
|
|
duration: 1h
|
|
replication: 1
|
|
ssl: yes
|
|
validate_certs: yes
|
|
|
|
- name: Create 1 day retention policy with 1 hour shard group duration
|
|
community.general.influxdb_retention_policy:
|
|
hostname: "{{influxdb_ip_address}}"
|
|
database_name: "{{influxdb_database_name}}"
|
|
policy_name: test
|
|
duration: 1d
|
|
replication: 1
|
|
shard_group_duration: 1h
|
|
|
|
- name: Create 1 week retention policy with 1 day shard group duration
|
|
community.general.influxdb_retention_policy:
|
|
hostname: "{{influxdb_ip_address}}"
|
|
database_name: "{{influxdb_database_name}}"
|
|
policy_name: test
|
|
duration: 1w
|
|
replication: 1
|
|
shard_group_duration: 1d
|
|
|
|
- name: Create infinite retention policy with 1 week of shard group duration
|
|
community.general.influxdb_retention_policy:
|
|
hostname: "{{influxdb_ip_address}}"
|
|
database_name: "{{influxdb_database_name}}"
|
|
policy_name: test
|
|
duration: INF
|
|
replication: 1
|
|
ssl: no
|
|
validate_certs: no
|
|
shard_group_duration: 1w
|
|
|
|
- name: Create retention policy with complex durations
|
|
community.general.influxdb_retention_policy:
|
|
hostname: "{{influxdb_ip_address}}"
|
|
database_name: "{{influxdb_database_name}}"
|
|
policy_name: test
|
|
duration: 5d1h30m
|
|
replication: 1
|
|
ssl: no
|
|
validate_certs: no
|
|
shard_group_duration: 1d10h30m
|
|
'''
|
|
|
|
RETURN = r'''
|
|
# only defaults
|
|
'''
|
|
|
|
import re
|
|
|
|
try:
|
|
import requests.exceptions
|
|
from influxdb import exceptions
|
|
except ImportError:
|
|
pass
|
|
|
|
from ansible.module_utils.basic import AnsibleModule
|
|
from ansible_collections.community.general.plugins.module_utils.influxdb import InfluxDb
|
|
from ansible.module_utils._text import to_native
|
|
|
|
|
|
VALID_DURATION_REGEX = re.compile(r'^(\d+(ns|u|µ|ms|s|m|h|d|w))+$')
|
|
|
|
DURATION_REGEX = re.compile(r'(\d+)(ns|u|µ|ms|s|m|h|d|w)')
|
|
EXTENDED_DURATION_REGEX = re.compile(r'(?:(\d+)(ns|u|µ|ms|m|h|d|w)|(\d+(?:\.\d+)?)(s))')
|
|
|
|
|
|
def check_duration_literal(value):
|
|
return VALID_DURATION_REGEX.search(value) is not None
|
|
|
|
|
|
def parse_duration_literal(value, extended=False):
|
|
duration = 0.0
|
|
|
|
if value == "INF":
|
|
return duration
|
|
|
|
lookup = (EXTENDED_DURATION_REGEX if extended else DURATION_REGEX).findall(value)
|
|
|
|
for duration_literal in lookup:
|
|
if extended and duration_literal[3] == 's':
|
|
duration_val = float(duration_literal[2])
|
|
duration += duration_val * 1000 * 1000 * 1000
|
|
else:
|
|
duration_val = int(duration_literal[0])
|
|
|
|
if duration_literal[1] == 'ns':
|
|
duration += duration_val
|
|
elif duration_literal[1] == 'u' or duration_literal[1] == 'µ':
|
|
duration += duration_val * 1000
|
|
elif duration_literal[1] == 'ms':
|
|
duration += duration_val * 1000 * 1000
|
|
elif duration_literal[1] == 's':
|
|
duration += duration_val * 1000 * 1000 * 1000
|
|
elif duration_literal[1] == 'm':
|
|
duration += duration_val * 1000 * 1000 * 1000 * 60
|
|
elif duration_literal[1] == 'h':
|
|
duration += duration_val * 1000 * 1000 * 1000 * 60 * 60
|
|
elif duration_literal[1] == 'd':
|
|
duration += duration_val * 1000 * 1000 * 1000 * 60 * 60 * 24
|
|
elif duration_literal[1] == 'w':
|
|
duration += duration_val * 1000 * 1000 * 1000 * 60 * 60 * 24 * 7
|
|
|
|
return duration
|
|
|
|
|
|
def find_retention_policy(module, client):
|
|
database_name = module.params['database_name']
|
|
policy_name = module.params['policy_name']
|
|
hostname = module.params['hostname']
|
|
retention_policy = None
|
|
|
|
try:
|
|
retention_policies = client.get_list_retention_policies(database=database_name)
|
|
for policy in retention_policies:
|
|
if policy['name'] == policy_name:
|
|
retention_policy = policy
|
|
break
|
|
except requests.exceptions.ConnectionError as e:
|
|
module.fail_json(msg="Cannot connect to database %s on %s : %s" % (database_name, hostname, to_native(e)))
|
|
|
|
if retention_policy is not None:
|
|
retention_policy["duration"] = parse_duration_literal(retention_policy["duration"], extended=True)
|
|
retention_policy["shardGroupDuration"] = parse_duration_literal(retention_policy["shardGroupDuration"], extended=True)
|
|
|
|
return retention_policy
|
|
|
|
|
|
def create_retention_policy(module, client):
|
|
database_name = module.params['database_name']
|
|
policy_name = module.params['policy_name']
|
|
duration = module.params['duration']
|
|
replication = module.params['replication']
|
|
default = module.params['default']
|
|
shard_group_duration = module.params['shard_group_duration']
|
|
|
|
if not check_duration_literal(duration):
|
|
module.fail_json(msg="Failed to parse value of duration")
|
|
|
|
influxdb_duration_format = parse_duration_literal(duration)
|
|
if influxdb_duration_format != 0 and influxdb_duration_format < 3600000000000:
|
|
module.fail_json(msg="duration value must be at least 1h")
|
|
|
|
if shard_group_duration is not None:
|
|
if not check_duration_literal(shard_group_duration):
|
|
module.fail_json(msg="Failed to parse value of shard_group_duration")
|
|
|
|
influxdb_shard_group_duration_format = parse_duration_literal(shard_group_duration)
|
|
if influxdb_shard_group_duration_format < 3600000000000:
|
|
module.fail_json(msg="shard_group_duration value must be at least 1h")
|
|
|
|
if not module.check_mode:
|
|
try:
|
|
if shard_group_duration:
|
|
client.create_retention_policy(policy_name, duration, replication, database_name, default,
|
|
shard_group_duration)
|
|
else:
|
|
client.create_retention_policy(policy_name, duration, replication, database_name, default)
|
|
except exceptions.InfluxDBClientError as e:
|
|
module.fail_json(msg=e.content)
|
|
module.exit_json(changed=True)
|
|
|
|
|
|
def alter_retention_policy(module, client, retention_policy):
|
|
database_name = module.params['database_name']
|
|
policy_name = module.params['policy_name']
|
|
duration = module.params['duration']
|
|
replication = module.params['replication']
|
|
default = module.params['default']
|
|
shard_group_duration = module.params['shard_group_duration']
|
|
|
|
changed = False
|
|
|
|
if not check_duration_literal(duration):
|
|
module.fail_json(msg="Failed to parse value of duration")
|
|
|
|
influxdb_duration_format = parse_duration_literal(duration)
|
|
if influxdb_duration_format != 0 and influxdb_duration_format < 3600000000000:
|
|
module.fail_json(msg="duration value must be at least 1h")
|
|
|
|
if shard_group_duration is None:
|
|
influxdb_shard_group_duration_format = retention_policy["shardGroupDuration"]
|
|
else:
|
|
if not check_duration_literal(shard_group_duration):
|
|
module.fail_json(msg="Failed to parse value of shard_group_duration")
|
|
|
|
influxdb_shard_group_duration_format = parse_duration_literal(shard_group_duration)
|
|
if influxdb_shard_group_duration_format < 3600000000000:
|
|
module.fail_json(msg="shard_group_duration value must be at least 1h")
|
|
|
|
if (retention_policy['duration'] != influxdb_duration_format or
|
|
retention_policy['shardGroupDuration'] != influxdb_shard_group_duration_format or
|
|
retention_policy['replicaN'] != int(replication) or
|
|
retention_policy['default'] != default):
|
|
if not module.check_mode:
|
|
try:
|
|
client.alter_retention_policy(policy_name, database_name, duration, replication, default,
|
|
shard_group_duration)
|
|
except exceptions.InfluxDBClientError as e:
|
|
module.fail_json(msg=e.content)
|
|
changed = True
|
|
module.exit_json(changed=changed)
|
|
|
|
|
|
def main():
|
|
argument_spec = InfluxDb.influxdb_argument_spec()
|
|
argument_spec.update(
|
|
database_name=dict(required=True, type='str'),
|
|
policy_name=dict(required=True, type='str'),
|
|
duration=dict(required=True, type='str'),
|
|
replication=dict(required=True, type='int'),
|
|
default=dict(default=False, type='bool'),
|
|
shard_group_duration=dict(required=False, type='str'),
|
|
)
|
|
module = AnsibleModule(
|
|
argument_spec=argument_spec,
|
|
supports_check_mode=True
|
|
)
|
|
|
|
influxdb = InfluxDb(module)
|
|
client = influxdb.connect_to_influxdb()
|
|
|
|
retention_policy = find_retention_policy(module, client)
|
|
|
|
if retention_policy:
|
|
alter_retention_policy(module, client, retention_policy)
|
|
else:
|
|
create_retention_policy(module, client)
|
|
|
|
|
|
if __name__ == '__main__':
|
|
main()
|