[registry] Docs and launch blog for Terraform modules in the Pulumi Cloud registry#19453
Draft
fnune wants to merge 5 commits into
Draft
[registry] Docs and launch blog for Terraform modules in the Pulumi Cloud registry#19453fnune wants to merge 5 commits into
fnune wants to merge 5 commits into
Conversation
…stry Add a new concept page under IDP describing how Pulumi Cloud hosts Terraform modules: authentication via `terraform login`, the three HCP-compatible publish paths (go-tfe, hashicorp/tfe provider, tfc-workflows-github Action), the standard module layout we extract from at publish, consumption from OpenTofu / Terraform via the Module Registry Protocol, and consumption from a Pulumi program via `pulumi package add terraform-module`. Cross-link from the existing "Use a Terraform Module in Pulumi" guide so consumers landing on the IaC guide can discover the Pulumi-Cloud-hosted path. Design doc: https://app.notion.com/p/Terraform-module-hosting-in-the-Pulumi-Cloud-registry-372fdbdf1cce801ea7a3f4946c1e4154 Fixes pulumi/pulumi-service#44080 ## Test plan - Render the IDP concepts section locally and confirm the new "Terraform Modules" entry appears under the Concepts menu - Click through every internal link in the new page to confirm targets exist
Collaborator
|
Your site preview for commit 24e0e9c is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-19453-24e0e9c8.s3-website.us-west-2.amazonaws.com |
Add the announcement blog post for hosting Terraform modules in the Pulumi Cloud registry, and correct the registry host across the docs and blog from app.pulumi.com to the canonical tf.pulumi.com (per pulumi/pulumi-service#44889; app.pulumi.com is the console only). Move the migration guidance out of the blog and into the concept page, and document the one naming rule that differs from HCP Terraform: module names reject underscores.
fnune
changed the title
Contributor
Social Media Reviewcontent/blog/terraform-modules-pulumi-cloud-registry/index.mdX — FAIL
LinkedIn — PASSBluesky — missingSuggested copyX (178/255 chars) — minimum change: blank line inserted before final sentence:
Bluesky (280/300 chars) — drafted from the article:
Suggestions (advisory)These are stylistic notes — they don't block the post.
Updated for commit |
The TFE discovery document (cmd/service/api/tfe_discover.go) advertises tfe.v2, state.v2, and modules.v1 but no login.v1, so terraform login against tf.pulumi.com is unsupported. Document the real auth instead: a Pulumi access token is the bearer for publish (go-tfe, the tfe provider, the GitHub Action), pulumi login for pulumi package add, and TF_TOKEN_tf_pulumi_com for plain OpenTofu or Terraform.
- Remove the tfc-workflows-github Action from the publish and delete paths and from the auth list. create-run triggers a run; it does not touch the module registry. The testbed only exercised go-tfe and the tfe provider. - Consume from Pulumi: drop the rejected "CLI injects TF_TOKEN_<host>" detail. After pulumi login the provider resolves the module with your Pulumi credentials. Note that terraform-module is a parameterized provider and name its parameters. - Module layout: parse all root .tf files (any filenames); examples and README are captured at publish, not rendered (console rendering is not built yet). - Say packages, not components.
…ckend Apply the Pulumi brand writing-style rules: sentence case for the concept page title_tag/title/h1 and no over-capitalized concepts, so "Terraform modules in the Pulumi Cloud registry" rather than title case. Drop the "just" minimizer from the migration line. Link "keep Terraform state in Pulumi Cloud" in the blog to the state backend guide.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Documentation and a launch blog post for hosting Terraform modules in the Pulumi Cloud registry.
Docs
terraform login, the three HCP-compatible publish paths (go-tfe, the hashicorp/tfe provider, the tfc-workflows-github Action), the standard module layout extracted at publish, migrating from HCP Terraform, and consumption from OpenTofu / Terraform and from a Pulumi program.Blog
content/blog/terraform-modules-pulumi-cloud-registry/, withcanonical_urlpointing at the concept page. Feature and meta images generated with the/blog-meta-imagetooling (Terraform logo variant).Notes
tf.pulumi.com(per pulumi/pulumi-service#44889), notapp.pulumi.com.app.pulumi.comis the console only.control_tower_account_factory; rename to hyphens before publishing).Design doc: https://app.notion.com/p/Terraform-module-hosting-in-the-Pulumi-Cloud-registry-372fdbdf1cce801ea7a3f4946c1e4154
Fixes https://github.com/pulumi/pulumi-service/issues/44080
Test plan
make serve) and confirm the new "Terraform Modules" entry appears under the IDP Concepts menu and renders./blog/terraform-modules-pulumi-cloud-registry/locally and confirm the post renders, including the meta image and theog:imagesocial preview.tf.pulumi.com.