RundeckRun

[Version 0.2.2]

This is a lightweight wrapper written in Python to interact with the Rundeck API. It uses the awesome requests library.

Installation

Note

Requires requests

$ pip install rundeckrun

Basic Example

Initialize

>>> from rundeck.client import Rundeck
>>> rd = Rundeck('rundeck.server.com', api_token='SECRET_API_TOKEN')

List Projects

>>> rd.projects()
[{
    'description': None,
    'name': 'TestProject',
    'resources': {'providerURL': 'http://localhost:8000/resources.xml'},
}]

List Jobs for a Project

>>> rd.jobs('TestProject')
[{'description': 'Hello World!',
  'group': None,
  'id': 'a6e1e0f7-ad32-4b93-ba2c-9387be06a146',
  'name': 'HelloWorld',
  'project': 'TestProject'}]

Execute a Job

>>> rd.job_run('HelloWorld', 'TestProject', argString={'from':'rundeckrun'})
{'argstring': '-from rundeckrun',
 'date-started': datetime.datetime(2013, 7, 11, 18, 4, 24),
 'description': 'Plugin[localexec, nodeStep: true]',
 'href': 'http://rundeck.server.com/execution/follow/123',
 'id': '123',
 'job': None,
 'status': 'running',
 'user': 'rundeckrun'}