Skip to content

Agent to enable remote management of your Amazon EC2 instance configuration.

License

Notifications You must be signed in to change notification settings

ZuZuD/amazon-ssm-agent

 
 

Repository files navigation

ReportCard Build Status

Amazon SSM Agent

The Amazon EC2 Simple Systems Manager (SSM) Agent is software developed for the Simple Systems Manager Service. The SSM Agent is the primary component of a feature called Run Command.

Overview

The SSM Agent runs on EC2 instances and enables you to quickly and easily execute remote commands or scripts against one or more instances. The agent uses SSM documents. When you execute a command, the agent on the instance processes the document and configures the instance as specified. Currently, the SSM Agent and Run Command enable you to quickly run Shell scripts on an instance using the AWS-RunShellScript SSM document.

Verify Requirements

SSM Run Command Prerequisites

Setup

Executing Commands

SSM Run Command Walkthrough Using the AWS CLI

Troubleshooting

Troubleshooting SSM Run Command

Feedback

Thank you for helping us to improve SSM and Run Command. Please send your questions or comments to: ec2-ssm-feedback@amazon.com

Building and Running from source

sudo yum install -y rpmdevtools rpm-build
  • Cross Complile SSM Agent

  • Run make build to build the SSM Agent for Linux, Debian, Windows environment.

  • Run make release to build the agent and also packages it into a RPM, DEB and ZIP package.

The following folders are generated when the build completes:

bin/debian_386
bin/debian_amd64
bin/linux_386
bin/linux_amd64
bin/windows_386
bin/windows_amd64

Please follow the user guide to copy and install the SSM Agent

Code Layout

  • Source code is under agent/
  • Vendor package source code is under vendor/src
  • rpm and dpkg artifacts are under packaging
  • build scripts are under Tools/src

GOPATH

To use vendor dependencies, the suggested GOPATH format is :<packagesource>/vendor:<packagesource>

Make Targets

The following targets are available. Each may be run with make <target>.

Make Target Description
build (Default) build builds the agent for Linux, Debian and Windows amd64 and 386 environment
release release checks code style and coverage, builds the agent and also packages it into a RPM, DEB and ZIP package
package package packages build result into a RPM, DEB and ZIP package
pre-build pre-build goes through Tools/src folder to make sure all the script files are executable
checkstyle checkstyle runs the checkstyle script
quick-integtest quick-integtest runs all tests tagged with integration using go test
quick-test quick-test runs all the tests including integration and unit tests using go test`
coverage coverage runs all tests and calculate code coverage
build-linux build-linux builds the agent for execution in the Linux amd64 environment
build-windows build-windows builds the agent for execution in the Windows amd64 environment
build-darwin build-darwin builds the agent for execution in the Darwin amd64 environment
build-linux-386 build-linux-386 builds the agent for execution in the Linux 386 environment
build-windows-386 build-windows-386 builds the agent for execution in the Windows 386 environment
build-darwin-386 build-darwin-386 builds the agent for execution in the Darwin 386 environment
create-rpm create-rpm builds the agent and packages it into a RPM package for Linux amd64 based distributions
create-deb create-deb builds the agent and packages it into a DEB package Debian amd64 based distributions
create-win create-win builds the agent and packages it into a ZIP package Windows amd64 based distributions
create-rpm-386 create-rpm-386 builds the agent and packages it into a RPM package for Linux 386 based distributions
create-deb-386 create-deb-386 builds the agent and packages it into a DEB package Debian 386 based distributions
create-win-386 create-win-386 builds the agent and packages it into a ZIP package Windows 386 based distributions
create-linux-package create-linux-package create update packages for Linux and Debian based distributions
create-windows-package create-windows-package create update packages for Windows based distributions
get-tools get-tools gets gocode and oracle using go get
clean clean removes build artifacts.

Contributing

Contributions and feedback are welcome! Proposals and Pull Requests will be considered and responded to. Please see the CONTRIBUTING.md file for more information.

Amazon Web Services does not currently provide support for modified copies of this software.

License

The Amazon SSM Agent is licensed under the Apache 2.0 License.

About

Agent to enable remote management of your Amazon EC2 instance configuration.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 97.1%
  • Shell 1.7%
  • Other 1.2%