Skip to main content

Workflow to Unlock Development Cluster Terraform State

Issue

A state lock may prevent destruction of a development cluster, e.g.:

Error: Error acquiring the state lock
│ 
│ Error message: operation error S3: PutObject, https response error
│ StatusCode: 412, RequestID: XXX, HostID: YYY,
│ api error PreconditionFailed: At least one of the pre-conditions you
│ specified did not hold
│ Lock Info:
│   ID:        9dc214a6-95d5-6428-11aa-50cb0e86a491
│   Path:      modernisation-platform-terraform-state/environments/members/cloud-platform/network/cp-lock-deletion-test/terraform.tfstate
│   Operation: OperationTypeApply
│   Who:       runner@runnervm3jyl0
│   Version:   1.14.3
│   Created:   2026-06-11 08:37:52.240995696 +0000 UTC

Unlock Workflow

Use the Force Unlock Terraform State workflow to remove the lock.

Parameters

Parameter Description
cluster_name Name of the cluster workspace to force unlock
lock_id Specific lock ID to unlock
terraform_env_location Terraform environment location to force unlock; one of:
  • network
  • cluster
  • cluster-core
  • cluster-components
This page was last reviewed on 11 June 2026. It needs to be reviewed again on 11 December 2026 by the page owner #cloud-platform-notify .