Skip to content

Commit 38c9ea2

Browse files
terraform 1.14 actions GA (#1288)
Do not merge until Nov 19. This PR removes beta language and text in Terraform language and HCP Terraform docs for the GA of the ability to invoke actions per https://hashicorp.atlassian.net/browse/IPE-1289.
2 parents 46d98f0 + 43d5a4d commit 38c9ea2

File tree

8 files changed

+19
-38
lines changed

8 files changed

+19
-38
lines changed

content/terraform-docs-common/docs/cloud-docs/api-docs/run.mdx

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -98,6 +98,7 @@ The run operation specifies the Terraform execution mode. You can reference the
9898
| `refresh_only` | The run should update Terraform state, but not make changes to resources. |
9999
| `destroy` | The run should destroy all objects, regardless of configuration changes. |
100100
| `empty_apply` | The run should perform an apply with no changes to resources. This is most commonly used to [upgrade terraform state versions](/terraform/cloud-docs/workspaces/state#upgrading-state). |
101+
| `action_only` | The run is a `refresh_only` run that contains at least one [action invocation](/terraform/plugin/framework/actions). It updates state but does not create, change, or destroy resources. |
101102

102103
### Run Sources
103104

content/terraform-docs-common/docs/cloud-docs/workspaces/run/manage.mdx

Lines changed: 13 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -25,14 +25,23 @@ Click a run to go to its details page. The details page contains the following i
2525
- A timeline of events related to the run.
2626
- The output from both the `terraform plan` and `terraform apply` commands, if applicable. This output defaults to visible if the command is currently running and hidden if the command has finished.
2727

28+
<!-- BEGIN: TFC:only name:actions -->
29+
2830
### Action runs
2931

30-
@include 'beta.mdx'
32+
HCP Terraform identifies runs that invoke actions on the run details page. Actions are preset operations built into providers that you can invoke to trigger automations outside of Terraform, such as Ansible playbooks and Lambda jobs. Refer to [Invoke an action](/terraform/language/invoke-actions) in the Terraform configuration language documentation for more information.
33+
34+
HCP Terraform indicates how many actions the run invoked and adds **action:** labels to the **Plan** operation output and **Invoked:** labels to the **Apply** operation output.
35+
36+
You can invoke actions either as part of a resource lifecycle configuration or manually target a specific action using the `-invoke` flag to a `terraform apply` or `terraform plan` command.
37+
38+
<Note>
39+
40+
A Standard tier subscription is required to use the `-invoke` flag to execute an action and to view details about action runs that were invoked from the command line using the `-invoke` flag. Refer to the [Terraform pricing page](https://www.hashicorp.com/en/pricing?tab=terraform) for more information.
3141

32-
If a run invokes an action that is triggered as part of a resource lifecycle, HCP Terraform identifies them on the run details page. HCP Terraform indicates how many actions the run invoked and adds **action:** labels to the **Plan** operation output and **Invoked:** labels to the **Apply** operation output.
42+
</Note>
3343

34-
Actions are preset operations built into providers that you can invoke to trigger automations outside of Terraform, such as Ansible playbooks and Lambda jobs. Refer to [Invoke an action](/terraform/language/v1.14.x/invoke-actions) in the Terraform configuration language documentation for more information.
35-
44+
<!-- END: TFC:only name:actions -->
3645

3746
## Interacting with Runs
3847

content/terraform/v1.13.x/docs/cli/commands/apply.mdx

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -11,12 +11,6 @@ plan.
1111

1212
> **Hands On:** Try the [Apply Terraform Configuration](/terraform/tutorials/cli/apply?utm_source=WEBSITE&utm_medium=WEB_IO&utm_offer=ARTICLE_PAGE&utm_content=DOCS) tutorial to learn how Terraform applies a configuration, how Terraform recovers from errors during apply, and common ways to use this command.
1313
14-
<Note>
15-
16-
Terraform `v1.14.x (beta)` adds the `-invoke` flag, which lets you trigger actions outside of Terraform CRUD operations. Refer to the [Invoke an action](/terraform/language/v1.14.x/invoke-actions) beta documentation for more information.
17-
18-
</Note>
19-
2014
## Usage
2115

2216
Usage: `terraform apply [options] [plan file]`

content/terraform/v1.13.x/docs/cli/commands/plan.mdx

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -10,12 +10,6 @@ description: >-
1010
The `terraform plan` command creates an execution plan, which lets you preview
1111
the changes that Terraform plans to make to your infrastructure.
1212

13-
<Note>
14-
15-
Terraform `v1.14.x (beta)` adds the `-invoke` flag, which lets you trigger actions outside of Terraform CRUD operations. Refer to the [Invoke an action](/terraform/language/v1.14.x/invoke-actions) beta documentation for more information.
16-
17-
</Note>
18-
1913
## Introduction
2014

2115
By default, Terraform performs the following operations when it creates a plan:

content/terraform/v1.13.x/docs/language/block/resource.mdx

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -8,12 +8,6 @@ description: >-
88

99
The `resource` block defines a piece of infrastructure and specifies the settings for Terraform to create it with. The arguments that an individual resource supports are determined by the provider. Refer to the provider documentation for more information about specific resource configuration.
1010

11-
<Note>
12-
13-
Terraform `v1.14.x (beta)` supports the `action_trigger` block, which you can add to resource configurations to trigger actions outside of Terraform CRUD operations. Refer to the [Invoke an action](/terraform/language/v1.14.x/invoke-actions) beta documentation for more information.
14-
15-
</Note>
16-
1711
## Configuration model
1812

1913
The `resource` block supports the following arguments:

content/terraform/v1.13.x/docs/language/meta-arguments/index.mdx

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -9,12 +9,6 @@ Meta-arguments are a class of arguments built into the Terraform configuration l
99

1010
The provider developer determines resource-specific arguments, but all resources support meta-arguments that let you manage resources' infrastructure lifecycle, including destruction behavior, preventing destruction, and establishing dependencies between resources. Terraform provides the following meta-arguments.
1111

12-
<Note>
13-
14-
Terraform `v1.14.x (beta)` adds the `action_trigger` meta-argument, which lets you trigger actions that extend Terraform CRUD operations. Refer to the [Invoke an action](/terraform/language/v1.14.x/invoke-actions) beta documentation for more information.
15-
16-
</Note>
17-
1812
## `depends_on`
1913

2014
The `depends_on` meta-argument instructs Terraform to complete all actions on the dependency object, including `read` operations, before performing actions on the object declaring the dependency. Use the `depends_on` argument to explicitly set the order in which Terraform creates resources. Refer to the [`depends_on` reference](/terraform/language/meta-arguments/depends_on) for details.

content/terraform/v1.14.x/data/language-nav-data.json

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -409,8 +409,7 @@
409409
"routes": [
410410
{
411411
"title": "Overview",
412-
"path": "meta-arguments",
413-
"alias": "actions"
412+
"path": "meta-arguments"
414413
},
415414
{
416415
"title": "count",
@@ -426,7 +425,8 @@
426425
},
427426
{
428427
"title": "lifecycle",
429-
"path": "meta-arguments/lifecycle"
428+
"path": "meta-arguments/lifecycle",
429+
"alias": "actions"
430430
},
431431
{
432432
"title": "provider",

content/terraform/v1.14.x/docs/language/invoke-actions.mdx

Lines changed: 2 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -7,19 +7,14 @@ description: Learn how to invoke actions defined in Terraform configuration lang
77

88
Actions are preset operations built into providers that let Terraform perform day-two operations. Invoke actions to trigger automations outside of Terraform, such as Ansible playbooks and Lambda jobs. Actions do not affect resource state.
99

10-
@include 'beta.mdx'
11-
1210
## Overview
1311

1412
Declare an `action` block in your Terraform configuration and apply your configuration or use the Terraform CLI to invoke the action. You can configure actions that aren't directly associated with a resource. These actions don't change the state of resources managed by Terraform.
1513

1614
## Requirements
1715

18-
Provider authors implement actions for them to be available. To check for actions available in your provider, refer to the provider documentation. Actions are available in the following providers on the Terraform Registry:
16+
Provider develoeprs must implement actions for them to be available. Refer to the provider documentation for information about actions that may be available in your provider.
1917

20-
- [aws](https://registry.terraform.io/providers/hashicorp/aws/latest)
21-
- [azurerm](https://registry.terraform.io/providers/hashicorp/azurerm/latest)
22-
2318
### HCP Terraform
2419

2520
To monitor actions in HCP Terraform, you must configure a connection to HCP Terraform in your Terraform configuration. Refer to [Connect to HCP Terraform](/terraform/cli/cloud/settings) for instructions.
@@ -128,4 +123,4 @@ Because the `event` argument includes `after_update`, Terraform also updates th
128123

129124
## View actions in HCP Terraform
130125

131-
If your workspace is connected to your HCP Terraform organization, you can monitor action runs in HCP Terraform. Refer to [Action runs](/terraform/cloud-docs/run/manage#action-runs) in the HCP Terraform documentation for more information.
126+
If your workspace is connected to your HCP Terraform organization, you can monitor action runs in HCP Terraform. Refer to [Action runs](/terraform/cloud-docs/workspaces/run/manage#action-runs) in the HCP Terraform documentation for more information.

0 commit comments

Comments
 (0)