ecmonsen / pulumi-provider-jotform

Pulumi Provider for Jotform

This repository is a "native" Pulumi provider for Jotform.

It is based on the Pulumi provider boilerplate.

Caveat: This is my first Golang project; I may have omitted some idioms and standards. Pull requests are welcome.

Build

You can build locally, or use the Dockerfile in this repository to build.

Docker build

Build and run an interactive Docker container

docker build -t pulumi-jotform-builder .
docker run -it -v $(pwd):/data -w /data --name pulumi-provider-jotform-builder --entrypoint bash pulumi-jotform-builder

In the Docker container's shell, execute run-jotform-example (source is in docker/run-jotform-example) to build the provider and run a test Pulumi Python project.

Local build

To build locally, ensure the following tools are installed and present in your $PATH:

• pulumictl
• Go 1.17 or 1.latest
• NodeJS 14.x. We recommend using nvm to manage NodeJS installations.
• Yarn
• TypeScript
• Python (called as python3). For recent versions of MacOS, the system-installed version is fine.
• .NET

Build the provider and install the plugin

$ make build install

This will:

1. Create the SDK codegen binary and place it in a ./bin folder (gitignored)
2. Create the provider binary and place it in the ./bin folder (gitignored)
3. Generate the dotnet, Go, Node, and Python SDKs and place them in the ./sdk folder
4. Install the provider on your machine.

Test against the example

Create an account on Jotform and create an API key in Account settings. Set the API key permissions to "Full access".

Replace YOUR_API_KEY with the API key in the steps below.

cd examples/jotform
pulumi stack init jotform-example-dev
pulumi config set --secret jotform_api_key YOUR_JOTFORM_API_KEY 
pulumi up

You can view your new form in My Forms on Jotform.

Additional Details

This repository depends on the pulumi-go-provider library. For more details on building providers, please check the Pulumi Go Provider docs.

References

Other resources/examples for implementing providers:

• Pulumi Command provider
• Pulumi Go Provider repository
• The Easier Way to Create Pulumi Providers in Go