What happens when a workspace references a deprecated module version?

When you run Terraform apply on a workspace that references a deprecated module version, the run will display a warning in the UI indicating that you're using a deprecated version and should upgrade to a newer version. The workspace will still function, but the warning provides visibility into technical debt.

How do administrators identify which workspaces are affected by a module deprecation?

Administrators can use the Explorer window to run queries that find all workspaces referencing a specific deprecated module version. These queries can be saved as views for future reference and used to create change requests that notify the appropriate teams.

Module Lifecycle Management in Terraform Cloud

Name: Module Lifecycle Management in Terraform Cloud
Uploaded: 2026-04-09T16:51:48-04:00
Duration: 3 min 12 s
Description: TL;DR Module lifecycle management in Terraform Cloud solves the problem of uncoordinated module updates that cause workspace failures and create security risks when module authors delete versions without notifying consumers. The feature provides visibi...

HashiCorp

04/09/2026

0 (0%)

Report Like Favorite

Transcript

of modules. Now, if a module author simply deletes a module version from the private registry without proactively notifying the module consumer, their workspace would fail and require manual intervention to update module references later. This can be a security and compliance issue. In this video, we'll introduce module lifecycle management that provides visibility with save views, improves communication with change requests and notifications, and gives control with deprecation. First, let's go over team notifications. Here, I have a team already set up and I'm going to create notifications and enable them for all team members and all workspace events. Next, I'll go to the registry and go to my Terraform module that creates a VPC resources on AWS and deprecate the current module version. In this case, we want to deprecate the module because there's a newer version available. Once the module is deprecated, I go to my terminal and run Terraform apply. The config file here references the deprecated version of the module. Now, if I go back and refresh the UI and look at the run that I just triggered via the CLI, there is going to be a warning displayed that indicates that I'm referencing a deprecated version of the module and to upgrade to a newer version. As an admin, I can go to the Explorer window and run a query to find all workspaces that reference the module version that was deprecated. I can also save this view and call it deprecated module workspaces for future reference. You'll see the view that I just created along with the others that I previously created in this window. You'll see under the saved views tab, I can now create a change request right from here to communicate infrastructure lifecycle events such as module deprecation, drift remediation, provider upgrades, and infrastructure changes. Change requests combined with team notifications ensures that all requests always get to the right owners proactively. As you can see here, module consumers receive an email notification asking them to upgrade to a newer version. And clicking on that tab there brings them back to the workspace that needs to be updated.

TL;DR

Module lifecycle management in Terraform Cloud solves the problem of uncoordinated module updates that cause workspace failures and create security risks when module authors delete versions without notifying consumers.
The feature provides visibility through saved views that query which workspaces use specific module versions, communication via team notifications and change requests, and control through formal deprecation workflows.
When a module version is deprecated, workspace runs display warnings prompting upgrades, and administrators can create change requests that automatically notify affected team members with direct links to workspaces needing updates.

Summary

This demonstration introduces module lifecycle management capabilities in Terraform Cloud, addressing a critical operational challenge for organizations managing hundreds of infrastructure modules. When module authors delete or update module versions without coordinated communication, downstream workspaces can fail unexpectedly, creating security and compliance risks that require manual intervention. HashiCorp's solution provides three core capabilities: visibility through saved views that allow administrators to query and track which workspaces reference specific module versions, communication through team notifications and change requests that proactively alert module consumers to deprecations and required upgrades, and control through formal deprecation workflows that warn users when they reference outdated modules. The walkthrough demonstrates the complete workflow from deprecating a Terraform AWS VPC module, triggering warnings in workspace runs, creating saved queries to identify affected workspaces, and generating change requests that automatically notify team members via email with direct links to workspaces requiring updates. This systematic approach transforms ad-hoc module management into a governed process that reduces operational overhead while improving security posture.

Chapters

0:00 - Introduction
0:43 - Team Notifications Setup
0:59 - Module Deprecation Workflow
1:48 - Saved Views and Queries
2:18 - Change Requests

Key Quotes

0:14 "... if a module author simply deletes a module version from the private registry without proactively notifying the module consumer, their workspace would fail and require manual intervention to update module references later ..."
0:27 "This can be a security and compliance issue ..."
0:33 "... module lifecycle management that provides visibility with save views, improves communication with change requests and notifications, and gives control with deprecation ..."

Categories:

Tags:

Show more Show less

Browse videos

Upcoming Webinar Calendar

10/28/2026

01:00 AM

10/28/2026

Ensuring AI Security Across the APAC Region

https://www.truthinit.com/index.php/channel/2125/ensuring-ai-security-across-the-apac-region/
10/28/2026

06:00 AM

10/28/2026

EMEA: Ensuring AI Security Across All Platforms

https://www.truthinit.com/index.php/channel/2127/emea-ensuring-ai-security-across-all-platforms/
10/28/2026

01:00 PM

10/28/2026

Securing AI Across the Americas: Strategies for Comprehensive Protection

https://www.truthinit.com/index.php/channel/2126/securing-ai-across-the-americas-strategies-for-comprehensive-protection/
10/28/2026

01:00 PM

10/28/2026

EnvZero: Near-Zero Time to Resolution--Live Agentic Remediation for Failed and Drifted Infrastructure

https://www.truthinit.com/index.php/channel/2179/envzero-near-zero-time-to-resolution-live-agentic-remediation-for-failed-and-drifted-infrastructure/
11/04/2026

11:00 AM

11/04/2026

Aligning Agentic Intent: Understanding Your Agents' True Potential and Performance

https://www.truthinit.com/index.php/channel/2158/aligning-agentic-intent-understanding-your-agents-true-potential-and-performance/
11/05/2026

02:00 PM

11/05/2026

Reclaim Your Evenings: Leverage Data Intelligence to Minimize Risk and Boost AI Adoption

https://www.truthinit.com/index.php/channel/2172/reclaim-your-evenings-leverage-data-intelligence-to-minimize-risk-and-boost-ai-adoption/
11/10/2026

01:00 PM

11/10/2026

Zendesk: From AI Readiness to Results: A Framework for Transforming IT Service

https://www.truthinit.com/index.php/channel/2191/zendesk-from-ai-readiness-to-results-a-framework-for-transforming-it-service/
11/10/2026

01:00 PM

11/10/2026

Agentic Shopping and Muse: Insights for the 2026 Holiday Season

https://www.truthinit.com/index.php/channel/2219/agentic-shopping-and-muse-insights-for-the-2026-holiday-season/
11/12/2026

01:00 PM

11/12/2026

Leaving VMware Means Leaving vSAN: Your VMware Exit Is Really a Storage Decision

https://www.truthinit.com/index.php/channel/2192/leaving-vmware-means-leaving-vsan-your-vmware-exit-is-really-a-storage-decision/
11/19/2026

01:00 PM

11/19/2026

Securing the Microsoft Enterprise: Strengthening Configuration Management, Identity Security, and Data Protection

https://www.truthinit.com/index.php/channel/2076/securing-the-microsoft-enterprise-strengthening-configuration-management-identity-security-and-data-protection/
11/19/2026

01:00 PM

11/19/2026

Zendesk Deep Dive: Get the work done faster with Employee Service AI Agents

https://www.truthinit.com/index.php/channel/2181/zendesk-deep-dive-get-the-work-done-faster-with-employee-service-ai-agents/
01/19/2027

02:00 PM

01/19/2027

HUMAN Dialogue: Embracing the Rise of the Empowered AI Consumer.

https://www.truthinit.com/index.php/channel/2160/human-dialogue-embracing-the-rise-of-the-empowered-ai-consumer/