building_manager.py 33.2 KB
Newer Older
1
#!/usr/bin/env python3
2
""" Python module to assist creating and maintaining docker openHab stacks."""
3
import crypt
4
import logging
5
import os
dobli's avatar
dobli committed
6
from hashlib import md5
7
from shutil import copy2
8
9
10
11
from subprocess import PIPE, run

import bcrypt
import docker
12
from PyInquirer import prompt
13
14
15
16
17
from ruamel.yaml import YAML

# Configure YAML
yaml = YAML()
yaml.indent(mapping=4, sequence=4, offset=2)
18
19
20

# Log level during development is info
logging.basicConfig(level=logging.WARNING)
21

22
# Directories for config generation
23
24
CUSTOM_DIR = 'custom_configs'
TEMPLATE_DIR = 'template_configs'
25
26
27
COMPOSE_NAME = 'docker-stack.yml'
SKELETON_NAME = 'docker-skeleton.yml'
TEMPLATES_NAME = 'docker-templates.yml'
dobli's avatar
dobli committed
28
29
CONFIG_DIRS = ['mosquitto', 'nodered', 'ssh',
               'traefik', 'volumerize', 'postgres']
Dobli's avatar
Dobli committed
30
31
32
TEMPLATE_FILES = [
    'mosquitto/mosquitto.conf', 'nodered/nodered_package.json',
    'nodered/nodered_settings.js', 'ssh/sshd_config', 'traefik/traefik.toml'
33
]
34
35
EDIT_FILES = {
    "mosquitto_passwords": "mosquitto/mosquitto_passwords",
36
    "sftp_users": "ssh/sftp_users.conf",
37
38
39
    "traefik_users": "traefik/traefik_users",
    "id_rsa": "ssh/id_rsa",
    "host_key": "ssh/ssh_host_ed25519_key",
40
    "known_hosts": "ssh/known_hosts",
dobli's avatar
dobli committed
41
42
43
    "backup_config": "volumerize/backup_config.json",
    "postgres_user": "postgres/user",
    "postgres_passwd": "postgres/passwd"
44
}
Dobli's avatar
Dobli committed
45
CONSTRAINTS = {"building": "node.labels.building"}
46
47
48
49
SERVICES = {
    "sftp": "sftp_X",
    "openhab": "openhab_X",
    "nodered": "nodered_X",
dobli's avatar
dobli committed
50
    "postgres": "postgres_X",
51
    "mqtt": "mqtt_X"
52
}
53

54
# Default Swarm port
dobli's avatar
dobli committed
55
SWARM_PORT = 2377
56
57
# UID for admin
UID = 9001
Dobli's avatar
Dobli committed
58
59
# Username for admin
ADMIN_USER = 'ohadmin'
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

# ******************************
# Compose file functions {{{
# ******************************


def generate_initial_compose(base_dir):
    """Creates the initial compose using the skeleton

    :base_dir: Folder to place configuration files into
    """
    base_path = base_dir + '/' + CUSTOM_DIR
    template_path = base_dir + '/' + TEMPLATE_DIR
    # compose file
    compose = base_path + '/' + COMPOSE_NAME
    # skeleton file
    skeleton = template_path + '/' + SKELETON_NAME

    with open(skeleton, 'r') as skeleton_f, open(compose, 'w+') as compose_f:
        init_content = yaml.load(skeleton_f)
        yaml.dump(init_content, compose_f)


def add_sftp_service(base_dir, hostname, number=0):
    """Generates an sftp entry and adds it to the compose file

    :base_dir: base directory for configuration files
    :hostname: names of host that the services is added to
    :number: increment of exposed port to prevent overlaps
    """
    base_path = base_dir + '/' + CUSTOM_DIR
    # compose file
    compose_path = base_path + '/' + COMPOSE_NAME
    # service name
    service_name = f'sftp_{hostname}'
95
96
97
98
99
100
    # template
    template = get_service_template(base_dir, SERVICES['sftp'])
    # only label contraint is building
    template['deploy']['placement']['constraints'][0] = (
        f"{CONSTRAINTS['building']} == {hostname}")
    template['ports'] = [f'{2222 + number}:22']
101

102
    add_or_update_compose_service(compose_path, service_name, template)
103
104
105
106
107
108
109
110
111
112
113
114
115


def add_openhab_service(base_dir, hostname):
    """Generates an openhab entry and adds it to the compose file

    :base_dir: base directory for configuration files
    :hostname: names of host that the services is added to
    """
    base_path = base_dir + '/' + CUSTOM_DIR
    # compose file
    compose_path = base_path + '/' + COMPOSE_NAME
    # service name
    service_name = f'openhab_{hostname}'
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
    # template
    template = get_service_template(base_dir, SERVICES['openhab'])
    # only label contraint is building
    template['deploy']['placement']['constraints'][0] = (
        f"{CONSTRAINTS['building']} == {hostname}")
    # include in backups of this building
    template['deploy']['labels'].append(f'backup={hostname}')
    # traefik backend
    template['deploy']['labels'].append(f'traefik.backend={service_name}')
    # traefik frontend domain->openhab
    template['deploy']['labels'].extend(
        generate_traefik_host_labels(hostname, segment='main'))
    # traefik frontend subdomain openhab_hostname.* -> openhab
    template['deploy']['labels'].append(
        f'traefik.sub.frontend.rule=HostRegexp:'
        f'{service_name}.{{domain:[a-zA-z0-9-]+}}')
    template['deploy']['labels'].append('traefik.sub.frontend.priority=2')

    add_or_update_compose_service(compose_path, service_name, template)
135
136
137
138
139
140
141
142
143
144
145
146
147


def add_nodered_service(base_dir, hostname):
    """Generates an nodered entry and adds it to the compose file

    :base_dir: base directory for configuration files
    :hostname: names of host that the services is added to
    """
    base_path = base_dir + '/' + CUSTOM_DIR
    # compose file
    compose_path = base_path + '/' + COMPOSE_NAME
    # service name
    service_name = f'nodered_{hostname}'
148
149
150
151
152
153
154
155
156
    # template
    template = get_service_template(base_dir, SERVICES['nodered'])
    # only label contraint is building
    template['deploy']['placement']['constraints'][0] = (
        f"{CONSTRAINTS['building']} == {hostname}")
    template['deploy']['labels'].append(f'traefik.backend={service_name}')
    template['deploy']['labels'].append(f'backup={hostname}')
    template['deploy']['labels'].extend(
        generate_traefik_path_labels(service_name, segment='main'))
Dobli's avatar
Dobli committed
157
158
    template['deploy']['labels'].extend(
        generate_traefik_subdomain_labels(service_name, segment='sub'))
159

160
    add_or_update_compose_service(compose_path, service_name, template)
161
162
163
164
165
166
167
168
169
170
171
172
173
174


def add_mqtt_service(base_dir, hostname, number=0):
    """Generates an mqtt entry and adds it to the compose file

    :base_dir: base directory for configuration files
    :hostname: names of host that the services is added to
    :number: increment of exposed port to prevent overlaps
    """
    base_path = base_dir + '/' + CUSTOM_DIR
    # compose file
    compose_path = base_path + '/' + COMPOSE_NAME
    # service name
    service_name = f'mqtt_{hostname}'
175
176
177
178
179
180
181
    # template
    template = get_service_template(base_dir, SERVICES['mqtt'])
    # only label contraint is building
    template['deploy']['placement']['constraints'][0] = (
        f"{CONSTRAINTS['building']} == {hostname}")
    # ports incremented by number of services
    template['ports'] = [f'{1883 + number}:1883', f'{9001 + number}:9001']
182

183
    add_or_update_compose_service(compose_path, service_name, template)
184
185


dobli's avatar
dobli committed
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
def add_postgres_service(base_dir, hostname):
    """Generates an postgres entry and adds it to the compose file

    :base_dir: base directory for configuration files
    :hostname: names of host that the services is added to
    """
    base_path = base_dir + '/' + CUSTOM_DIR
    # compose file
    compose_path = base_path + '/' + COMPOSE_NAME
    # service name
    service_name = f'postgres_{hostname}'
    # template
    template = get_service_template(base_dir, SERVICES['postgres'])
    # only label contraint is building
    template['deploy']['placement']['constraints'][0] = (
        f"{CONSTRAINTS['building']} == {hostname}")

    add_or_update_compose_service(compose_path, service_name, template)


206
# Helper functions
207
208
209
210
211
212
213
214
215
216
217
218
def get_service_template(base_dir, service_name):
    """Gets a service template entry from the template yaml

    :return: yaml entry of a service
    """
    template_path = base_dir + '/' + TEMPLATE_DIR
    templates = template_path + '/' + TEMPLATES_NAME

    with open(templates, 'r') as templates_file:
        template_content = yaml.load(templates_file)

    return template_content['services'][service_name]
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238


def generate_traefik_host_labels(hostname, segment=None, priority=1):
    """Generates a traefik path url with necessary redirects

    :hostname: Hostname that gets assigned by the label
    :segment: Optional traefik segment when using multiple rules
    :priority: Priority of frontend rule
    :returns: list of labels for traefik
    """
    label_list = []
    # check segment
    segment = f'.{segment}' if segment is not None else ''
    # fill list
    label_list.append(
        f'traefik{segment}.frontend.rule=HostRegexp:{{domain:{hostname}}}')
    label_list.append(f'traefik{segment}.frontend.priority={priority}')
    return label_list


Dobli's avatar
Dobli committed
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
def generate_traefik_subdomain_labels(subdomain, segment=None, priority=2):
    """Generates a traefik subdomain with necessary redirects

    :subdomain: subdomain that will be assigned to a service
    :segment: Optional traefik segment when using multiple rules
    :priority: Priority of frontend rule
    :returns: list of labels for traefik
    """
    label_list = []
    # check segment
    segment = f'.{segment}' if segment is not None else ''
    # fill list
    label_list.append(
        f'traefik{segment}.frontend.rule='
        f'HostRegexp:{subdomain}.{{domain:[a-zA-z0-9-]+}}')
    label_list.append(f'traefik{segment}.frontend.priority={priority}')
    return label_list


258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
def generate_traefik_path_labels(url_path, segment=None, priority=2):
    """Generates a traefik path url with necessary redirects

    :url_path: path that should be used for the site
    :segment: Optional traefik segment when using multiple rules
    :priority: Priority of frontend rule
    :returns: list of labels for traefik
    """
    label_list = []
    # check segment
    segment = f'.{segment}' if segment is not None else ''
    # fill list
    label_list.append(f'traefik{segment}.frontend.priority={priority}')
    label_list.append(
        f'traefik{segment}.frontend.redirect.regex=^(.*)/{url_path}$$')
    label_list.append(
        f'traefik{segment}.frontend.redirect.replacement=$$1/{url_path}/')
    label_list.append(
        f'traefik{segment}.frontend.rule=PathPrefix:/{url_path};'
        f'ReplacePathRegex:^/{url_path}/(.*) /$$1')
    return label_list


def add_or_update_compose_service(compose_path, service_name, service_content):
    """Adds or replaces a service in a compose file

    :compose_path: path of the compose file to change
    :service_name: name of the service to add/replace
    :service_content: service definition to add
    """
    with open(compose_path, 'r+') as compose_f:
        # load compose file
        compose = yaml.load(compose_f)
        # add / update service with template
        compose['services'][service_name] = service_content
        # write content starting from first line
        compose_f.seek(0)
        # write new compose content
        yaml.dump(compose, compose_f)
        # reduce file to new size
        compose_f.truncate()
299
# }}}
dobli's avatar
dobli committed
300

301

302
# ******************************
dobli's avatar
dobli committed
303
# Config file functions {{{
304
# ******************************
305
def generate_config_folders(base_dir):
306
307
    """Generate folders for configuration files

308
    :base_dir: Path to add folders to
309
    """
310
311
312
313
314
315
    base_path = base_dir + '/' + CUSTOM_DIR
    if not os.path.exists(base_dir):
        os.makedirs(base_dir)

    print(f'Initialize configuration in {base_path}')

316
    # generate empty config dirs
317
318
319
320
321
    for d in CONFIG_DIRS:
        new_dir = base_path + '/' + d
        if not os.path.exists(new_dir):
            os.makedirs(new_dir)

322
323
324
325
    # copy template configs
    for template_file in TEMPLATE_FILES:
        copy_template_config(base_dir, template_file)

326

327
328
329
330
331
332
def copy_template_config(base_dir, config_path):
    """Copies template configuration files into custom folder

    :base_dir: path that contains template and custom folders
    :config_path: relative path of config to copy from template
    """
Dobli's avatar
Dobli committed
333
334
335
336
337
    custom_path = base_dir + '/' + CUSTOM_DIR + "/" + config_path
    template_path = base_dir + '/' + TEMPLATE_DIR + "/" + config_path

    logging.info(f'Copy {config_path} from {custom_path} to {template_path}')
    copy2(template_path, custom_path)
338
339


340
341
342
343
344
345
def generate_mosquitto_user_line(username, password):
    """Generates a line for a mosquitto user with a crypt hashed password

    :username: username to use
    :password: password that will be hashed (SHA512)

346
    :returns: a line as expected by mosquitto
347
348
349
350
351
352
    """
    password_hash = crypt.crypt(password, crypt.mksalt(crypt.METHOD_SHA512))
    line = f"{username}:{password_hash}"
    return line


353
354
355
356
def generate_sftp_user_line(username, password, directories=None):
    """Generates a line for a sftp user with a hashed password

    :username: username to use
357
    :password: password that will be hashed (SHA512)
358
359
    :directories: list of directories which the user should have

360
    :returns: a line as expected by sshd
361
362
363
    """
    # generate user line with hashed password
    password_hash = crypt.crypt(password, crypt.mksalt(crypt.METHOD_SHA512))
364
    line = f"{username}:{password_hash}:e:{UID}:{UID}"
365
366
367
368
369
370
371
372
    # add directory entries when available
    if directories:
        # create comma separated string from list
        dir_line = ','.join(d for d in directories)
        line = f"{line}:{dir_line}"
    return line


373
374
375
376
377
378
379
380
381
382
383
384
385
def generate_traefik_user_line(username, password):
    """Generates a line for a traefik user with a bcrypt hashed password

    :username: username to use
    :password: password that will be hashed (bcrypt)

    :returns: a line as expected by traefik
    """
    password_hash = bcrypt.hashpw(password.encode(), bcrypt.gensalt())
    line = f"{username}:{password_hash.decode()}"
    return line


386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
def generate_mosquitto_file(base_dir, username, password):
    """Generates a mosquitto password file using mosquitto_passwd system tool

    :base_dir: path that contains custom config folder
    :username: username to use
    :password: password that will be used
    """
    passwd_path = base_dir + '/' + CUSTOM_DIR + "/" + EDIT_FILES[
        'mosquitto_passwords']

    # ensure file exists
    if not os.path.exists(passwd_path):
        open(passwd_path, 'a').close()

    # execute mosquitto passwd
    mos_result = run(
        ['mosquitto_passwd', '-b', passwd_path, username, password],
403
        universal_newlines=True)
404
405
406
407
    return mos_result.returncode == 0


def generate_sftp_file(base_dir, username, password, direcories=None):
408
    """Generates a sftp password file
409
410
411
412
413
414
415
416
417
418
419
420

    :base_dir: path that contains custom config folder
    :username: username to use
    :password: password that will be used
    :directories: list of directories which the user should have
    """
    # generate line and save it into a file
    file_content = generate_sftp_user_line(username, password, direcories)
    create_or_replace_config_file(base_dir, EDIT_FILES['sftp_users'],
                                  file_content)


dobli's avatar
dobli committed
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
def generate_postgres_files(base_dir, username, password):
    """Generates postgres user and password files

    :base_dir: path that contains custom config folder
    :username: username to use
    :password: password that will be used
    """
    # content is purely username and (hashed) password
    hashed_password = 'md5' + \
        md5(username.encode() + password.encode()).hexdigest()
    create_or_replace_config_file(
        base_dir, EDIT_FILES['postgres_user'], username)
    create_or_replace_config_file(
        base_dir, EDIT_FILES['postgres_passwd'], hashed_password)


437
438
439
440
441
442
443
444
445
446
def generate_id_rsa_files(base_dir):
    """Generates id_rsa and id_rsa.pub private/public keys using ssh-keygen

    :base_dir: path that contains custom config folder
    """
    id_path = base_dir + '/' + CUSTOM_DIR + "/" + EDIT_FILES['id_rsa']

    # execute ssh-keygen
    id_result = run(
        ['ssh-keygen', '-t', 'rsa', '-b', '4096', '-f', id_path, '-N', ''],
447
        universal_newlines=True, stdout=PIPE)
448
449
450
451
452
453
454
455
456
457
458
    return id_result.returncode == 0


def generate_host_key_files(base_dir, hosts):
    """Generates ssh host keys and matching known_hosts using ssh-keygen

    :base_dir: path that contains custom config folder
    """
    key_path = base_dir + '/' + CUSTOM_DIR + "/" + EDIT_FILES['host_key']
    # ssh-keygen generates public key with .pub postfix
    pub_path = key_path + '.pub'
459
460
    # host_names with sftp_ postfix
    sftp_hosts = [f'sftp_{host}' for host in hosts]
461
462
463

    # execute ssh-keygen
    id_result = run(['ssh-keygen', '-t', 'ed25519', '-f', key_path, '-N', ''],
464
                    universal_newlines=True, stdout=PIPE)
465
466
467
468
469
470
471
472

    # read content of public key as known line
    known_line = ""
    with open(pub_path, 'r') as pub_file:
        pub_line = pub_file.readline()
        split_line = pub_line.split()
        # delete last list element
        del split_line[-1]
473
474
        # collect sftp hosts as comma separated string
        hosts_line = ','.join(h for h in sftp_hosts)
475
476
477
478
479
480
481
482
483
484
485
        split_line.insert(0, hosts_line)
        # collect parts as space separated string
        known_line = ' '.join(sp for sp in split_line)

    # write new known_line file
    create_or_replace_config_file(base_dir, EDIT_FILES['known_hosts'],
                                  known_line)

    return id_result.returncode == 0


486
487
488
489
490
491
492
493
494
495
496
497
498
def generate_traefik_file(base_dir, username, password):
    """Generates a traefik password file

    :base_dir: path that contains custom config folder
    :username: username to use
    :password: password that will be used
    """
    # generate line and save it into a file
    file_content = generate_traefik_user_line(username, password)
    create_or_replace_config_file(base_dir, EDIT_FILES['traefik_users'],
                                  file_content)


499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
def generate_volumerize_file(base_dir, hosts):
    """Generates config for volumerize backups

    :base_dir: path that contains custom config folder
    :hosts: names of backup hosts
    """
    configs = []

    for h in hosts:
        host_config = {
            'description': f'Backup Server on {h}',
            'url': f'sftp://ohadmin@sftp_{h}://home/ohadmin/backup_data/{h}'
        }
        configs.append(host_config)

    create_or_replace_config_file(
        base_dir, EDIT_FILES['backup_config'], configs, json=True)


def create_or_replace_config_file(base_dir, config_path, content, json=False):
519
520
521
522
523
524
525
526
    """Creates or replaces a config file with new content

    :base_dir: path that contains custom config folder
    :config_path: relative path of config
    :content: content of the file as a string
    """
    custom_path = base_dir + '/' + CUSTOM_DIR + "/" + config_path
    with open(custom_path, 'w+') as file:
527
528
529
530
531
        if json:
            import json
            json.dump(content, file, indent=2)
        else:
            file.write(content)
532
533


dobli's avatar
dobli committed
534
535
536
# }}}


537
# ******************************
dobli's avatar
dobli committed
538
# Docker machine functions {{{
539
# ******************************
540
541
542
543
544
545
def get_machine_list():
    """Get a list of docker machine names using the docker-machine system command

    :returns: a list of machine names managed by docker-machine
    """
    machine_result = run(['docker-machine', 'ls', '-q'],
546
547
                         universal_newlines=True,
                         stdout=PIPE)
548
549
550
551
552
553
554
    return machine_result.stdout.splitlines()


def check_machine_exists(machine_name):
    """Checks weather a docker machine exists and is available

    :machine_name: Name of the machine to check
dobli's avatar
dobli committed
555
    :returns: True when machine is available
556
557
558
559
560
561
562
563
564
565
566
567
568
    """
    machines = get_machine_list()

    return machine_name in machines


def get_machine_env(machine_name):
    """Gets dict of env settings from a machine

    :machine_name: Name of the machine to check
    :returns: Dict of env variables for this machine
    """
    env_result = run(['docker-machine', 'env', machine_name],
569
570
                     universal_newlines=True,
                     stdout=PIPE)
571
572
573
574
575
576
577
578
579
580
581
582

    machine_envs = {}

    lines = env_result.stdout.splitlines()
    for line in lines:
        if 'export' in line:
            assign = line.split('export ', 1)[1]
            env_entry = [a.strip('"') for a in assign.split('=', 1)]
            machine_envs[env_entry[0]] = env_entry[1]
    return machine_envs


dobli's avatar
dobli committed
583
584
585
586
587
588
def get_machine_ip(machine_name):
    """Asks for the ip of the docker machine

    :machine_name: Name of the machine to use for init
    """
    machine_result = run(['docker-machine', 'ip', machine_name],
589
590
                         universal_newlines=True,
                         stdout=PIPE)
591
    return machine_result.stdout.strip()
dobli's avatar
dobli committed
592
593
594
595
596
597


def init_swarm_machine(machine_name):
    """Creates a new swarm with the specified machine as leader

    :machine_name: Name of the machine to use for init
598
    :return: True if swarm init was successful
dobli's avatar
dobli committed
599
600
601
    """
    machine_ip = get_machine_ip(machine_name)
    init_command = 'docker swarm init --advertise-addr ' + machine_ip
602
    init_result = run(['docker-machine', 'ssh', machine_name, init_command],
603
                      universal_newlines=True)
604
    return init_result.returncode == 0
dobli's avatar
dobli committed
605
606
607
608
609
610
611


def join_swarm_machine(machine_name, leader_name):
    """Joins the swarm of the specified leader

    :machine_name: Name of the machine to join a swarm
    :leader_name: Name of the swarm leader machine
612
    :return: True if join to swarm was successful
dobli's avatar
dobli committed
613
614
615
    """
    token_command = 'docker swarm join-token manager -q'
    token_result = run(['docker-machine', 'ssh', leader_name, token_command],
616
617
                       universal_newlines=True,
                       stdout=PIPE)
618
    token = token_result.stdout.strip()
dobli's avatar
dobli committed
619
    leader_ip = get_machine_ip(leader_name)
620
    logging.info(f"Swarm leader with ip {leader_ip} uses token {token}")
dobli's avatar
dobli committed
621

622
623
624
    join_cmd = f'docker swarm join --token {token} {leader_ip}:{SWARM_PORT}'
    logging.info(f'Machine {machine_name} joins using command {join_cmd}')
    join_result = run(['docker-machine', 'ssh', machine_name, join_cmd],
625
                      universal_newlines=True)
dobli's avatar
dobli committed
626

627
    return join_result.returncode == 0
dobli's avatar
dobli committed
628
629


630
631
632
633
634
635
def generate_swarm(machines):
    """Generates a swarm, the first machine will be the initial leader

    :machines: list of machines in the swarm
    """
    leader = None
636
    for machine in machines:
637
638
639
640
641
642
        # init swarm with first machine
        if leader is None:
            leader = machine
            print(f'Create initial swarm with leader {leader}')
            if init_swarm_machine(leader):
                print('Swarm init successful\n')
643
644
                assign_label_to_node(leader, 'building',
                                     leader, manager=leader)
645
646
647
648
        else:
            print(f'Machine {machine} joins swarm of leader {leader}')
            if (join_swarm_machine(machine, leader)):
                print('Joining swarm successful\n')
649
650
                assign_label_to_node(machine, 'building',
                                     machine, manager=leader)
Dobli's avatar
Dobli committed
651
652


dobli's avatar
dobli committed
653
654
655
# }}}


656
# ******************************
dobli's avatar
dobli committed
657
# Docker client commands {{{
658
# ******************************
659
def assign_label_to_node(nodeid, label, value, manager=None):
660
661
662
663
664
    """Assigns a label to a node (e.g. building)

    :nodeid: Id or name of the node
    :label: Label you want to add
    :value: The value to assign to the label
665
    :manager: Dpcker machine to use for command, otherwise local
666
    """
667
668
669
670
671
    if manager:
        building_env = get_machine_env(manager)
        client = docker.from_env(environment=building_env)
    else:
        client = docker.from_env()
672
673
674
675
676

    node = client.nodes.get(nodeid)
    spec = node.attrs['Spec']
    spec['Labels'][label] = value
    node.update(spec)
677
    logging.info(f'Assign label {label} with value {value} to {nodeid}')
678
679
680
681

    client.close()


682
683
684
685
686
687
688
689
690
691
def run_command_in_service(service, command, building=None):
    """Runs a command in a service based on its name.
    When no matching container is found or the service name is ambigous
    an error will be displayed and the function exits

    :param service: Name of the service to execute command
    :param command: Command to execute
    :param building: Optional building, make service unambigous (Default: None)
    """

692
693
694
695
696
    if building:
        building_env = get_machine_env(building)
        client = docker.from_env(environment=building_env)
    else:
        client = docker.from_env()
697
698
699
700
701
702
703

    # Find containers matching name
    service_name_filter = {"name": service}
    containers = client.containers.list(filters=service_name_filter)

    # Ensure match is unambigous
    if (len(containers) > 1):
704
        print(f'Found multiple containers matching service name {service}, '
705
706
              'ensure service is unambigous')
    elif (len(containers) < 1):
707
        print(f'Found no matching container for service name {service}')
708
709
    else:
        service_container = containers[0]
710
711
        print(f'Executing {command} in container {service_container.name}'
              f'({service_container.id}) on building {building}')
dobli's avatar
dobli committed
712
713
        command_exec = service_container.exec_run(command)
        print(command_exec.output.decode())
714
    client.close()
715
716


dobli's avatar
dobli committed
717
718
719
# }}}


720
# ******************************
dobli's avatar
dobli committed
721
# CLI base commands {{{
722
# ******************************
723
724
725
726
727
728
729
730
def init_config_dirs_command(args):
    """Initialize config directories

    :args: parsed commandline arguments
    """
    base_dir = args.base_dir

    if base_dir is None:
731
        base_dir = os.getcwd()
732

Dobli's avatar
Dobli committed
733
    # generate basic config folder
734
735
736
    generate_config_folders(base_dir)


737
738
739
740
741
742
743
744
def assign_building_command(args):
    """Assigns the role of a building to a node

    :args: parsed commandline arguments
    """
    node = args.node
    building = args.building

745
    print(f'Assign role of building {building} to node {node}')
746
747
748
749

    assign_label_to_node(node, 'building', building)


750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
def execute_command(args):
    """Top level function to manage command executions from CLI

    :args: parsed commandline arguments
    """
    service = args.service
    command = " ".join(str(x) for x in args.command)  # list to string
    building = args.building

    run_command_in_service(service, command, building)


def restore_command(args):
    """Top level function to manage command executions from CLI

    :args: parsed commandline arguments
    """
767
768
769
770
    building = args.building
    target = args.target

    if not check_machine_exists(target):
771
        print(f'Machine with name {target} not found')
772
773
        return

774
    print(f'Restoring building {building} on machine {target}')
775
776

    get_machine_env(target)
777
778


779
780
781
def interactive_command(args):
    """Top level function to start the interactive mode

782
    :args: parsed command line arguments
783
    """
Dobli's avatar
Dobli committed
784
    main_menu(args)
785
786


dobli's avatar
dobli committed
787
788
789
# }}}


790
# ******************************
dobli's avatar
dobli committed
791
# Interactive menu entries {{{
792
# ******************************
793
def main_menu(args):
794
795
    """ Display main menu
    """
796
797
798
799
800
801
802
    # Base directory for configs
    base_dir = args.base_dir

    if base_dir is None:
        base_dir = os.getcwd()

    # Main menu prompts
803
    questions = [{
804
805
806
807
        'type': 'list',
        'name': 'main',
        'message': 'Public Building Manager - Main Menu',
        'choices': load_main_entires(base_dir)
808
809
810
811
    }]
    answers = prompt(questions)

    if 'Create' in answers['main']:
812
        init_menu(args)
813
814
815
816

    return answers


817
def init_menu(args):
818
819
    """Menu entry for initial setup and file generation
    """
820
821
822
823
824
825
826
    # Base directory for configs
    base_dir = args.base_dir

    if base_dir is None:
        base_dir = os.getcwd()

    # Prompts
Dobli's avatar
Dobli committed
827
    questions = [
828
        {
Dobli's avatar
Dobli committed
829
830
831
832
            'type': 'input',
            'name': 'stack_name',
            'message': 'Choose a name for your setup'
        },
833
        {
Dobli's avatar
Dobli committed
834
835
836
837
838
839
            'type': 'checkbox',
            'name': 'machines',
            'message': 'What docker machines will be used?',
            'choices': generate_checkbox_choices(get_machine_list())
        }
    ]
840
841
    answers = prompt(questions)

842
843
844
845
    # Ensure passwords match
    password_match = False
    while not password_match:
        password_questions = [{
Dobli's avatar
Dobli committed
846
847
848
849
850
851
            'type':
            'password',
            'name':
            'password',
            'message':
            'Choose a password for the ohadmin user:',
852
853
        },
            {
Dobli's avatar
Dobli committed
854
855
856
857
858
859
            'type':
            'password',
            'name':
            'confirm',
            'message':
            'Repeat password for the ohadmin user',
860
861
862
863
        }]
        password_answers = prompt(password_questions)
        if password_answers['password'] == password_answers['confirm']:
            password_match = True
dobli's avatar
dobli committed
864
        else:
865
            print("Passwords did not match, try again")
866

867
868
    # Initialize custom configuration dirs and templates
    generate_config_folders(base_dir)
869
    generate_initial_compose(base_dir)
870
    # Generate config files based on input
Dobli's avatar
Dobli committed
871
    username = ADMIN_USER
872
873
874
    password = password_answers['password']
    hosts = answers['machines']
    generate_sftp_file(base_dir, username, password)
dobli's avatar
dobli committed
875
    generate_postgres_files(base_dir, username, password)
876
877
    generate_mosquitto_file(base_dir, username, password)
    generate_traefik_file(base_dir, username, password)
878
    generate_volumerize_file(base_dir, hosts)
879
    generate_id_rsa_files(base_dir)
880
881
    generate_host_key_files(base_dir, hosts)

882
    for i, host in enumerate(hosts):
883
        init_machine_menu(base_dir, host, i)
884

885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
    # print(answers)
    print(f"Configuration files generated in {base_dir}")

    # Check if changes shall be applied to docker environment
    generate_questions = [{
        'type': 'confirm',
        'name': 'generate',
        'message': 'Apply changes to docker environment?',
        'default': True
    }]
    generate_answers = prompt(generate_questions)

    if generate_answers['generate']:
        generate_swarm(answers['machines'])


901
902
903
904
905
906
907
908
909
910
911
912
def init_machine_menu(base_dir, host, increment):
    """Prompts to select server services

    :base_dir: Directory of config files
    :host: docker-machine host
    :increment: incrementing number to ensure ports are unique
    """
    # Prompt for services
    questions = [
        {
            'type': 'input',
            'name': 'buildingid',
dobli's avatar
dobli committed
913
914
            'message': f'Choose a name for building on server {host}',
            'default': f'{host}'
915
916
917
918
        },
        {
            'type': 'checkbox',
            'name': 'services',
919
            'message': f'What services shall {host} provide?',
920
921
922
923
924
925
926
927
928
929
930
931
932
            'choices': generate_checkbox_choices(SERVICES.keys(), checked=True)
        }
    ]
    answers = prompt(questions)
    services = answers['services']
    if 'sftp' in services:
        add_sftp_service(base_dir, host, increment)
    if 'openhab' in services:
        add_openhab_service(base_dir, host)
    if 'nodered' in services:
        add_nodered_service(base_dir, host)
    if 'mqtt' in services:
        add_mqtt_service(base_dir, host, increment)
dobli's avatar
dobli committed
933
934
    if 'postgres' in services:
        add_postgres_service(base_dir, host)
935
936
937
    print(answers)


938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
def load_main_entires(base_dir):
    """Loads entries for main menu depending on available files

    :base_dir: directory of configuration files
    :returns: entries of main menu
    """
    custom_path = base_dir + '/' + CUSTOM_DIR

    entries = []
    if not os.path.exists(custom_path):
        entries.append('Create initial structure')
    else:
        entries.append('Execute command')

    entries.append('Exit')
953

954
    return entries
955
956


957
def generate_checkbox_choices(list, checked=False):
dobli's avatar
dobli committed
958
959
    """Generates checkbox entries for lists of strings

960
961
    :list: pyhton list that shall be converted
    :checked: if true, selections will be checked by default
dobli's avatar
dobli committed
962
963
    :returns: A list of dicts with name keys
    """
964
    return [{'name': m, 'checked': checked} for m in list]
dobli's avatar
dobli committed
965
966
# }}}

967

968
# ******************************
969
# Script main ( entry) {{{
970
# ******************************
971
972
973
if __name__ == '__main__':
    import argparse
    parser = argparse.ArgumentParser(
974
        prog='building_manager',
975
976
        description='Generate and manage multi'
        'building configurations of openHAB with docker swarm')
977
978
979
980
    parser.add_argument(
        '--base_dir',
        '-d',
        help='Directory to creat config folders in, default is current dir')
981
982
    subparsers = parser.add_subparsers()

983
984
985
986
987
988
    # Interactive mode
    parser_interactive = subparsers.add_parser(
        'interactive',
        help='Starts the interactive mode of the building manager')
    parser_interactive.set_defaults(func=interactive_command)

989
990
991
    # Restore command
    parser_restore = subparsers.add_parser('restore', help='Restore backups')
    parser_restore.add_argument(
992
        'building', help='Name (label) of the building that shall be restored')
993
994
995
996
    parser_restore.add_argument(
        'target', help='Name of the machine to restore to')
    parser_restore.set_defaults(func=restore_command)

997
998
999
1000
1001
1002
1003
1004
1005
    # Assign building command
    parser_assign_building = subparsers.add_parser(
        'assign_building', help='Assign the role of a building to a node')
    parser_assign_building.add_argument(
        'node', help='Name (or ID) of the node that gets the role assigned')
    parser_assign_building.add_argument(
        'building', help='Name of the building that will be assigned')
    parser_assign_building.set_defaults(func=assign_building_command)

1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
    # Execute command
    parser_exec = subparsers.add_parser(
        'exec', help='Execute commands in a service container')
    parser_exec.add_argument(
        'service', help='Name of the service that will run the command')
    parser_exec.add_argument(
        'command', help='Command to be executed', nargs=argparse.REMAINDER)
    parser_exec.add_argument(
        '--building',
        '-b',
        help='Building name (label) of the service if '
        'service location is ambiguous')
    parser_exec.set_defaults(func=execute_command)

1020
1021
1022
1023
1024
1025
1026
1027
1028
    # Config commands
    parser_config = subparsers.add_parser(
        'config', help='Manage configuration files')
    parser_config_subs = parser_config.add_subparsers()
    # - Config init
    parser_config_init = parser_config_subs.add_parser(
        'init', help='Initialize config file directories')
    parser_config_init.set_defaults(func=init_config_dirs_command)

1029
    # Parse arguments into args dict
1030
    args = parser.parse_args()
1031
1032
1033
1034
1035
1036

    # when no subcommand is defined show interactive menu
    try:
        args.func(args)
    except AttributeError:
        interactive_command(args)
dobli's avatar
dobli committed
1037
1038
1039
1040
# }}}

# --- vim settings ---
# vim:foldmethod=marker:foldlevel=0