Name

Automation of warewulf4 configuration and other services on an operating system. WIP

Goals

Prepare everything to be able to deploy Compute nodes with ww4.

• dnsmask: dns ready
• tftp: get it ready
• ww4:
  • general configure
  • nodes
  • get container
  • prepare container (ssh key, munge key, slurm, etc...)
• firewalld: permit dns and dhcp request
• slurm: get it ready for the current conf

User Settings

User can set some parameter in the autoww4.yaml file.

Example:

# WARNING: INCORRET PARAMATERS WILL LEAD TO BAD SYSTEM CONFIGURATION
# Dont change the section name
ww4:
  - wwctl: "/usr/bin/wwctl"
  - ww4_config_file: "/etc/warewulf/warewulf.conf"
  - ww4_nodes_file: "/etc/warewulf/nodes.conf"

general:
  #  - interface: "eth0"
  - nodename: "slenode"
  - nbnode: 3

dnsmasq:
  - dnsmasq_config_file: "/etc/dnsmasq.conf"
  - dnsmasq_hosts: "/etc/dnsmasq.d/dnsmasq-hosts.conf"
  - dnsmasq_resolv: "/etc/dnsmasq.d/dnsmasq-resolv.conf"
  - dnsmasq: "/usr/sbin/dnsmasq"
  - dnsmasq_domain: "sle.lan"

tftp:
  - tftp_config_file: "/etc/sysconfig/tftp"

dhcpd:
  - dhcpd_sysconfig_file: "/etc/sysconfig/dhcpd"
  - dhcpd_config_file: '/etc/dhcpd.conf'
  - authoritative: 'off'

Usage

config are stored in configuration.py for now, will be in autoww4.yaml in the futur

# git clone https://github.com/aginies/autoww4
# cd autoww4/src
# python3 -m autoww4
 Version: 0.1.0

 autoww4 Interactive Terminal

 Available parameters:
 conf: configuration file to use
 interface: interface to use for dhcpd
 authoritative: Set DHCPD server as authoritative or not
 nbnode: how many nodes to prepare
 nodename: node name (alphanumeric)
 dnsmasq_domain: domain name for dnsmasq

 Container parameters:
 list_containers_registry: list containers registry available
 available_containers: containers already available on the system
 container: container to use for deployment

---------- User Settings ----------
Node Name: slenode
Number Node(s): 3
dnsmasq domain: sle.lan
Main Configuration: ./autoww4.yaml

Functions

auto.py

class Automatic():
    def __init__(self):
    def do_all(self):

cmd.py

class Interactive(Cmd):
    def __init__(self, config):
    def update_prompt(self):
    def do_interface(self, args):
    def complete_interface(self, text, _line, _begidx, _endidx):
    def do_authoritative(self, args):
    def do_nodemane(self, args):
    def do_dnsmasq_domain(self, args):
    def do_conf(self, args):
    def do_nbnode(self, args):
    def do_list_containers_registry(self, args):
    def complete_list_containers_registry(self, text, _line, _begidx, _endidx):
    def do_available_containers(self, _args):
    def do_container(self, args):
    def complete_container(self, text, _line, _begidx, _endidx):
    def do_test(self, _args):
    def do_auto(self, _):
    def do_quit(self, _):

configuration.py

def find_file_dir(name, what):
def check_conffile(conf):
def find_conffile():
class Configuration():
    def __init__(self):
    def basic_config(self):
    def check_user_settings(self):

dhcpd.py

class Dhcpd():
    def __init__(self):
    def dhcpd_interface(self, interface):
    def set_authoritative(self, value):

dnsmasq.py

def restart_dnsmasq():
def start_dnsmasq():
def enable_dnsmasq():
class Dnsmasq():
    def dnsmasq_config(self, config, interface):
    def d_add_node(self, node, ipaddr):
    def dnsmasq_resolv_conf(self, config):
    def dnsmasq_test(self):

init.py

main.py

main.py

def main():

tftp.py

class Tftp():
    def tftp_directory(self, directory):
    def tftp_option(self, options):
def tftp_enable():
def tftp_start():
def tftp_restart():

util.py

def run_command(cmd):
def run_command_with_except(cmd):
def systemd_start(service):
def systemd_restart(service):
def systemd_enable(service):
def cmd_exists(cmd):
def get_network_interface():
def list_containers_registry(familly):
def change_var(conffile, var_to_change, var_value, equal="="):
def esc(color):
def print_error(text):
def print_warning(text):
def print_ok(text):
def print_info(text):
def print_summary(text):
def print_title(text):
def print_summary_ok(text):
def print_command(text):
def print_data(data, value):
def validate_yaml_file(file_path):
def backup_file(file):
def check_iam_root():
def find_ext_file(ext):
def extract_subnet_range(config):
def get_ip_address(interface):
def create_if_not_exist(afile):

ww4.py

def ww4_start():
def ww4_restart():
def ww4_enable():
class Ww4():
    def import_container(self, familly, product):
    def ww4_nodes_conf(self, config):
    def ww4_warewulf_conf(self, config):
    def add_node(self, node, ipaddr):
    def get_nodes_list(self):
    def containers_available(self):
    def prepare_container(self, container):
    def container_set_default(self, container, node):
    def create_nodes_list(self):

containers.py

This file contains the base_url and list of product per familly (SUSE, openSUSE, ubuntu...)

Code

Source

Issues

Authors

Written by Antoine Ginies