teshel/pulumi-tf-provider-boilerplate

Boilerplate code for Terraform provider-backed Pulumi packages

Terraform Bridge Provider Boilerplate

This repository contains boilerplate code for building a new Pulumi provider which wraps an existing Terraform provider, if the existing provider uses Go Modules.

Modify this README to describe:

• The type of resources the provider manages
• Add a build status image from Travis at the top of the README
• Update package names in the information below
• Add any important documentation of concepts (e.g. the "serverless" components in the AWS provider).

Creating a Pulumi Terraform Bridge Provider

First, clone this repo with the name of the desired provider in place of xyz:

git clone https://github.com/pulumi/pulumi-tf-provider-boilerplate pulumi-xyz

Second, replace references to xyz with the name of your provider:

make prepare NAME=foo REPOSITORY=github.com/pulumi/pulumi-foo

Next, list the configuration points for the provider in the area of the README.

Note: If the name of the desired Pulumi provider differs from the name of the Terraform provider, you will need to carefully distinguish between the references - see https://github.com/pulumi/pulumi-azure for an example.

Add dependencies

In order to properly build the sdks, the following tools are expected:

• tf2pulumi (See the project's README for installation instructions: https://github.com/pulumi/tf2pulumi)
• pandoc (brew install pandoc)

In the root of the repository, run:

• go get github.com/pulumi/scripts/gomod-doccopy (Note: do not set GO111MODULE=on here)
• GO111MODULE=on go get github.com/pulumi/pulumi-terraform@master
• GO111MODULE=on go get github.com/terraform-providers/terraform-provider-xyz (where xyz is the name of the provider)
• GO111MODULE=on go mod vendor
• make ensure

Build the provider:

• Edit resources.go to map each resource, and specify provider information
• Enumerate any examples in examples/examples_test.go
• make

Installing

This package is available in many languages in the standard packaging formats.

Node.js (Java/TypeScript)

To use from JavaScript or TypeScript in Node.js, install using either npm:

$ npm install @pulumi/xyx

or yarn:

$ yarn add @pulumi/xyx

Python

To use from Python, install using pip:

$ pip install pulumi_xyx

Go

To use from Go, use go get to grab the latest version of the library

$ go get github.com/pulumi/pulumi-xyz/sdk/go/...

Configuration

The following configuration points are available for the xyz provider:

• xyz:apiKey (environment: XYZ_API_KEY) - the API key for xyz
• xyz:region (environment: XYZ_REGION) - the region in which to deploy resources

Reference

For detailed reference documentation, please visit the API docs.