blob: 1f10de4a2cad6160a4ef09cf11585028684a25ca (
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
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
|
OpenShift Metrics with Hawkular
====================
OpenShift Metrics Installation
Requirements
------------
This role has the following dependencies:
- Java is required on the control node to generate keystores for the Java components
- httpd-tools is required on the control node to generate various passwords for the metrics components
The following variables need to be set and will be validated:
- `openshift_metrics_hawkular_hostname`: hostname used on the hawkular metrics route.
- `openshift_metrics_project`: project (i.e. namespace) where the components will be
deployed.
Role Variables
--------------
For default values, see [`defaults/main.yaml`](defaults/main.yaml).
- `openshift_metrics_image_prefix`: Specify prefix for metrics components; e.g for
"openshift/origin-metrics-deployer:v1.1", set prefix "openshift/origin-".
- `openshift_metrics_image_version`: Specify version for metrics components; e.g. for
"openshift/origin-metrics-deployer:v1.1", set version "v1.1".
- `openshift_metrics_hawkular_cert:` The certificate used for re-encrypting the route
to Hawkular metrics. The certificate must contain the hostname used by the route.
The default router certificate will be used if unspecified
- `openshift_metrics_hawkular_key:` The key used with the Hawkular certificate
- `openshift_metrics_hawkular_ca:` An optional certificate used to sign the Hawkular certificate.
- `openshift_metrics_hawkular_replicas:` The number of replicas for Hawkular metrics.
- `openshift_metrics_cassandra_replicas`: The number of Cassandra nodes to deploy for the
initial cluster.
- `openshift_metrics_cassandra_storage_type`: Use `emptydir` for ephemeral storage (for
testing), `pv` to use persistent volumes (which need to be created before the
installation) or `dynamic` for dynamic persistent volumes.
- `openshift_metrics_cassandra_pvc_prefix`: The name of persistent volume claims created
for cassandra will be this with a serial number appended to the end, starting
from 1.
- `openshift_metrics_cassandra_pvc_size`: The persistent volume claim size for each of the
Cassandra nodes.
- `openshift_metrics_heapster_standalone`: Deploy only heapster, without the Hawkular Metrics and
Cassandra components.
- `openshift_metrics_heapster_allowed_users`: A comma-separated list of CN to accept. By
default, this is set to allow the OpenShift service proxy to connect. If you
override this, make sure to add `system:master-proxy` to the list in order to
allow horizontal pod autoscaling to function properly.
- `openshift_metrics_startup_timeout`: How long in seconds we should wait until
Hawkular Metrics and Heapster starts up before attempting a restart.
- `openshift_metrics_duration`: How many days metrics should be stored for.
- `openshift_metrics_resolution`: How often metrics should be gathered.
- `openshift_metrics_install_hawkular_agent`: Install the Hawkular OpenShift Agent (HOSA). HOSA can be used
to collect custom metrics from your pods. This component is currently in tech-preview and is not installed by default.
## Additional variables to control resource limits
Each metrics component (hawkular, cassandra, heapster) can specify a cpu and memory limits and requests by setting
the corresponding role variable:
```
openshift_metrics_<COMPONENT>_(limits|requests)_(memory|cpu): <VALUE>
```
e.g
```
openshift_metrics_cassandra_limits_memory: 1Gi
openshift_metrics_hawkular_requests_cpu: 100
```
Dependencies
------------
openshift_facts
Example Playbook
----------------
```
- name: Configure openshift-metrics
hosts: oo_first_master
roles:
- role: openshift_metrics
```
License
-------
Apache License, Version 2.0
Author Information
------------------
Jose David Martín (j.david.nieto@gmail.com)
|
