Add brandon-pollack and blog post on terraform convert #13777

brandonpollack23 · 2025-01-09T08:20:49Z

Proposed changes

Unreleased product version (optional)

Related issues (optional)

thoward

This is a great article, @brandonpollack23 ! Thanks much for the write-up. There are some minor grammatical issues to address (as noted), but otherwise the post looks good.

thoward · 2025-01-09T18:20:20Z

content/blog/pulumi-convert-terraform-improvements/index.md

+with a single unified programming model.  
+To that end, we've already added support for [any Terraform/OpenTofu provider](/home/brpol/src/pulumi/docs/content/blog/any-terraform-provider/).
+This works great if you already have an existing pulumi project and want to
+utilize some providers from the Terraform ecosystem that aren't yet available for


"utilize" -> "use" (improper word use: "utilize" means to use for a purpose other than what was intended, "e.g. i utilized a kitchen spatula to remove the ice from the car." vs "i used a kitchen spatula to flip an egg" or "i used an ice scraper to remove the ice from the car)

I want to emphasize that we are taking advantage of somehting very useful. How about "leverage"

Leverage works!

thoward · 2025-01-09T18:21:03Z

content/blog/pulumi-convert-terraform-improvements/index.md

+To that end, we've already added support for [any Terraform/OpenTofu provider](/home/brpol/src/pulumi/docs/content/blog/any-terraform-provider/).
+This works great if you already have an existing pulumi project and want to
+utilize some providers from the Terraform ecosystem that aren't yet available for
+Pulumi natively! However, What if you are trying to move your already existing


"What" -> "what" (capitalize beginnings of sentences, not phrases)

"already existing" -> "existing" (simplify grammar)

thoward · 2025-01-09T18:23:24Z

content/blog/pulumi-convert-terraform-improvements/index.md

+This works great if you already have an existing pulumi project and want to
+utilize some providers from the Terraform ecosystem that aren't yet available for
+Pulumi natively! However, What if you are trying to move your already existing
+Infrastructure as Code solution to Pulumi IaC?


"Infrastructure as Code" -> "infrastructure as code" (infrastructure as code is not a proper noun so should not be capitalized)

thoward · 2025-01-09T18:23:55Z

content/blog/pulumi-convert-terraform-improvements/index.md

+
+We already have a [handy
+utility](/docs/using-pulumi/adopting-pulumi/migrating-to-pulumi/from-terraform/)
+called `pulumi convert` built into the cli to convert terraform projects to any


"cli" -> "CLI" (capitalize acronyms)

"terraform" -> "Terraform" (capitalize proper nouns)

thoward · 2025-01-09T18:24:59Z

content/blog/pulumi-convert-terraform-improvements/index.md

+utility](/docs/using-pulumi/adopting-pulumi/migrating-to-pulumi/from-terraform/)
+called `pulumi convert` built into the cli to convert terraform projects to any
+Pulumi language, but up until now it didn't handle dependencies on external
+terraform providers which don't have a known Pulumi native equivalent.


"terraform" -> "Terraform" (capitalize proper nouns)

thoward · 2025-01-09T19:34:49Z

content/blog/pulumi-convert-terraform-improvements/index.md

+* We still have a bit of [unimplemented Terraform functionality](https://github.com/pulumi/pulumi-converter-terraform/issues/65) that we're tracking and are evaluating how to move forward.  For now when these functions are detected it will require some manual intervention on the converted project before you're ready to deploy.
+* If you define your terraform module in a parent directory of your deployment code, you'll encounter a [known bug](https://github.com/pulumi/pulumi-converter-terraform/issues/194), but a simple workaround is to restructure your Terraform code before running a conversion.
+* Terraform programs are dynamically typed, when converting to a type safe language sometimes a type is unknown and still needs to be added manually (as in the typescript example above).
+* Variables/Configuration are not yet converted automatically, so tfvars files etc will need to be manually converted into pulumi stack configurations.


"Variables/Configuration" -> "Variables and configuration" (grammar: sentence capitalization and conjunction use)

"tfvars" -> ".tfvars" (use code formatting for filenames)

"pulumi" -> "Pulumi" (capitalize proper nouns)

content/blog/pulumi-convert-terraform-improvements/meta.png

thoward · 2025-01-09T19:37:16Z

content/blog/pulumi-convert-terraform-improvements/index.md

+---
+title: "Pulumi Convert Terraform Improvements"
+date: 2025-01-08T14:47:13+09:00
+meta_desc: "Pulumi convert now supports a number of enhancements and bug fixes for terraform, including automatically bridging providers"


"terraform" -> "Terraform" (capitalize proper nouns)

thoward · 2025-01-09T19:37:51Z

content/blog/pulumi-convert-terraform-improvements/index.md

+At Pulumi, we want to provide access to manage **any** cloud infrastructure
+with a single unified programming model.  
+To that end, we've already added support for [any Terraform/OpenTofu provider](/home/brpol/src/pulumi/docs/content/blog/any-terraform-provider/).
+This works great if you already have an existing pulumi project and want to


"pulumi" -> "Pulumi" (capitalize proper nouns)

thoward · 2025-01-09T19:39:30Z

content/blog/pulumi-convert-terraform-improvements/index.md

+
+In order to illustrate the example further, I've thrown together a simple
+Terraform project that sets up a Google Compute Engine virtual machine, a
+Planetscale database, and wires them together.  At the time of writing, there


"Planetscale" -> "PlanetScale" (use correct capitalization for product name)

thoward · 2025-01-09T19:44:13Z

Also, looks like the build is failing the linter check:

Errors:

/home/runner/work/docs/docs/content/blog/pulumi-convert-terraform-improvements/index.md:
Line 349: Unordered list style [Expected: dash; Actual: asterisk].
Line 350: Unordered list style [Expected: dash; Actual: asterisk].
Line 351: Unordered list style [Expected: dash; Actual: asterisk].
Line 352: Unordered list style [Expected: dash; Actual: asterisk].

You can run make lint from the root of the docs repo to resolve these. The linter is pretty strict about Markdown formatting details, but it should be straightforward to satisfy its requirements.

pulumi-bot · 2025-01-10T02:44:33Z

Your site preview for commit cec090c is ready! 🎉

http://www-testing-pulumi-docs-origin-pr-13777-cec090cb.s3-website.us-west-2.amazonaws.com.

pulumi-bot · 2025-01-10T03:25:56Z

Your site preview for commit 8dae809 is ready! 🎉

http://www-testing-pulumi-docs-origin-pr-13777-8dae8094.s3-website.us-west-2.amazonaws.com.

brandonpollack23 · 2025-01-10T04:46:40Z

Addressed :)

tgummerer · 2025-01-10T08:20:14Z

content/blog/pulumi-convert-terraform-improvements/index.md

+
+At Pulumi, we want to provide access to manage **any** cloud infrastructure
+with a single unified programming model.  
+To that end, we've already added support for [any Terraform/OpenTofu provider](/home/brpol/src/pulumi/docs/content/blog/any-terraform-provider/).


Suggested change

To that end, we've already added support for [any Terraform/OpenTofu provider](/home/brpol/src/pulumi/docs/content/blog/any-terraform-provider/).

To that end, we've already added support for [any Terraform/OpenTofu provider](blog/any-terraform-provider/).

tgummerer · 2025-01-10T08:21:57Z

content/blog/pulumi-convert-terraform-improvements/index.md

+to navigate to your project directory and run the following command with the
+latest version of Pulumi installed:
+
+{{% chooser language "javascript,typescript,python,go" %}}


Does this not work for yaml/dotnet/java?

it does but I havent gotten around to testing each of those (there are enough issues from various subtleties in the ones built into the repo). Figured I'd wait until it was out of draft stage and folks had a look at it, but I'm going to test/add them after that.

tgummerer · 2025-01-10T08:22:32Z

content/blog/pulumi-convert-terraform-improvements/index.md

+
+{{% /chooser %}}
+
+This will download the necessary converter and language plugins, run the


Aren't language plugins always bundled with the pulumi installation? So they shouldn't need to be downloaded.

tgummerer · 2025-01-10T08:25:46Z

content/blog/pulumi-convert-terraform-improvements/index.md

+{{% choosable language python %}}
+
+```shell
+pulumi convert --from terraform --language python --out python


Suggested change

pulumi convert --from terraform --language python --out python

pulumi convert --from terraform --language python --out pulumi-program

Or something? I stumbled over this wondering why we need python twice for a minute.

tgummerer · 2025-01-10T08:41:20Z

content/blog/pulumi-convert-terraform-improvements/index.md

@@ -0,0 +1,352 @@
+---
+title: "Pulumi Convert Terraform Improvements"


I wonder if we can come up with a more exciting/specific title for this. Maybe

Convert Terraform Projects With Any Provider

Though I don't really love that either 🤔

I'm open to suggestions for sure, I'm not in love with this title

pulumi-bot · 2025-01-10T08:58:12Z

Your site preview for commit a0dcd9a is ready! 🎉

http://www-testing-pulumi-docs-origin-pr-13777-a0dcd9a8.s3-website.us-west-2.amazonaws.com.

Add brandon-pollack and blog post on terraform convert

f91b70f

brandonpollack23 had a problem deploying to testing January 9, 2025 08:20 — with GitHub Actions Failure

thoward requested changes Jan 9, 2025

View reviewed changes

grammar and capitalization comments

cec090c

brandonpollack23 force-pushed the bpollack/pulumi_convert branch from 54e8df1 to cec090c Compare January 10, 2025 02:37

brandonpollack23 temporarily deployed to testing January 10, 2025 02:37 — with GitHub Actions Inactive

meta image

8dae809

brandonpollack23 temporarily deployed to testing January 10, 2025 03:19 — with GitHub Actions Inactive

tgummerer reviewed Jan 10, 2025

View reviewed changes

comments from Thomas

a0dcd9a

brandonpollack23 temporarily deployed to testing January 10, 2025 08:52 — with GitHub Actions Inactive

brandonpollack23 marked this pull request as ready for review January 10, 2025 08:53

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add brandon-pollack and blog post on terraform convert #13777

Add brandon-pollack and blog post on terraform convert #13777

brandonpollack23 commented Jan 9, 2025

thoward left a comment

thoward Jan 9, 2025

brandonpollack23 Jan 10, 2025

thoward Jan 10, 2025

thoward Jan 9, 2025

thoward Jan 9, 2025

thoward Jan 9, 2025

thoward Jan 9, 2025

thoward Jan 9, 2025

thoward Jan 9, 2025

thoward Jan 9, 2025

thoward Jan 9, 2025

thoward Jan 9, 2025

thoward Jan 9, 2025

thoward Jan 9, 2025

thoward Jan 9, 2025

thoward commented Jan 9, 2025

pulumi-bot commented Jan 10, 2025

pulumi-bot commented Jan 10, 2025

brandonpollack23 commented Jan 10, 2025

tgummerer Jan 10, 2025

tgummerer Jan 10, 2025

brandonpollack23 Jan 10, 2025

tgummerer Jan 10, 2025

tgummerer Jan 10, 2025

tgummerer Jan 10, 2025

brandonpollack23 Jan 10, 2025

pulumi-bot commented Jan 10, 2025

	To that end, we've already added support for [any Terraform/OpenTofu provider](/home/brpol/src/pulumi/docs/content/blog/any-terraform-provider/).
	To that end, we've already added support for [any Terraform/OpenTofu provider](blog/any-terraform-provider/).


		{{% /chooser %}}

		This will download the necessary converter and language plugins, run the

	pulumi convert --from terraform --language python --out python
	pulumi convert --from terraform --language python --out pulumi-program

		@@ -0,0 +1,352 @@
		---
		title: "Pulumi Convert Terraform Improvements"

Add brandon-pollack and blog post on terraform convert #13777

Are you sure you want to change the base?

Add brandon-pollack and blog post on terraform convert #13777

Conversation

brandonpollack23 commented Jan 9, 2025

Proposed changes

Unreleased product version (optional)

Related issues (optional)

thoward left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

thoward commented Jan 9, 2025

pulumi-bot commented Jan 10, 2025

pulumi-bot commented Jan 10, 2025

brandonpollack23 commented Jan 10, 2025

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

pulumi-bot commented Jan 10, 2025