From 1395645e01999f92f891acaaad383a3439a4847f Mon Sep 17 00:00:00 2001 From: Brian McClain Date: Wed, 1 Oct 2025 23:17:00 -0400 Subject: [PATCH] Add information on the HCP Terraform Operator for Kubernetes to the agents documentation --- .../v1.25.x/docs/cloud-docs/agents/agent-pools.mdx | 2 ++ .../v1.25.x/docs/cloud-docs/agents/agents.mdx | 4 ++++ 2 files changed, 6 insertions(+) diff --git a/content/terraform-docs-agents/v1.25.x/docs/cloud-docs/agents/agent-pools.mdx b/content/terraform-docs-agents/v1.25.x/docs/cloud-docs/agents/agent-pools.mdx index 3ca3506a3d..5a251bc032 100644 --- a/content/terraform-docs-agents/v1.25.x/docs/cloud-docs/agents/agent-pools.mdx +++ b/content/terraform-docs-agents/v1.25.x/docs/cloud-docs/agents/agent-pools.mdx @@ -8,6 +8,8 @@ description: >- HCP Terraform organizes agents into agent pools. An agent pool represents a group of agents that lets HCP Terraform communicate with isolated, private, or on-premises infrastructure. When you configure a workspace or Stack to execute runs using agents, any available agent in that workspace or Stack's associated agent pool can complete the run. +This topic describes how to manually manage agent pools in HCP Terraform. For information on how to manage agent pools as part of your Kubernetes infrastructure, refer to the [HCP Terraform Operator for Kubernetes overview](/terraform/cloud-docs/integrations/kubernetes) + Terraform Enterprise does not support Stacks. You can only scope agent pools to workspaces and projects in Terraform Enterprise. diff --git a/content/terraform-docs-agents/v1.25.x/docs/cloud-docs/agents/agents.mdx b/content/terraform-docs-agents/v1.25.x/docs/cloud-docs/agents/agents.mdx index 3e10d1366c..9e38c9ad02 100644 --- a/content/terraform-docs-agents/v1.25.x/docs/cloud-docs/agents/agents.mdx +++ b/content/terraform-docs-agents/v1.25.x/docs/cloud-docs/agents/agents.mdx @@ -75,6 +75,10 @@ export TFC_AGENT_NAME=your-agent-name ``` Once complete, your agent and its status appear on the **Agents** page in the HCP Terraform UI. Workspaces can now use this agent pool for runs. Refer to [Configure Workspaces to Use the Agent](/terraform/cloud-docs/agents/agent-pools#configure-workspaces-to-use-the-agent) for details. +## Run agents with the HCP Terraform Operator for Kubernetes + +The HCP Terraform Operator for Kubernetes allows you to create, manage, and automatically scale agents and agent pools as part of your Kubernetes infrastructure. For more information, refer to the [HCP Terraform Operator for Kubernetes overview](/terraform/cloud-docs/integrations/kubernetes). For instructions on how to install the operator, refer to [Set up the HCP Terraform Operator for Kubernetes](/terraform/cloud-docs/integrations/kubernetes/setup). + ## Optional configuration The optional configurations for customizing the agent include building a custom Docker image that grants sudo privileges for software installation, running in single-execution mode to process a single workload before terminating, and enabling request forwarding for secure access to private resources.