Skip to content

Commit 430c2c9

Browse files
authored
Add notes for agent versions (#1151)
1 parent 2806db5 commit 430c2c9

File tree

4 files changed

+26
-2
lines changed

4 files changed

+26
-2
lines changed

content/terraform-docs-agents/v1.24.x/docs/cloud-docs/agents/agent-pools.mdx

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -86,6 +86,12 @@ The workspace begins using the agent for Terraform runs. Runs involving an agent
8686

8787
## Configure Stacks to use the agent
8888

89+
<Note>
90+
91+
Your agents must use v1.25.0 or above to execute Stack deployment runs. To learn more about agent versioning, refer to [Updates](/terraform/cloud-docs/agents/agents#updates).
92+
93+
</Note>
94+
8995
Use the following steps to configure a Stack to use an agent pool.
9096

9197
### Step 1: Manage existing runs

content/terraform-docs-agents/v1.25.x/docs/cloud-docs/agents/agent-pools.mdx

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -88,6 +88,12 @@ The workspace begins using the agent for Terraform runs. Runs involving an agent
8888

8989
## Configure Stacks to use the agent
9090

91+
<Note>
92+
93+
Your agents must use v1.25.0 or above to execute Stack deployment runs. To learn more about agent versioning, refer to [Updates](/terraform/cloud-docs/agents/agents#updates).
94+
95+
</Note>
96+
9197
Use the following steps to configure a Stack to use an agent pool.
9298

9399
### Step 1: Manage existing runs

content/terraform-docs-common/docs/cloud-docs/stacks/configure.mdx

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -46,9 +46,15 @@ Upstream Stacks must be in the same project as their downstream Stacks. Moving a
4646

4747
### Change execution mode
4848

49-
By default, HCP Terraform deploys infrastructure remotely using its own disposable virtual machines. This default execution mode is named **Remote** mode.
49+
By default, HCP Terraform deploys infrastructure remotely using its own disposable virtual machines. The default execution mode is called **Remote** mode. [HCP Terraform agents](/terraform/cloud-docs/agents/) let HCP Terraform communicate with isolated, private, or on-premises infrastructure.
5050

51-
[HCP Terraform agents](/terraform/cloud-docs/agents/) let HCP Terraform communicate with isolated, private, or on-premises infrastructure. After setting up an agent and an agent pool, you can choose to change a Stack's execution mode to **Agent** to have HCP Terraform execute your Stack runs on an agent. To learn more about setting up agents, refer to [Install and run agents](/terraform/cloud-docs/agents/agents).
51+
<Note>
52+
53+
Your HCP Terraform agent must use v1.25.0 or above to execute Stack deployment runs. To learn more about agent versioning, refer to [Updates](/terraform/cloud-docs/agents/agents#updates).
54+
55+
</Note>
56+
57+
After setting up an agent and an agent pool, you can choose to change a Stack's execution mode to **Agent** to have HCP Terraform execute your Stack runs on an agent. To learn more about setting up agents, refer to [Install and run agents](/terraform/cloud-docs/agents/agents).
5258

5359
## Next steps
5460

content/terraform-docs-common/docs/cloud-docs/stacks/runs.mdx

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,12 @@ HCP Terraform is designed as an execution platform for Terraform, and executes r
1515

1616
### Protecting private environments
1717

18+
<Note>
19+
20+
Your HCP Terraform agent must use v1.25.0 or above to execute Stack deployment runs. To learn more about agent versioning, refer to [Updates](/terraform/cloud-docs/agents/agents#updates).
21+
22+
</Note>
23+
1824
[HCP Terraform agents](/terraform/cloud-docs/agents/) let HCP Terraform communicate with isolated, private, or on-premises infrastructure. The agent polls HCP Terraform for any changes to your configuration and executes the changes locally, so you do not need to allow public ingress traffic to your resources. Agents let you control infrastructure in private environments without modifying your network perimeter. Note that [agent hooks](/terraform/cloud-docs/agents/hooks) do not support Stack workflows.
1925

2026
## Configuration versions

0 commit comments

Comments
 (0)