Skip to content

Commit 023f4ef

Browse files
authored
Merge pull request #91 from kddejong/docs/readme/parameter-override
Add parameter override docs in the README
2 parents c30b875 + ab5d413 commit 023f4ef

File tree

1 file changed

+21
-1
lines changed

1 file changed

+21
-1
lines changed

README.md

Lines changed: 21 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,27 @@ Deploys AWS CloudFormation Stacks.
1818
1919
The action can be passed a CloudFormation Stack `name` and a `template` file. The `template` file can be a local file existing in the working directory, or a URL to template that exists in an [Amazon S3](https://aws.amazon.com/s3/) bucket. It will create the Stack if it does not exist, or create a [Change Set](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-changesets.html) to update the Stack. An update fails by default when the Change Set is empty. Setting `no-fail-on-empty-changeset: "1"` will override this behavior and not throw an error.
2020

21-
See [action.yml](action.yml) for the full documentation for this action's inputs and outputs.
21+
### Inputs
22+
23+
A few inputs are highlighted below. See [action.yml](action.yml) for the full documentation for this action's inputs and outputs.
24+
25+
#### parameter-overrides (OPTIONAL)
26+
27+
To override parameter values in the template you can provide a string or a file that is either local or an URL.
28+
29+
Override multiple parameters separated by commas: `"MyParam1=myValue1,MyParam2=myValue2"`
30+
31+
Override a comma delimited list: `"MyParam1=myValue1,MyParam1=myValue2"` or `MyParam1="myValue1,myValue2"`
32+
33+
Override parameters using a local JSON file: `"file:///${{ github.workspace }}/parameters.json"` with a file named `parameters.json` at the root of the repository:
34+
```json
35+
[
36+
{
37+
"ParameterKey": "MyParam1",
38+
"ParameterValue": "myValue1"
39+
}
40+
]
41+
```
2242

2343
> You can learn more about [AWS CloudFormation](https://aws.amazon.com/cloudformation/)
2444

0 commit comments

Comments
 (0)