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
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
|
# Copyright (c) 2017 Cable Television Laboratories, Inc. ("CableLabs")
# and others. All rights reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at:
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
import logging
import yaml
from heatclient.client import Client
from heatclient.common.template_format import yaml_loader
from novaclient.exceptions import NotFound
from oslo_serialization import jsonutils
from snaps import file_utils
from snaps.domain.stack import Stack, Resource, Output
from snaps.openstack.utils import keystone_utils, neutron_utils, nova_utils
__author__ = 'spisarski'
logger = logging.getLogger('heat_utils')
def heat_client(os_creds):
"""
Retrieves the Heat client
:param os_creds: the OpenStack credentials
:return: the client
"""
logger.debug('Retrieving Nova Client')
return Client(os_creds.heat_api_version,
session=keystone_utils.keystone_session(os_creds),
region_name=os_creds.region_name)
def get_stack(heat_cli, stack_settings=None, stack_name=None):
"""
Returns the first domain Stack object found. When stack_setting
is not None, the filter created will take the name attribute. When
stack_settings is None and stack_name is not, stack_name will be used
instead. When both are None, the first stack object received will be
returned, else None
:param heat_cli: the OpenStack heat client
:param stack_settings: a StackSettings object
:param stack_name: the name of the heat stack to return
:return: the Stack domain object else None
"""
stack_filter = dict()
if stack_settings:
stack_filter['stack_name'] = stack_settings.name
elif stack_name:
stack_filter['stack_name'] = stack_name
stacks = heat_cli.stacks.list(**stack_filter)
for stack in stacks:
return Stack(name=stack.identifier, stack_id=stack.id)
def get_stack_by_id(heat_cli, stack_id):
"""
Returns a domain Stack object for a given ID
:param heat_cli: the OpenStack heat client
:param stack_id: the ID of the heat stack to retrieve
:return: the Stack domain object else None
"""
stack = heat_cli.stacks.get(stack_id)
return Stack(name=stack.identifier, stack_id=stack.id)
def get_stack_status(heat_cli, stack_id):
"""
Returns the current status of the Heat stack
:param heat_cli: the OpenStack heat client
:param stack_id: the ID of the heat stack to retrieve
:return:
"""
return heat_cli.stacks.get(stack_id).stack_status
def get_stack_status_reason(heat_cli, stack_id):
"""
Returns the current status of the Heat stack
:param heat_cli: the OpenStack heat client
:param stack_id: the ID of the heat stack to retrieve
:return: reason for stack creation failure
"""
return heat_cli.stacks.get(stack_id).stack_status_reason
def create_stack(heat_cli, stack_settings):
"""
Executes an Ansible playbook to the given host
:param heat_cli: the OpenStack heat client object
:param stack_settings: the stack configuration
:return: the Stack domain object
"""
args = dict()
if stack_settings.template:
args['template'] = stack_settings.template
else:
args['template'] = parse_heat_template_str(
file_utils.read_file(stack_settings.template_path))
args['stack_name'] = stack_settings.name
if stack_settings.env_values:
args['parameters'] = stack_settings.env_values
stack = heat_cli.stacks.create(**args)
return get_stack_by_id(heat_cli, stack_id=stack['stack']['id'])
def delete_stack(heat_cli, stack):
"""
Deletes the Heat stack
:param heat_cli: the OpenStack heat client object
:param stack: the OpenStack Heat stack object
"""
heat_cli.stacks.delete(stack.id)
def __get_os_resources(heat_cli, stack):
"""
Returns all of the OpenStack resource objects for a given stack
:param heat_cli: the OpenStack heat client
:param stack: the SNAPS-OO Stack domain object
:return: a list
"""
return heat_cli.resources.list(stack.id)
def get_resources(heat_cli, stack):
"""
Returns all of the OpenStack resource objects for a given stack
:param heat_cli: the OpenStack heat client
:param stack: the SNAPS-OO Stack domain object
:return: a list
"""
os_resources = __get_os_resources(heat_cli, stack)
if os_resources:
out = list()
for os_resource in os_resources:
out.append(Resource(resource_type=os_resource.resource_type,
resource_id=os_resource.physical_resource_id))
return out
def get_outputs(heat_cli, stack):
"""
Returns all of the SNAPS-OO Output domain objects for the defined outputs
for given stack
:param heat_cli: the OpenStack heat client
:param stack: the SNAPS-OO Stack domain object
:return: a list
"""
out = list()
os_stack = heat_cli.stacks.get(stack.id)
outputs = None
if os_stack:
outputs = os_stack.outputs
if outputs:
for output in outputs:
out.append(Output(**output))
return out
def get_stack_networks(heat_cli, neutron, stack):
"""
Returns an instance of NetworkSettings for each network owned by this stack
:param heat_cli: the OpenStack heat client object
:param neutron: the OpenStack neutron client object
:param stack: the SNAPS-OO Stack domain object
:return: a list of NetworkSettings
"""
out = list()
resources = get_resources(heat_cli, stack)
for resource in resources:
if resource.type == 'OS::Neutron::Net':
network = neutron_utils.get_network_by_id(
neutron, resource.id)
if network:
out.append(network)
return out
def get_stack_servers(heat_cli, nova, stack):
"""
Returns an instance of NetworkSettings for each network owned by this stack
:param heat_cli: the OpenStack heat client object
:param nova: the OpenStack nova client object
:param stack: the SNAPS-OO Stack domain object
:return: a list of NetworkSettings
"""
out = list()
resources = get_resources(heat_cli, stack)
for resource in resources:
if resource.type == 'OS::Nova::Server':
try:
server = nova_utils.get_server_object_by_id(
nova, resource.id)
if server:
out.append(server)
except NotFound:
logger.warn(
'VmInst cannot be located with ID %s', resource.id)
return out
def parse_heat_template_str(tmpl_str):
"""
Takes a heat template string, performs some simple validation and returns a
dict containing the parsed structure. This function supports both JSON and
YAML Heat template formats.
"""
if tmpl_str.startswith('{'):
tpl = jsonutils.loads(tmpl_str)
else:
try:
tpl = yaml.load(tmpl_str, Loader=yaml_loader)
except yaml.YAMLError as yea:
raise ValueError(yea)
else:
if tpl is None:
tpl = {}
# Looking for supported version keys in the loaded template
if not ('HeatTemplateFormatVersion' in tpl or
'heat_template_version' in tpl or
'AWSTemplateFormatVersion' in tpl):
raise ValueError("Template format version not found.")
return tpl
|