Skip to content

Latest commit

 

History

History
39 lines (26 loc) · 1.72 KB

README.md

File metadata and controls

39 lines (26 loc) · 1.72 KB

xyz Pulumi Provider

This repo is a boilerplate showing how to create a native Pulumi provider. You can search-replace xyz with the name of your desired provider as a starting point for creating a provider that manages resources in the target cloud.

Most of the code for the provider implementation is in pkg/provider/provider.go.

An example of using the single resource defined in this example is in examples/simple.

A code generator is available which generates SDKs in TypeScript, Python, Go and .NET which are also checked in to the sdk folder. The SDKs are generated from a schema in schema.json. This file shoudl be kept aligned with the resources, functions and types supported by the provider implementation.

Note that the generated provider plugin (pulumi-resource-xyz) must be on your PATH to be used by Pulumi deployments. If creating a provider for distribution to other users, you should ensure they install this plugin to their PATH.

Build and Test

# build the resource provider plugin
$ go install ./cmd/pulumi-resource-xyz

# build the SDK generator
$ go install ./cmd/pulumi-sdkgen-xyz

# regenerate the SDK
$ rm -rf ./sdk
$ pulumi-sdkgen-xyz ./schema.json ./sdk

# test
$ cd examples/simple
$ npm install
$ pulumi stack init test
$ pulumi up

References

Other resoruces for learning about the Pulumi resource model: