Overview

Please refer to: http://aiorunbook.readthedocs.io/

Installation

sudo pip3 install git+https://github.com/slieberth/aioRunbook.git

Hello-World aioRunbookScheduler

import asyncio
from aioRunbook.aioRunbookScheduler import aioRunbookScheduler

ymlConfigString = """#hello world yml
config:
  steps:
    - record:
        name: record test local-shell
        method: local-shell
        commands:
          - echo "Hello World" """
fh = open("test.yml",'w')
fh.write(ymlConfigString)
fh.close()
myRunbook = aioRunbookScheduler("test.yml")
loop = asyncio.get_event_loop()
loop.run_until_complete(myRunbook.execSteps(loop))
print(myRunbook.configDict["config"]["steps"][0]['record']['output'])

Hello-World aioRunbookHttpServer

from aioRunbook.aioRunbookHttpServer import aioRunbookHttpServer
from aiohttp.web import Application, Response, StreamResponse, run_app
import asyncio

ymlConfigString = """#
templateDir: "./templates/"
runbookDirs:
  - "./runbookDir1"
  - "./runbookDir2"
  - "./runbookDir3"
httpPort: 4711
userAuth:
- - username: CharlieBrown
  - password: test
  - permissions:
    - viewResults
- - username: MissSophie
  - password: test
  - permissions:
    - viewResults
    - runTests
- - username: MajorTom
  - password: test
  - permissions:
    - viewResults
    - runTests
    - editTests"""
fh = open("aioServerConfig.yml",'w')
fh.write(ymlConfigString)
fh.close()
myHttpServer = aioRunbookHttpServer("aioServerConfig.yml")
loop = asyncio.get_event_loop()
app = myHttpServer.init(loop)
if app != None:
    loop.run_until_complete(run_app(app,port=myHttpServer.httpPort))

On your local machine you must copy all *.html files from the git template into a local folder ./templates. On your local machine you must create the directories for the configured runbooks directories: ./runbookDir[1-3] All directories are customizable in the config file. The given ones are just examples.

testing aioRunbookHttpServer with docker

an docker container is available for testing:

docker pull slieberth/aiorunbook
docker run  -p 4711:4711 slieberth:aioRunbook

The direct your browser to 127.0.0.1:4711