Skip to content

iranianpep/iautomate

Repository files navigation

Build Status codecov

Requirements

  • Python 2.7+
  • pip

Installation

  1. Make sure the user is root:
    sudo su
    
  2. Run bootstrap.sh:
    sh bootstrap.sh
    
    This will install pip and iautomate. If pip is already installed you can run the following command straightaway:
    pip install --ignore-installed --no-cache-dir iautomate
    
  3. Upload the configuration file for example sample-configuration.json.
  4. Upload the files which are going to be used as a source for new files (this is explained in configuration section).
  5. Finally run:
    iautomate sample-config.json
    

Configurations

IAutomate automates all the server configurations mainly based on a JSON config file. An example of the file named sample-config.json is provided in the repo.

The config file consists of:

  • vars: which are the global variables including:
Name Type Required Description
sudo boolean no Whether actions are run as root or not. It is recommended to be true
debug boolean no Whether shell commands output should be printed or not. This is used for troubleshooting
doc_root string yes Server document root e.g. /var/www/html
  • tasks: Includes a list of tasks that will be run in order. Each task may have the following resources:

    • files: Responsible for managing files. Each file may have the following properties:
    Name Type Required Description
    name string yes Path to the file. Name can have a dynamic variable e.g. {$doc_root} referring to a global variable in this case doc_root
    action string no Action to be run: create, remove. If create is specified the source file must be specified too
    ensure string no Run a check on a file. At the moment only present supported
    source string no Path to the source file if a new file is going to be created based on it
    owner string no Owner of the file. Must be specified for a new file
    group string no Group of the file. Must be specified for a new file
    mode integer no Mode (permission) of the file. Must be specified for a new file
    • execs: Responsible for running shell commands. Each exec may have the following properties:
    Name Type Required Description
    name string yes Description of a command to be run
    action string yes Shell command to be run
    • packages: Responsible for managing Debian packages. Each package may have the following properties:
    Name Type Required Description
    name string yes Exact name of a package
    action string yes Action to be run: install, remove
    version string no Version of a new package. If is not specified the latest version is installed
    • services: Responsible for managing services. Each service may have the following properties:
    Name Type Required Description
    name string yes Exact name of a service
    ensure string yes Run a check on a service. At the moment only: running, dead, restarted. If the current status of the service does not match with ensure value IAutomate tries to change the service status. For example if the service is dead, the service will be started
    • directories: Responsible for managing directories. Each directory may have the following properties:
    Name Type Required Description
    name string yes Path to a directory. Name can have a dynamic variable e.g. {$doc_root} referring to a global variable in this case doc_root
    action string no Action to be run: create, remove.
    ensure string no Run a check on a directory. At the moment only: present. If the directory does not exist an exception will be thrown
    owner string no Owner of the directory. Must be specified for a new directory
    group string no Group of the directory. Must be specified for a new directory
    mode integer no Mode (permission) of the directory. Must be specified for a new directory

    Also each resource can have another property called after_tasks which has got the exact structure of a parent tasks. This is useful to run some additional tasks immediately after running a resource.

The Engine Architecture

If you look at the iautomate/iautomate directory you will see two packages:

  • helpers: includes a few standalone functions
  • resources: which basically includes a model for each of the above resources

In addition to the parent package which includes:

  • global_variables.py: A class to make accessing the vars easier

  • iautomate.py: The engine for the application and all it does is:

    1. Iterating through all the resources specified in the config file in the same order:
    def __handle_task(self, task):
    # for each task handle the sub items based on the type
    for config_type, properties in task.items():
        if config_type == 'execs':
            print('| Handling execs ...')
            self.__handle_execs(properties)
        elif config_type == 'packages':
            print('| Handling packages ...')
            self.__handle_packages(properties)
        elif config_type == 'services':
            print('| Handling services ...')
            self.__handle_services(properties)
        elif config_type == 'files':
            print('| Handling files ...')
            self.__handle_files(properties)
        elif config_type == 'directories':
            print('| Handling directories ...')
            self.__handle_directories(properties)
        else:
            # unsupported resource
            print('Unsupported resource: ' + config_type)
    
    1. Instantiating an object for each resource
    2. And finally calling the run function on each resource object for example for execution resource:
    # handle execution resource
    def __handle_execs(self, execs):
        for execution in execs:
            self.__handle_exec(execution)
    
    # handle execution resource
    def __handle_exec(self, execution_properties):
        # instantiate execution model and run it
        execution = execution_resource.ExecutionResource(execution_properties, self.global_variables)
        execution.run()
    
        if execution_properties.get(abstract_resource.AbstractResource.AFTER_TASKS_KEY, None):
            self.__handle_tasks(execution_properties.get(abstract_resource.AbstractResource.AFTER_TASKS_KEY))
    

    Also since the resource objects share some common properties and functions, an abstract parent class named AbstractResource is created to make the next developer's life easier!

You may ask why this kind of design? Well, I checked the config files for the existing tools such as Chef, Puppet, Ansible and chose the user-friendly pieces and came up with the current config file. Then based on the config file the app structure was implemented.

About

Server setup automation tool

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages