Metadata-Version: 2.0
Name: ssmrun
Version: 0.1.2
Summary: Utilities for AWS EC2 SSM
Home-page: https://github.com/Fullscreen/ssmrun
Author: Fullscreen Devops
Author-email: devops@fullscreen.com
License: MIT license
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Requires-Dist: Click (>=6.0)
Requires-Dist: boto3 (>=1.3.1)

ssmrun
======

.. image:: https://img.shields.io/pypi/v/ssmrun.svg
    :target: https://pypi.python.org/pypi/ssmrun
    :alt: Latest PyPI version

.. image:: https://travis-ci.org/Fullscreen/ssmrun.png
   :target: https://travis-ci.org/Fullscreen/ssmrun
   :alt: Latest Travis CI build status


* GitHub: https://github.com/Fullscreen/ssmrun
* PyPI: https://pypi.python.org/pypi/ssmrun

Utilities for AWS EC2 SSM

* run commands
* list and show invocations

The aws-cli package works on Python versions:

* 2.6.5 and greater
* 2.7.x and greater


Installation
------------

Install via pip

    $ pip install ssmrun


Usage
-----

Run SSM Command:

.. code:: bash

  # Run on targets filtered by EC2 tag "Name"
  $ ssm run <docutment-name> <ec2-instances-name>

  # Run with SSM parameters
  $ ssm run <docutment-name> <ec2-instances-name> -P p1="v1" -P p2="v2"

  # Run and get status for each targeted instance
  $ ssm run <docutment-name> <ec2-instances-name> -s

  # Run and get command output for each targeted instance
  $ ssm run <docutment-name> <ec2-instances-name> -o

  # Run against instances in an auto scaling group
  $ ssm run <docutment-name> <asg-name> -k aws:autoscaling:groupName

  # Run against instances created via CloudFormation stack
  $ ssm run <docutment-name> <cfn-stack-name> -k aws:cloudformation:stack-name


List and Show SSM Command Invocations:

.. code:: bash

  # Show invocation
  $ ssm show <command-id>

  # Show invocation and targets status
  $ ssm show <command-id> -s

  # Show invocation and targets status and command output
  $ ssm show <command-id> -o

  # List command invocations
  $ ssm ls -n NUM

  # List command invocations and targets status
  $ ssm ls -s


List and Show SSM Documents:

.. code:: bash

  # List documents
  $ ssm docs

  # List documents with details
  $ ssm docs -l

  # Get document content
  $ ssm get <doc-name>


Authors
-------

`ssmrun` was written by `Fullscreen Devops <devops@fullscreen.com>`_.


