<commit_before>Threat Stack Ansible Role
=========

[![Build Status](https://travis-ci.org/threatstack/threatstack-ansible.svg?branch=master)][travis]

[travis]: https://travis-ci.org/threatstack/threatstack-ansible

Ansible Role to deploy the Threat Stack server agent.

[Threatstack @ Ansible Galaxy](https://galaxy.ansible.com/list#/roles/2875)


Platforms
---------

* Amazon Linux
* CentOS
* RedHat
* Ubuntu

Role Variables
--------------
	threatstack_deploy_key: 3306				# Required. Your Cloud Sight API Key
	threatstack_policy: "My Secure Policy"    	# The Agent's security policy (Defaults to 'Default Policy')
	threatstack_hostname: SparkServer1      	# The display hostname
	
Install
----------------
Using ansible galaxy:
	
	$ ansible-galaxy install apollocatlin.threatstack

To install into your playbook roles, use `-p ROLES_PATH` or `--path=ROLES_PATH`

	$ ansible-galaxy install apollocatlin.threatstack -p /your/project/root/roles

Its also worth reading how to install using a requirements.yml for a more advanced way to manage roled dependency on ansible host systems. [Advanced Control over Role Requirements Files](http://docs.ansible.com/galaxy.html#advanced-control-over-role-requirements-files)


Examples
----------------
1) Install Threat Stack agent with the default policy and reports system hostname to threatstack. This is the most basic configuration
	
	- hosts: all
      roles:
         - { role: threatstack-ansible, threatstack_deploy_key: XXXXXXXXXXXXX}

2) Install Threat Stack agent with custom security policy and custom hostname:

    - hosts: servers
      roles:
    	- role: threatstack-ansible
      	  threatstack_deploy_key: <KEY>
      	  threatstack_policy: "My Secure Policy"
      	  threatstack_hostname: SparkServer1

Dependencies
------------

None

License
-------

Apache 2.0

Author Information
------------------<commit_msg>readme update<commit_after>Threat Stack Ansible Role
=========

[![Build Status](https://travis-ci.org/threatstack/threatstack-ansible.svg?branch=master)][travis]

[travis]: https://travis-ci.org/threatstack/threatstack-ansible

Ansible Role to deploy the Threat Stack server agent.

[Threatstack @ Ansible Galaxy](https://galaxy.ansible.com/list#/roles/2875)


Platforms
---------

* Amazon Linux
* CentOS
* RedHat
* Ubuntu

Role Variables
--------------
	threatstack_deploy_key: 3306				# Required. Your Cloud Sight API Key
	threatstack_policy: "My Secure Policy"    	# The Agent's security policy (Defaults to 'Default Policy')
	threatstack_hostname: SparkServer1      	# The display hostname
	
Install
----------------
Using ansible galaxy, best for ad-hoc command situations:
	
	$ ansible-galaxy install apollocatlin.threatstack

To install into your playbook roles, use `-p ROLES_PATH` or `--path=ROLES_PATH`

	$ ansible-galaxy install apollocatlin.threatstack -p /your/project/root/roles

Its also worth reading how to install using a requirements.yml for a more advanced way to manage roled dependency on ansible host systems. [Advanced Control over Role Requirements Files](http://docs.ansible.com/galaxy.html#advanced-control-over-role-requirements-files)


Examples
----------------
1) Install Threat Stack agent with the default policy and reports system hostname to threatstack. This is the most basic configuration
	
	- hosts: all
      roles:
         - { role: apollocatlin.threatstack, threatstack_deploy_key: XXXXXXXXXXXXX}

2) Install Threat Stack agent with custom security policy and custom hostname:

    - hosts: servers
      roles:
    	- role: apollocatlin.threatstack
      	  threatstack_deploy_key: XXX<KEY>
      	  threatstack_policy: "My Secure Policy"
      	  threatstack_hostname: SparkServer1

Dependencies
------------

None

License
-------

Apache 2.0

Author Information
------------------
{'fraction_non_alphanumeric': 0.12444211079023365, 'fraction_numerical': 0.0073510107639800475, 'mean_word_length': 3.3002257336343117, 'pattern_counts': {'":': 0, '<': 5, '<?xml version=': 0, '>': 5, 'https://': 6, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 2, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '3446918', 'n_tokens_mistral': 1191, 'n_tokens_neox': 1101, 'n_words': 338}