Skip to main content

Terraform Cloud now supports assigning agent pools at the organization level

Assigning agents at the organization level provides a faster, more consistent, and scalable approach to agent pool configuration.

We are excited to announce the general availability of an organization-wide default execution mode; a new agent configuration method for HashiCorp Terraform Cloud that’s also coming soon to Terraform Enterprise.

Terraform Cloud facilitates the management and deployment of agents within secure, isolated network environments. With the introduction of self-hosted agents in Terraform Cloud, it became possible to deploy them in pools, creating a flexible architecture that allows a single organization to manage infrastructure across multiple private network segments.

»Manual assignment challenges

Previously, the assignment of agent pools could be configured only at the workspace level. This was a multi-step process that required users to scope the agent pool to make it accessible to some or all workspaces in the organization, and then individually configure the desired workspaces to use the agent pool. This manual process was time-consuming, error-prone, and lacked scalability. It also introduced self-service challenges with the no-code provisioning workflow. In environments where self-hosted agents are required, the initial provisioning run would always fail until the new workspace was updated to use an agent pool.

»Introducing agent pools at the organization level

Terraform Cloud users can now set a default execution mode at the organization level. Users with organization owner permissions can specify a default agent pool using this setting and any future workspace created within the organization will automatically adopt it. Note that to avoid unintended disruptions with this new capability, all existing workspaces retain their current execution mode. Team members with workspace admin permissions can break the inheritance by reassigning their workspaces to a different agent pool based on their specific requirements. This approach fosters a self-service model and enables consistent agent pool assignment within an organization.

Set the default execution mode from the Organization Settings menu.

Set the default execution mode from the Organization Settings menu.

Workspace admins can override the organization's default execution mode if needed.

Workspace admins can override the organization's default execution mode if needed.

»Benefits of assigning agent pools at the organization level

Assigning agent pools at the organization level provides several advantages including:

»Speed

Manually assigning agent pools to workspaces can be a multi-step, time-consuming task, especially when dealing with a large number of workspaces. This new feature streamlines the process to save time and improve the overall effectiveness of the infrastructure management system.

»Consistency

Manual assignments can result in inconsistencies in agent pool configurations across workspaces, which can pose security risks for organizations. Assigning agent pools at the organization level can help mitigate this risk by reducing the chance of human errors such as assigning the wrong agent pool or overlooking certain workspaces.

»Scalability

As the number of workspaces grows over time, manually managing agent pool assignments can become increasingly complex. This new mechanism to preconfigure agent pool mappings lifts the burden from the application team to manually select the appropriate agent pool for future workspaces, improving efficiency as the organization scales.

»Getting started

To learn more about assigning a default agent pool to your organization, check out the Terraform workspace setting documentation.

Get started with Terraform Cloud for free to begin provisioning and managing your infrastructure in any environment. Link your Terraform Cloud and HashiCorp Cloud Platform (HCP) accounts together for a seamless sign-in experience.


Sign up for the latest HashiCorp news

By submitting this form, you acknowledge and agree that HashiCorp will process your personal information in accordance with the Privacy Policy.