1
|
|
|
#!/usr/bin/env python |
2
|
|
|
# Licensed to the StackStorm, Inc ('StackStorm') under one or more |
3
|
|
|
# contributor license agreements. See the NOTICE file distributed with |
4
|
|
|
# this work for additional information regarding copyright ownership. |
5
|
|
|
# The ASF licenses this file to You under the Apache License, Version 2.0 |
6
|
|
|
# (the "License"); you may not use this file except in compliance with |
7
|
|
|
# the License. You may obtain a copy of the License at |
8
|
|
|
# |
9
|
|
|
# http://www.apache.org/licenses/LICENSE-2.0 |
10
|
|
|
# |
11
|
|
|
# Unless required by applicable law or agreed to in writing, software |
12
|
|
|
# distributed under the License is distributed on an "AS IS" BASIS, |
13
|
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
14
|
|
|
# See the License for the specific language governing permissions and |
15
|
|
|
# limitations under the License. |
16
|
|
|
|
17
|
|
|
""" |
18
|
|
|
|
19
|
|
|
Tags: Ops tool. |
20
|
|
|
|
21
|
|
|
A utility script that diffs models registered in st2 db versus what's on disk. |
22
|
|
|
|
23
|
|
|
""" |
24
|
|
|
|
25
|
|
|
import difflib |
26
|
|
|
import json |
27
|
|
|
import os |
28
|
|
|
|
29
|
|
|
from oslo_config import cfg |
30
|
|
|
|
31
|
|
|
from st2common import config |
32
|
|
|
from st2common.util.monkey_patch import monkey_patch |
33
|
|
|
from st2common.constants.pack import DEFAULT_PACK_NAME |
34
|
|
|
from st2common.content.loader import ContentPackLoader |
35
|
|
|
from st2common.content.loader import MetaLoader |
36
|
|
|
from st2common.bootstrap.base import ResourceRegistrar |
37
|
|
|
import st2common.content.utils as content_utils |
38
|
|
|
from st2common.models.api.action import ActionAPI |
39
|
|
|
from st2common.models.api.sensor import SensorTypeAPI |
40
|
|
|
from st2common.models.api.rule import RuleAPI |
41
|
|
|
from st2common.models.db import db_setup |
42
|
|
|
from st2common.models.db import db_teardown |
43
|
|
|
from st2common.models.system.common import ResourceReference |
44
|
|
|
from st2common.persistence.rule import Rule |
45
|
|
|
from st2common.persistence.sensor import SensorType |
46
|
|
|
from st2common.persistence.action import Action |
47
|
|
|
|
48
|
|
|
registrar = ResourceRegistrar() |
49
|
|
|
registrar.ALLOWED_EXTENSIONS = ['.yaml', '.yml', '.json'] |
50
|
|
|
|
51
|
|
|
meta_loader = MetaLoader() |
52
|
|
|
|
53
|
|
|
API_MODELS_ARTIFACT_TYPES = { |
54
|
|
|
'actions': ActionAPI, |
55
|
|
|
'sensors': SensorTypeAPI, |
56
|
|
|
'rules': RuleAPI |
57
|
|
|
} |
58
|
|
|
|
59
|
|
|
API_MODELS_PERSISTENT_MODELS = { |
60
|
|
|
Action: ActionAPI, |
61
|
|
|
SensorType: SensorTypeAPI, |
62
|
|
|
Rule: RuleAPI |
63
|
|
|
} |
64
|
|
|
|
65
|
|
|
|
66
|
|
|
def do_register_cli_opts(opts, ignore_errors=False): |
67
|
|
|
for opt in opts: |
68
|
|
|
try: |
69
|
|
|
cfg.CONF.register_cli_opt(opt) |
70
|
|
|
except: |
71
|
|
|
if not ignore_errors: |
72
|
|
|
raise |
73
|
|
|
|
74
|
|
|
|
75
|
|
|
def _get_api_models_from_db(persistence_model, pack_dir=None): |
76
|
|
|
filters = {} |
77
|
|
|
if pack_dir: |
78
|
|
|
pack_name = os.path.basename(os.path.normpath(pack_dir)) |
79
|
|
|
filters = {'pack': pack_name} |
80
|
|
|
models = persistence_model.query(**filters) |
81
|
|
|
models_dict = {} |
82
|
|
|
for model in models: |
83
|
|
|
model_pack = getattr(model, 'pack', None) or DEFAULT_PACK_NAME |
84
|
|
|
model_ref = ResourceReference.to_string_reference(name=model.name, pack=model_pack) |
85
|
|
|
if getattr(model, 'id', None): |
86
|
|
|
del model.id |
87
|
|
|
API_MODEL = API_MODELS_PERSISTENT_MODELS[persistence_model] |
88
|
|
|
models_dict[model_ref] = API_MODEL.from_model(model) |
89
|
|
|
return models_dict |
90
|
|
|
|
91
|
|
|
|
92
|
|
|
def _get_api_models_from_disk(artifact_type, pack_dir=None): |
93
|
|
|
loader = ContentPackLoader() |
94
|
|
|
artifacts = None |
95
|
|
|
|
96
|
|
|
if pack_dir: |
97
|
|
|
artifacts_dir = loader.get_content_from_pack(pack_dir, artifact_type) |
98
|
|
|
pack_name = os.path.basename(os.path.normpath(pack_dir)) |
99
|
|
|
artifacts = {pack_name: artifacts_dir} |
100
|
|
|
else: |
101
|
|
|
packs_dirs = content_utils.get_packs_base_paths() |
102
|
|
|
artifacts = loader.get_content(packs_dirs, artifact_type) |
103
|
|
|
|
104
|
|
|
artifacts_dict = {} |
105
|
|
|
for pack_name, pack_path in artifacts.items(): |
106
|
|
|
artifacts_paths = registrar.get_resources_from_pack(pack_path) |
107
|
|
|
for artifact_path in artifacts_paths: |
108
|
|
|
artifact = meta_loader.load(artifact_path) |
109
|
|
|
if artifact_type == 'sensors': |
110
|
|
|
sensors_dir = os.path.dirname(artifact_path) |
111
|
|
|
sensor_file_path = os.path.join(sensors_dir, artifact['entry_point']) |
112
|
|
|
artifact['artifact_uri'] = 'file://' + sensor_file_path |
113
|
|
|
name = artifact.get('name', None) or artifact.get('class_name', None) |
114
|
|
|
if not artifact.get('pack', None): |
115
|
|
|
artifact['pack'] = pack_name |
116
|
|
|
ref = ResourceReference.to_string_reference(name=name, |
117
|
|
|
pack=pack_name) |
118
|
|
|
API_MODEL = API_MODELS_ARTIFACT_TYPES[artifact_type] |
119
|
|
|
# Following conversions are required because we add some fields with |
120
|
|
|
# default values in db model. If we don't do these conversions, |
121
|
|
|
# we'll see a unnecessary diff for those fields. |
122
|
|
|
artifact_api = API_MODEL(**artifact) |
123
|
|
|
artifact_db = API_MODEL.to_model(artifact_api) |
124
|
|
|
artifact_api = API_MODEL.from_model(artifact_db) |
125
|
|
|
artifacts_dict[ref] = artifact_api |
126
|
|
|
|
127
|
|
|
return artifacts_dict |
128
|
|
|
|
129
|
|
|
|
130
|
|
|
def _content_diff(artifact_type=None, artifact_in_disk=None, artifact_in_db=None, |
131
|
|
|
verbose=False): |
132
|
|
|
artifact_in_disk_str = json.dumps( |
133
|
|
|
artifact_in_disk.__json__(), sort_keys=True, |
134
|
|
|
indent=4, separators=(',', ': ') |
135
|
|
|
) |
136
|
|
|
artifact_in_db_str = json.dumps( |
137
|
|
|
artifact_in_db.__json__(), sort_keys=True, |
138
|
|
|
indent=4, separators=(',', ': ') |
139
|
|
|
) |
140
|
|
|
diffs = difflib.context_diff(artifact_in_db_str.splitlines(), |
141
|
|
|
artifact_in_disk_str.splitlines(), |
142
|
|
|
fromfile='DB contents', tofile='Disk contents') |
143
|
|
|
printed = False |
144
|
|
|
for diff in diffs: |
145
|
|
|
if not printed: |
146
|
|
|
identifier = getattr(artifact_in_db, 'ref', getattr(artifact_in_db, 'name')) |
147
|
|
|
print('%s %s in db differs from what is in disk.' % (artifact_type.upper(), |
148
|
|
|
identifier)) |
149
|
|
|
printed = True |
150
|
|
|
print(diff) |
151
|
|
|
|
152
|
|
|
if verbose: |
153
|
|
|
print('\n\nOriginal contents:') |
154
|
|
|
print('===================\n') |
155
|
|
|
print('Artifact in db:\n\n%s\n\n' % artifact_in_db_str) |
156
|
|
|
print('Artifact in disk:\n\n%s\n\n' % artifact_in_disk_str) |
157
|
|
|
|
158
|
|
|
|
159
|
|
|
def _diff(persistence_model, artifact_type, pack_dir=None, verbose=True, |
160
|
|
|
content_diff=True): |
161
|
|
|
artifacts_in_db_dict = _get_api_models_from_db(persistence_model, pack_dir=pack_dir) |
162
|
|
|
artifacts_in_disk_dict = _get_api_models_from_disk(artifact_type, pack_dir=pack_dir) |
163
|
|
|
|
164
|
|
|
# print(artifacts_in_disk_dict) |
165
|
|
|
all_artifacts = set(artifacts_in_db_dict.keys() + artifacts_in_disk_dict.keys()) |
166
|
|
|
|
167
|
|
|
for artifact in all_artifacts: |
168
|
|
|
artifact_in_db = artifacts_in_db_dict.get(artifact, None) |
169
|
|
|
artifact_in_disk = artifacts_in_disk_dict.get(artifact, None) |
170
|
|
|
artifact_in_disk_pretty_json = None |
171
|
|
|
artifact_in_db_pretty_json = None |
172
|
|
|
|
173
|
|
|
if verbose: |
174
|
|
|
print('******************************************************************************') |
175
|
|
|
print('Checking if artifact %s is present in both disk and db.' % artifact) |
176
|
|
|
if not artifact_in_db: |
177
|
|
|
print('##############################################################################') |
178
|
|
|
print('%s %s in disk not available in db.' % (artifact_type.upper(), artifact)) |
179
|
|
|
artifact_in_disk_pretty_json = json.dumps( |
180
|
|
|
artifact_in_disk.__json__(), sort_keys=True, |
181
|
|
|
indent=4, separators=(',', ': ') |
182
|
|
|
) |
183
|
|
|
if verbose: |
184
|
|
|
print('File contents: \n') |
185
|
|
|
print(artifact_in_disk_pretty_json) |
186
|
|
|
continue |
187
|
|
|
|
188
|
|
|
if not artifact_in_disk: |
189
|
|
|
print('##############################################################################') |
190
|
|
|
print('%s %s in db not available in disk.' % (artifact_type.upper(), artifact)) |
191
|
|
|
artifact_in_db_pretty_json = json.dumps( |
192
|
|
|
artifact_in_db.__json__(), sort_keys=True, |
193
|
|
|
indent=4, separators=(',', ': ') |
194
|
|
|
) |
195
|
|
|
if verbose: |
196
|
|
|
print('DB contents: \n') |
197
|
|
|
print(artifact_in_db_pretty_json) |
198
|
|
|
continue |
199
|
|
|
if verbose: |
200
|
|
|
print('Artifact %s exists in both disk and db.' % artifact) |
201
|
|
|
|
202
|
|
|
if content_diff: |
203
|
|
|
if verbose: |
204
|
|
|
print('Performing content diff for artifact %s.' % artifact) |
205
|
|
|
|
206
|
|
|
_content_diff(artifact_type=artifact_type, |
207
|
|
|
artifact_in_disk=artifact_in_disk, |
208
|
|
|
artifact_in_db=artifact_in_db, |
209
|
|
|
verbose=verbose) |
210
|
|
|
|
211
|
|
|
|
212
|
|
|
def _diff_actions(pack_dir=None, verbose=False, content_diff=True): |
213
|
|
|
_diff(Action, 'actions', pack_dir=pack_dir, |
214
|
|
|
verbose=verbose, content_diff=content_diff) |
215
|
|
|
|
216
|
|
|
|
217
|
|
|
def _diff_sensors(pack_dir=None, verbose=False, content_diff=True): |
218
|
|
|
_diff(SensorType, 'sensors', pack_dir=pack_dir, |
219
|
|
|
verbose=verbose, content_diff=content_diff) |
220
|
|
|
|
221
|
|
|
|
222
|
|
|
def _diff_rules(pack_dir=None, verbose=True, content_diff=True): |
223
|
|
|
_diff(Rule, 'rules', pack_dir=pack_dir, |
224
|
|
|
verbose=verbose, content_diff=content_diff) |
225
|
|
|
|
226
|
|
|
|
227
|
|
|
def main(): |
228
|
|
|
monkey_patch() |
229
|
|
|
|
230
|
|
|
cli_opts = [ |
231
|
|
|
cfg.BoolOpt('sensors', default=False, |
232
|
|
|
help='diff sensor alone.'), |
233
|
|
|
cfg.BoolOpt('actions', default=False, |
234
|
|
|
help='diff actions alone.'), |
235
|
|
|
cfg.BoolOpt('rules', default=False, |
236
|
|
|
help='diff rules alone.'), |
237
|
|
|
cfg.BoolOpt('all', default=False, |
238
|
|
|
help='diff sensors, actions and rules.'), |
239
|
|
|
cfg.BoolOpt('verbose', default=False), |
240
|
|
|
cfg.BoolOpt('simple', default=False, |
241
|
|
|
help='In simple mode, tool only tells you if content is missing.' + |
242
|
|
|
'It doesn\'t show you content diff between disk and db.'), |
243
|
|
|
cfg.StrOpt('pack-dir', default=None, help='Path to specific pack to diff.') |
244
|
|
|
] |
245
|
|
|
do_register_cli_opts(cli_opts) |
246
|
|
|
config.parse_args() |
247
|
|
|
|
248
|
|
|
username = cfg.CONF.database.username if hasattr(cfg.CONF.database, 'username') else None |
249
|
|
|
password = cfg.CONF.database.password if hasattr(cfg.CONF.database, 'password') else None |
250
|
|
|
|
251
|
|
|
# Connect to db. |
252
|
|
|
db_setup(cfg.CONF.database.db_name, cfg.CONF.database.host, cfg.CONF.database.port, |
253
|
|
|
username=username, password=password) |
254
|
|
|
|
255
|
|
|
# Diff content |
256
|
|
|
pack_dir = cfg.CONF.pack_dir or None |
257
|
|
|
content_diff = not cfg.CONF.simple |
258
|
|
|
|
259
|
|
|
if cfg.CONF.all: |
260
|
|
|
_diff_sensors(pack_dir=pack_dir, verbose=cfg.CONF.verbose, content_diff=content_diff) |
261
|
|
|
_diff_actions(pack_dir=pack_dir, verbose=cfg.CONF.verbose, content_diff=content_diff) |
262
|
|
|
_diff_rules(pack_dir=pack_dir, verbose=cfg.CONF.verbose, content_diff=content_diff) |
263
|
|
|
return |
264
|
|
|
|
265
|
|
|
if cfg.CONF.sensors: |
266
|
|
|
_diff_sensors(pack_dir=pack_dir, verbose=cfg.CONF.verbose, content_diff=content_diff) |
267
|
|
|
|
268
|
|
|
if cfg.CONF.actions: |
269
|
|
|
_diff_actions(pack_dir=pack_dir, verbose=cfg.CONF.verbose, content_diff=content_diff) |
270
|
|
|
|
271
|
|
|
if cfg.CONF.rules: |
272
|
|
|
_diff_rules(pack_dir=pack_dir, verbose=cfg.CONF.verbose, content_diff=content_diff) |
273
|
|
|
|
274
|
|
|
# Disconnect from db. |
275
|
|
|
db_teardown() |
276
|
|
|
|
277
|
|
|
if __name__ == '__main__': |
278
|
|
|
main() |
279
|
|
|
|