Skip to content

Add information on the HCP Terraform Operator for Kubernetes to the agents documentation #1034

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 6 commits into from
Oct 7, 2025
Merged

Add information on the HCP Terraform Operator for Kubernetes to the agents documentation #1034

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
1395645
Add information on the HCP Terraform Operator for Kubernetes to the a…
BrianMMcClain Oct 2, 2025
4e7c1bb
Merge branch 'main' into agents-operator-callout
BrianMMcClain Oct 2, 2025
085ec06
Merge branch 'main' into agents-operator-callout
BrianMMcClain Oct 2, 2025
8094dde
Merge branch 'main' into agents-operator-callout
BrianMMcClain Oct 7, 2025
6b6267d
Merge branch 'main' into agents-operator-callout
BrianMMcClain Oct 7, 2025
47da661
Merge branch 'main' into agents-operator-callout
BrianMMcClain Oct 7, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions content/terraform-docs-agents/v1.25.x/docs/cloud-docs/agents/agent-pools.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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)

<Note>

Terraform Enterprise does not support Stacks. You can only scope agent pools to workspaces and projects in Terraform Enterprise.
Expand Down
4 changes: 4 additions & 0 deletions content/terraform-docs-agents/v1.25.x/docs/cloud-docs/agents/agents.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
Loading