Pulumi Terraform Bridge
This bridge adapts any Terraform Provider built using the Terraform Plugin SDK for use with Pulumi. The Terraform community provides resource providers that perform create, read, update, and delete (CRUD) operations for a broad array of infrastructure providers and types. In principle, any of them can be programmed using Pulumi with this bridge.
If you want to wrap a new Terraform provider as a Pulumi provider, check out pulumi/pulumi-tf-provider-boilerplate.
Developing a New Provider
The recommended way to start developing a new TF provider is with pulumi-tf-provider-boilerplate.
If you want details on how provider development works, please see our docs.
Most users of Pulumi don't need to know how this bridge works. Many will find it interesting, and, if you'd like to bring up a new provider that is available in Terraform but not yet Pulumi, we would love to hear from you.
How It Works
There are two major things involved in this bridge: design-time and runtime.
At design-time, we code-generate packages by dynamic inspection of a Terraform Provider's schema. This only works for providers that are built using static schemas. It is possible to write Terraform Providers without this, which means the ability to create packages would not exist, but in practice all interesting providers use it.
Second, the bridge connects the Pulumi engine to a given Terraform Provider using Pulumi's RPC interfaces. This behavior also leverages the Terraform provider schema, for operations like performing validation and diffs.
This section only matters if you want to build this bridge from scratch, or use it in your own project.
Before doing any development, there are a few prerequisites to install:
- Go: https://golang.org/dl
go get -u github.com/golangci/golangci-lint/cmd/golangci-lint
Building and Testing
There is a
Makefile in the root that builds and tests everything.
To build, ensure
$GOPATH is set, and clone into a standard Go workspace:
$ git clone firstname.lastname@example.org:pulumi/pulumi-terraform-bridge $GOPATH/src/github.com/pulumi/pulumi-terraform-bridge
$ cd $GOPATH/src/github.com/pulumi/pulumi-terraform-bridge
You can run make to build and run tests:
This repo on its own isn't particularly interesting, until it is used to create a new Pulumi provider.
Design Time Options
tfgen, the command that generates Pulumi schema/code for a bridged provider supports the following environment variables:
PULUMI_SKIP_MISSING_MAPPING_ERROR: If truthy, tfgen will not fail if a data source or resource in the TF provider is not mapped to the Pulumi provider. Instead, a warning is printed. Default is
PULUMI_SKIP_EXTRA_MAPPING_ERROR: If truthy, tfgen will not fail if a mapped data source or resource does not exist in the TF provider. Instead, warning is printed. Default is
PULUMI_MISSING_DOCS_ERROR: If truthy, tfgen will fail if docs cannot be found for a data source or resource. Default is
PULUMI_CONVERT: If truthy, tfgen will shell out to
pulumi convertfor converting example code from TF HCL to Pulumi PCL