Skip to content

Commit 4d2cdeb

Browse files
Atru/improve search feature discoverability (#1103)
This PR updates the instructions for importing resources using the HCPT UI to include more "search" keywords so that we can improve discoverability for people looking for "Terraform search".
2 parents aaee6a4 + 49f1107 commit 4d2cdeb

File tree

2 files changed

+5
-5
lines changed

2 files changed

+5
-5
lines changed

content/terraform-docs-common/data/cloud-docs-nav-data.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -298,11 +298,11 @@
298298
{
299299
"title": "Import existing resources",
300300
"path": "workspaces/import",
301+
"alias": "search, terraform search, resource discoverability",
301302
"badge": {
302303
"text": "BETA",
303304
"type": "outlined",
304305
"color": "neutral"
305-
306306
}
307307
},
308308
{

content/terraform-docs-common/docs/cloud-docs/workspaces/import.mdx

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,18 @@
11
---
2-
page_title: Import existing resources to state
3-
description: Learn how to use queries to find unmanaged infrastructure and import it into Terraform
2+
page_title: Use search to find and import existing resources to state
3+
description: Learn how to use Terraform search to find unmanaged infrastructure and import it into your workspace in bulk.
44
tfc_only: true
55
---
66

77
# Import existing resources to state
88

9-
You can define queries in your Terraform configuration to search for resources that are not yet managed by Terraform. HCP Terraform presents query results so that you can use the UI to import the resources and begin managing them as code. This topic describes the workflow for importing resources in bulk. For instructions on importing single resources or small batches of resources in your configuration, refer to [Import a single resource](/terraform/language/v1.14.x/import/single-resource).
9+
Terraform can search your existing infrastructure for resources to let you import any unmanaged resources to an HCP Terraform workspace in bulk. For instructions on importing single resources or small batches of resources in your configuration, refer to [Import a single resource](/terraform/language/v1.14.x/import/single-resource).
1010

1111
@include 'beta.mdx'
1212

1313
## Overview
1414

15-
You can use search functionality in [UI and VCS-driven](/terraform/cloud-docs/run/ui) and [CLI-driven](/terraform/cloud-docs/run/cli) workspaces. Complete the following steps to search for resources and import them into your Terraform state:
15+
You can search for unmanaged resources in [UI and VCS-driven](/terraform/cloud-docs/run/ui) and [CLI-driven](/terraform/cloud-docs/run/cli) workspaces. HCP Terraform presents results so that you can use the UI to import the resources and begin managing them as code. Complete the following steps to search for resources and import them into your Terraform state:
1616

1717
1. **Define queries**: Add `list` blocks to your Terraform configuration. If you are using the VCS-driven workflow, commit this change and push it to the repository associated with your workspace in HCP Terraform. Refer to [Import resources in bulk](/terraform/language/v1.14.x/import/bulk) for more information.
1818
1. **Run the queries**: You can run queries in the HCP Terraform UI or run the Terraform CLI on your local workstation.

0 commit comments

Comments
 (0)