cloudposse/Atmos Affected Stacks
A GitHub Action to determine the affected stacks between two git refs
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Activelast commit Mar 31, 2026
- License
- Apache 2.0
Pinned Snippet
uses: cloudposse/github-action-atmos-affected-stacks@6ec66de8b44ba231ff7c2b572cdd4e1abdb3c14a # v6.13.0tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| head-ref | The head ref to checkout. If not provided, the head default branch is used. | no | ${{ github.sha }} |
| skip-checkout | Disable actions/checkout for head-ref and base-ref. Useful for when the checkout happens in a previous step and file are modified outside of git through other actions | no | false |
| default-branch | The default branch to use for the base ref. | no | ${{ github.event.repository.default_branch }} |
| base-ref | The base ref to checkout. If not provided, the head default branch is used. | no | — |
| install-atmos | Whether to install atmos | no | true |
| atmos-version | The version of atmos to install | no | >= 1.99.0 |
| atmos-config-path | The path to the atmos.yaml file | yes | — |
| atmos-pro-upload | Whether to upload affected stacks directly to Atmos Pro | no | false |
| atmos-pro-base-url | The base URL of Atmos Pro | no | https://atmos-pro.com |
| atmos-pro-token | The API token to allow Atmos Pro to upload affected stacks | no | "" |
| atmos-include-spacelift-admin-stacks | Whether to include the Spacelift admin stacks of affected stacks in the output | no | false |
| atmos-include-dependents | Whether to include dependents of affected stacks in the output | no | false |
| atmos-include-settings | Include the `settings` section for each affected component | no | false |
| atmos-stack | The stack to operate on | no | "" |
| identity | Atmos auth identity | no | "" |
| install-jq | Whether to install jq | no | false |
| jq-version | The version of jq to install if install-jq is true | no | 1.7 |
| jq-force | Whether to force the installation of jq | no | true |
| nested-matrices-count | Number of nested matrices that should be returned as the output (from 1 to 3) | no | 2 |
| process-functions | Whether to process atmos functions | no | true |
| process-templates | Whether to process atmos templates | no | true |
| skip-atmos-functions | Skip all Atmos functions such as terraform.output | no | false |
Outputs
| name | description |
|---|---|
| affected | The affected stacks |
| has-affected-stacks | Whether there are affected stacks |
| matrix | The affected stacks as matrix structure suitable for extending matrix size workaround (see README) |