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
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
|
===========================
Configuration specification
===========================
Configuration file contains the following parameters:
* cloud_management
* power_managements
* node_discover
* services
* containers
Each parameter specifies a driver or a list of drivers.
Example configuration:
.. code-block:: yaml
cloud_management:
driver: devstack
args:
address: 192.168.1.240
auth:
username: ubuntu
iface: enp0s3
power_managements:
- driver: libvirt
args:
connection_uri: qemu+ssh://ubuntu@10.0.1.50/system
- driver: ipmi
args:
fqdn_to_bmc:
node-1.domain.tld:
address: 120.10.30.65
username: alex
password: super-secret
node_discover:
driver: node_list
args:
- fqdn: node-1.domain.tld
ip: 192.168.1.240
mac: 1e:24:c3:75:dd:2c
services:
glance-api:
driver: screen
args:
grep: glance-api
window_name: g-api
hosts:
- 192.168.1.240
containers:
neutron_api:
driver: docker_container
args:
container_name: neutron_api
cloud_management
----------------
This parameter specifies cloud management driver and its arguments.
``cloud_management`` is responsible for configuring connection to nodes
and contains arguments such as SSH username/password/key/proxy.
.. code-block:: yaml
cloud_management:
driver: devstack # name of the driver
args: # arguments for the driver
address: 192.168.1.240
auth:
username: ubuntu
iface: enp0s3
Drivers can support discovering of cloud nodes. For example,
``saltcloud`` drives allow discovering information about nodes
through master/config node of the cloud.
List of supported drivers for cloud_management: :ref:`Cloud management`
power_managements
-----------------
This parameter specifies list of power management drivers. Such drivers
allow controlling power state of cloud nodes.
.. code-block:: yaml
power_managements:
- driver: libvirt # name of the driver
args: # arguments for the driver
connection_uri: qemu+ssh://ubuntu@10.0.1.50/system
- driver: ipmi # name of the driver
args: # arguments for the driver
fqdn_to_bmc:
node-1.domain.tld:
address: 120.10.30.65
username: alex
password: super-secret
List of supported drivers for power_managements: :ref:`Power management`
node_discover
-------------
This parameter specifies node discover driver. ``node_discover`` is responsible
for fetching list of hosts for the cloud. If ``node_discover`` is specified in
configuration then ``cloud_management`` will only control connection options to
the nodes.
.. code-block:: yaml
node_discover:
driver: node_list
args:
- fqdn: node-1.domain.tld
ip: 192.168.1.240
mac: 1e:24:c3:75:dd:2c
List of supported drivers for node_discover: :ref:`Node discover`
services
--------
This parameter specifies list of services and their types. This parameter
allows updating/adding services which are embedded in ``cloud_management``
driver.
.. code-block:: yaml
services:
glance-api: # name of the service
driver: screen # name of the service driver
args: # arguments for the driver
grep: glance-api
window_name: g-api
hosts: # list of hosts where this service running
- 192.168.1.240
mysql: # name of the service
driver: process # name of the service driver
args: # arguments for the driver
grep: mysqld
port:
- tcp
- 3307
restart_cmd: sudo service mysql restart
start_cmd: sudo service mysql start
terminate_cmd: sudo service mysql stop
Service driver contains optional ``hosts`` parameter which controls discovering
of hosts where the service is running. If ``hosts`` specified, then service
discovering is disabled for this service and hosts specified in ``hosts`` will
be used, otherwise, service will be searched across all nodes.
List of supported drivers for services: :ref:`Service drivers`
containers
----------
This parameter specifies list of containers and their types. This parameter
allows updating/adding containers which are embedded in ``cloud_management``
driver.
.. code-block:: yaml
containers:
neutron_api: # name of the container
driver: docker_container # name of the container driver
args: # arguments for the driver
container_name: neutron_api
hosts: # list of hosts where this container running
- 192.168.1.240
Container driver contains optional ``hosts`` parameter which controls discovering
of hosts where the container is running. If ``hosts`` specified, then container
discovering is disabled for this container and hosts specified in ``hosts`` will
be used, otherwise, container will be searched across all nodes.
List of supported drivers for containers: :ref:`Container drivers`
|
