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.
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.
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.
Workspace admins can override the organization's default execution mode if needed.
Assigning agent pools at the organization level provides several advantages including:
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.
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.
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.
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.
Streamlined run task reviews provide meaningful context on run task evaluations to help practitioners resolve issues faster without having to leave Terraform Cloud.
No-code provisioning adds more Day 2 operations. Users can now update the module version used in their no-code workspaces.
Terraform Enterprise now supports more flexible deployment options for self-hosted environments, including cloud-managed Kubernetes services.