Skip to content

tidb-cloud: Terraform import procedures need Terraform v1.5.0 or later, but the prerequisite says >=1.0 #24582

Open

Description

@yahonda

Error Report

  1. What is the URL/path of the document related to this issue?

tidb-cloud/terraform-get-tidbcloud-provider.md and the Terraform resource guides that include an import procedure (on master and release-8.5):

  • tidb-cloud/terraform-migrate-cluster-resource.md
  • tidb-cloud/terraform-use-dedicated-cluster-resource.md
  • tidb-cloud/terraform-use-dedicated-network-container-resource.md
  • tidb-cloud/terraform-use-dedicated-private-endpoint-connection-resource.md
  • tidb-cloud/terraform-use-dedicated-vpc-peering-resource.md
  • tidb-cloud/terraform-use-serverless-branch-resource.md
  • tidb-cloud/terraform-use-serverless-cluster-resource-manage-essential.md
  • tidb-cloud/terraform-use-serverless-cluster-resource.md
  • tidb-cloud/terraform-use-serverless-export-resource.md
  • tidb-cloud/terraform-use-sql-user-resource.md

terraform-get-tidbcloud-provider.md says "All you need to do is install Terraform (>=1.0)", and the resource guides link to it as their prerequisite. However, the import procedures in the guides above use an import block and terraform plan -generate-config-out=generated.tf. Both were introduced in Terraform v1.5.0, so users with Terraform 1.0 to 1.4 meet the documented prerequisite but cannot run the import steps.

  1. How would you like to improve it?

Document that the import procedure requires Terraform v1.5.0 or later, for example in the import section of each guide (or in a shared note). Changing the general requirement in terraform-get-tidbcloud-provider.md to >=1.5.0 is another option, but only if all provider workflows are confirmed to need it.

This was found by CodeRabbit on the Japanese translation PR #24567. The Japanese translation follows the English, so it will pick up the fix through the weekly EN-to-JA sync.

🤖 Generated with Claude Code

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions