mercurytechnologies/aws-ssm-send-command-action
GitHub Action for sending commands to AWS Systems Manager. It is a wrapper around the [SendCommand](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_SendCommand.html) API call together with some additional features like waiting for the command to finish and printing logs of failed command invocations.
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Stale
- License
- None
Inputs
| name | description | required | default |
|---|---|---|---|
| document-name | The name of the AWS Systems Manager document (SSM document) to run. This can be a public document or a custom document. To run a shared document belonging to another account, specify the document Amazon Resource Name (ARN). | yes | — |
| targets | The targets to send the command to. Must be a JSON string of type `{Key: string, Values: string[]}[]`. * `Key=InstanceIds,Values=instance-id-1,instance-id-2,instance-id-3` * `Key=tag:tag-key,Values=tag-value-1,tag-value-2` * `Key=resource-groups:Name,Values=resource-group-name` | yes | — |
| parameters | The parameters to pass to the document, if any. Must be a JSON string of type `Record<string, string[]>` | no | — |
| wait-until-command-executed | Whether to wait until the command has been executed | no | false |
| max-wait-time | The maximum time to wait for the command to finish | no | 600 |
| log-failed-command-invocations | Whether to print logs of failed command invocations. If the command target is targeting hundreds or thousands of instances, this can be expensive and slow. | no | false |
Outputs
| name | description |
|---|---|
| command-id | The ID of the command that was sent |