Skip to content

Add bump-tf skill - #5990

Merged
pietern merged 2 commits into
mainfrom
bump-tf-skill
Aug 11, 2026
Merged

Add bump-tf skill#5990
pietern merged 2 commits into
mainfrom
bump-tf-skill

Conversation

@pietern

Copy link
Copy Markdown
Contributor

Changes

Add a user-invocable bump-tf skill that codifies the Terraform provider bump workflow: bump the version constant, regenerate the Go schema (./task generate-tf-schema) and the DABs/TF field map (./task generate-schema-map), refresh acceptance goldens with a mandatory non-update verify pass, resolve schema-driven behavior changes, and add a changelog fragment.

Why

The bump has non-obvious steps that are easy to get wrong. The -update acceptance run can silently mask a real failure when a schema change makes the Terraform and direct engines diverge, so the skill requires a non-update verify pass to catch it. Capturing the workflow makes future bumps repeatable.

Tests

Validated by running the skill hands-off in a fresh worktree to bump to v1.122.0. Its result was byte-identical on the important bits to the manually authored #5977, differing only in one equivalent fixture value and the changelog filename.

This pull request and its description were written by Isaac.

Codify the Terraform provider bump workflow as a user-invocable skill: bump the
version constant in bundle/internal/tf/codegen/schema/version.go, regenerate the
Go schema and the DABs<->TF field map via ./task, refresh acceptance goldens
with a mandatory non-update verify pass that catches divergent engine variants,
resolve schema-driven behavior changes (now-required or removed provider
fields), and add a changelog fragment.
The registry-workaround.md appendix documents the filesystem-mirror fallback for
when the Terraform Registry has not yet indexed a freshly published release.
Co-authored-by: Isaac
@pietern
pietern marked this pull request as ready for review July 21, 2026 08:39
@eng-dev-ecosystem-bot

eng-dev-ecosystem-bot commented Jul 21, 2026

Copy link
Copy Markdown
Collaborator

Integration test report

Commit: 3eaaf60

Run: 31500692861

Env🔄​flaky💚​RECOVERED🙈​SKIP✅​pass🙈​skipTime
💚​aws linux44290113110:19
💚​aws windows4429211297:51
🔄​azure linux144288113111:10
💚​azure windows4429111299:14
💚​gcp linux15290113110:13
💚​gcp windows1529211298:52
9 interesting tests: 4 RECOVERED, 4 SKIP, 1 flaky
Test Nameaws linuxaws windowsazure linuxazure windowsgcp linuxgcp windows
💚​TestAccept💚​R💚​R💚​R💚​R💚​R💚​R
🙈​TestAccept/bundle/invariant/no_drift🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S
🙈​TestAccept/bundle/resources/vector_search_endpoints/drift/recreated_same_name🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S
🙈​TestAccept/bundle/resources/vector_search_indexes/recreate/embedding_dimension🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S
🙈​TestAccept/ssh/connection🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S
🔄​TestSyncNestedFolderSync✅​p✅​p🔄​f✅​p✅​p✅​p
💚​TestFetchRepositoryInfoAPI_FromRepo💚​R💚​R💚​R💚​R🙈​S🙈​S
💚​TestFetchRepositoryInfoAPI_FromRepo/root💚​R💚​R💚​R💚​R
💚​TestFetchRepositoryInfoAPI_FromRepo/subdir💚​R💚​R💚​R💚​R
Top 18 slowest tests (at least 2 minutes):
durationenvtestname
6:38gcp windowsTestAccept
6:24aws windowsTestAccept
6:23azure windowsTestAccept
3:15aws linuxTestAccept
3:07gcp linuxTestAccept
3:00azure linuxTestAccept
2:55aws windowsTestFilerWorkspaceFilesExtensionsStat
2:55gcp linuxTestFilerWorkspaceFilesExtensionsStat
2:46gcp windowsTestFilerRecursiveDelete/workspace_files
2:34aws linuxTestFilerWorkspaceFilesExtensionsDelete
2:28azure linuxTestFilerRecursiveDelete/workspace_files_extensions
2:21gcp linuxTestFilerWorkspaceFilesExtensionsReadDir
2:21azure windowsTestFilerWorkspaceFilesExtensionsDelete
2:17gcp linuxTestImportDirDoesNotOverwrite
2:12azure windowsTestFilerRecursiveDelete/workspace_files_extensions
2:07gcp windowsTestFilerWorkspaceFilesExtensionsStat
2:06azure windowsTestFilerReadWrite/workspace_files
2:00azure windowsTestImportDirDoesNotOverwrite


If codegen succeeded, ignore this file.

## Fix: point Terraform at a local filesystem mirror

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

have you seen this be needed?

Everything else (`bundle/internal/tf/schema/*` including `root.go`, and `bundle/terraform_dabs_map/generated.go`) is generated from it, so the only file you hand-edit for the bump itself is `version.go`.
Do not edit the generated files, and do not touch the `databricks-tf-provider/...` version comment in `libs/testdiff/replacement.go` (the version is masked in acceptance output, so changing it is pure noise).

## Steps

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Given very deterministic instructions, can the whole thing be a Python script? The skill can still be there but it runs the script and then debugs if it does not work (and improves the script further).

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Probably true, but more investment. @janniklasrose confirmed this worked out of the box last week.

And we'll remove it with TF in a little while anyway.

@pietern
pietern enabled auto-merge August 11, 2026 14:16
@pietern
pietern added this pull request to the merge queueAug 11, 2026
Merged via the queue into main with commit 12d94b5Aug 11, 2026
23 checks passed
@pietern
pietern deleted the bump-tf-skill branch August 11, 2026 15:54
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants

@pietern@eng-dev-ecosystem-bot@denik@janniklasrose