You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
# List any related terraform modules that this module may be used with or that this module depends on.
27
30
related: []
28
31
29
32
description: This Github Action is used to run Terraform plan for a single, Atmos-supported component and save the given planfile to S3 and DynamoDB.
@@ -62,15 +65,15 @@ usage: |-
62
65
> If you are using `atmos < 1.63.0` please use `v1` version of this action.
63
66
64
67
The action expects the atmos configuration file `atmos.yaml` to be present in the repository.
65
-
68
+
66
69
The action supports AWS and Azure to store Terraform plan files.
67
70
You can read more about plan storage in the [cloudposse/github-action-terraform-plan-storage](https://github.com/cloudposse/github-action-terraform-plan-storage?tab=readme-ov-file#aws-default) documentation.
68
71
Depending on the cloud provider, the following fields should be set in the `atmos.yaml`:
This action supports [OpenTofu](https://opentofu.org/).
151
-
154
+
152
155
> [!IMPORTANT]
153
156
> **Please note!** OpenTofu supported by Atmos `>= 1.73.0`.
154
157
> For details [read](https://atmos.tools/core-concepts/projects/configuration/opentofu/)
155
-
158
+
156
159
To enable OpenTofu add the following settings to `atmos.yaml`
157
160
* Set the `opentofu-version` in the `atmos.yaml` to the desired version
158
161
* Set `components.terraform.command` to `tofu`
159
-
162
+
160
163
#### Example
161
-
164
+
162
165
```yaml
163
-
166
+
164
167
components:
165
168
terraform:
166
169
command: tofu
167
-
170
+
168
171
...
169
-
172
+
170
173
integrations:
171
174
github:
172
175
gitops:
@@ -208,13 +211,13 @@ usage: |-
208
211
```
209
212
210
213
### Migrating from `v4` to `v5`
211
-
214
+
212
215
The notable changes in `v5` are:
213
216
- `v5` works only with `atmos >= 1.158.0`
214
217
- `v5` supports atnos `templates` and `functions`
215
-
218
+
216
219
### Migrating from `v3` to `v4`
217
-
220
+
218
221
The notable changes in `v4` are:
219
222
220
223
- `v4` works only with `atmos >= 1.99.0`
@@ -226,7 +229,7 @@ usage: |-
226
229
The only required migration step is updating atmos version to `>= 1.99.0`
227
230
228
231
### Migrating from `v2` to `v3`
229
-
232
+
230
233
The notable changes in `v3` are:
231
234
232
235
- `v3` use `actions/upload-artifact@v4` to share artifacts so it is not compatible with `cloudposse/github-action-atmos-terraform-drift-detection` `< v2.0.0`
@@ -236,23 +239,23 @@ usage: |-
236
239
No special migration steps required
237
240
238
241
### Migrating from `v1` to `v2`
239
-
242
+
240
243
The notable changes in `v2` are:
241
244
242
245
- `v2` works only with `atmos >= 1.63.0`
243
246
- `v2` drops `install-terraform` input because terraform is not required for affected stacks call
244
247
- `v2` drops `atmos-gitops-config-path` input and the `./.github/config/atmos-gitops.yaml` config file. Now you have to use GitHub Actions environment variables to specify the location of the `atmos.yaml`.
245
-
248
+
246
249
The following configuration fields now moved to GitHub action inputs with the same names
247
-
250
+
248
251
| name |
249
252
|-------------------------|
250
253
| `atmos-version` |
251
254
| `atmos-config-path` |
252
-
253
-
255
+
256
+
254
257
The following configuration fields moved to the `atmos.yaml` configuration file.
And the `v1` GitHub Action Workflow looked like this.
324
-
327
+
325
328
`.github/workflows/main.yaml`
326
329
```yaml
327
330
- name: Plan Atmos Component
@@ -333,7 +336,7 @@ usage: |-
333
336
```
334
337
335
338
### Migrating from `v1` to `v2`
336
-
339
+
337
340
1. `v2` drops the `component-path` variable and instead fetches if directly from the [`atmos.yaml` file](https://atmos.tools/cli/configuration/) automatically. Simply remove the `component-path` argument from your invocations of the `cloudposse/github-action-atmos-terraform-plan` action.
338
341
2. `v2` moves most of the `inputs` to the Atmos GitOps config path `./.github/config/atmos-gitops.yaml`. Simply create this file, transfer your settings to it, then remove the corresponding arguments from your invocations of the `cloudposse/github-action-atmos-terraform-plan` action.
339
342
| name |
@@ -348,10 +351,10 @@ usage: |-
348
351
| `terraform-version` |
349
352
| `aws-region` |
350
353
| `enable-infracost` |
351
-
352
-
354
+
355
+
353
356
If you want the same behavior in `v2` as in `v1` you should create config `./.github/config/atmos-gitops.yaml` with the same variables as in `v1` inputs.
0 commit comments