bottlerocket-os / bottlerocket-os/bottlerocket-project-website

Document SSM agent limitations

Open
#261 0 comments 0 reactions 0 assignees View on GitHub
faq-item help wanted
Dominant language
HTML
Stars
12
Forks
21
Avg merge
22h 57m
Merged PRs (30d)
6

Description

**What I'd like:**

The AWS variants include the SSM agent for accessing the console interface and retrieving node information. There are additional commands users can run via the `aws ssm` command line. Some of these commands are relevant for Bottlerocket and some are not.

`AWS-UpdateSSMAgent` is one that doesn't work since Bottlerocket does not allow packages to be updated for a running instance. There are likely more. `AWS-RunPatchBaseline` appears to be another one.

Rather than leaving it up to our users to figure out what works and what doesn't, we should provide some documentation that lets users know what to expect. This doesn't need to be an exhaustive list of SSM agent commands. That is better documented elsewhere. But we should at least point out some of the main commands or type of commands that users should be aware are not relevant when working with Bottlerocket.

Contributor guide

Open the contributing guide

Research direction

No target file or test is named. Start by locating the website's existing Bottlerocket and SSM documentation, then document representative commands such as AWS-UpdateSSMAgent and AWS-RunPatchBaseline that are not relevant, along with the command categories users should treat cautiously; done means users can understand the main limitations without an exhaustive command list.

Written by the indexing model from the issue text.

Assessment

Tech stack
aws
Domain
cloud, documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.