summaryrefslogtreecommitdiffstats
path: root/contrib/inventory/collins.ini
blob: 0ce0c2acbd93da6a91c7a51e50ce4f5e64596b47 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
# Ansible Collins external inventory script settings
#

[collins]

# You should not have a trailing slash or collins
# will not properly match the URI
host = http://localhost:9000

username = blake
password = admin:first

# Specifies a timeout for all HTTP requests to Collins.
timeout_secs = 120

# Specifies a maximum number of retries per Collins request.
max_retries = 5

# Specifies the number of results to return per paginated query as specified in
# the Pagination section of the Collins API docs:
# http://tumblr.github.io/collins/api.html
results_per_query = 100

# Specifies the Collins asset type which will be queried for; most typically
# you'll want to leave this at the default of SERVER_NODE.
asset_type = SERVER_NODE

# Collins assets can optionally be assigned hostnames; this option will preference
# the selection of an asset's hostname over an IP address as the primary identifier
# in the Ansible inventory.  Typically, this value should be set to true if assets
# are assigned hostnames.
prefer_hostnames = true

# Within Collins, assets can be granted multiple IP addresses; this configuration
# value specifies the index within the 'ADDRESSES' array as returned by the
# following API endpoint:
# http://tumblr.github.io/collins/api.html#api-ipam-asset-addresses-section
ip_address_index = 0

# Sets whether Collins instances in multiple datacenters will be queried.
query_remote_dcs = false

# API calls to Collins can involve large, substantial queries. For this reason,
# we cache the results of an API call. Set this to the path you want cache files
# to be written to. Two files will be written to this directory:
#   - ansible-collins.cache
#   - ansible-collins.index
cache_path = /tmp

# If errors occur while querying inventory, logging messages will be written
# to a logfile in the specified directory:
#   - ansible-collins.log
log_path = /tmp

# The number of seconds that a cache file is considered valid. After this many
# seconds, a new API call will be made, and the cache file will be updated.
cache_max_age = 600