Select Badges

Select Supported Platforms

Select Status


tr-chef-cookbook-aws-ssm-agent (14) Versions 1.7.0

Installs current AWS SSM Agent

cookbook 'tr-chef-cookbook-aws-ssm-agent', '~> 1.7.0', :supermarket
cookbook 'tr-chef-cookbook-aws-ssm-agent', '~> 1.7.0'
knife supermarket install tr-chef-cookbook-aws-ssm-agent
knife supermarket download tr-chef-cookbook-aws-ssm-agent
Quality 33%


Installs the current AWS SSM agent on AWS Instances and in hybrid Environments.

The registration of an Instance in a hybrid Environment works only once. After
that, you have to remove the registration of the SSM Agent.

Supported OS

  • Ubuntu 14.04 + 16.04 + 18.04
  • CentOS 7
  • RHEL 7
  • Amazon Linux


  "tr-ssm-agent": {
    "activation-id": "",
    "activation-code": ""


The attributes used by this cookbook:

Attribute Description Type Default
activation-id Activation Code generated during Managed Instance Activation String nil
activation-code Activation Code generated during Managed Instance Activation String nil
region The region where the activation-code and -id are registered String nil
logpath Defines the full path including file for info logs String /var/log/amazon/ssm/amazon-ssm-agent.log
logerror Defines the full path including file for error logs String /var/log/amazon/ssm/errors.log
logtocwl Log directly to CloudWatch Logs String false



  • This recipe installs the current SSM Agent Version ## unix-mi
  • This recipe installs the current SSM Agent and Activates a Managed Instance (except Amazon Linux).

License and Authors

All rights reserved. This book or any portion thereof may not be reproduced or used in any manner whatsoever
without the express written permission of the publisher except for the use of brief quotations in a book review.

Dependent cookbooks

tr-chef-cookbook-aws-cli >= 0.0.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.


Version 1.7.0

  • Add seelog.xml to configure logging (AWSSSM-12)
  • Add configuration to push SSM logs to CloudWatch Logs

Version 1.6.1

  • Fixing Tests with several OS

Version 1.6.0

  • Updated README with currently supported and tested OS
  • Updating .kitchen.yml to current

Version 1.5.0

  • Adding support for OS with preinstalled snap packages

Version 1.4.0

  • Adding maximum version for Ubuntu

Version 1.3.0

  • Fixing unix-mi not to run with amazon linux
  • Adding InSpec tests

Version 1.2.1

  • Improve: Only register instance, if not already registered (AWSSSM-10)
  • Add support for Amazon Linux (AWSSSM-9)

Version 1.1.2

  • Always override activation on managed instance (AWSSSM-8)

Version 1.1.1

  • Adding Foodcritic

Version 1.1.0

  • Add support for external Instances which are not hosted within AWS (AWSSSM-4)
  • Add Support for rhel 7 (AWSSSM-7)
  • Add Support for centos 7 (AWSSSM-6)
  • Change Folders of downloads (AWSSSM-3)
  • Prepare for Multi OS Unix + Windows (AWSSSM-5)

Version 1.0.3

  • Changing issues_url (AWSSSM-2)

Version 1.0.2

  • Change folder for remote_file to tr-packages (AWSSSM-1)

Version 1.0.1

  • Updating README and metadata

Version 1.0.0

  • Adding Support for multiple OS
  • Adding Dependency for tecRacer Cookbook for AWS CLI

Version 0.1.9

  • Installs AWS SSM Agent - First Version

Collaborator Number Metric

1.7.0 failed this metric

Failure: Cookbook has 1 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

Foodcritic Metric

1.7.0 passed this metric