Join us at the Cloud Engineering Summit on October 20th for a free day of learning. Save your spot.

Pulumi Packages

Pulumi Packages are the core technology that enables cloud infrastructure resource provisioning to be defined once, and made available to users in all Pulumi languages. With Pulumi Packages, Resources and Components can be written once, in your preferred language, and made available in all the other languages supported by Pulumi.

A diagram showing how Pulumi Package code can be authored in one language and made available in all other languages supported by Pulumi

Types of Pulumi Packages

There are currently 3 different types of Pulumi Packages:

  1. Native Pulumi Provider Package: Use the full features of the Pulumi resource model to create a provider for a new cloud platform. Examples: the kubernetes, azure-native, and google-native packages.
  2. Bridged Provider Package: Take an existing resource provider from another supported ecosystem (like a Terraform provider), and bridge it to be exposed as a Pulumi Package. Examples: the aws, tls, and cloudflare packages.
  3. Component Package: Write a Pulumi Component in your language of choice and expose it to users in all Pulumi languages. Example: the eks package.

Process of authoring a Pulumi Package

Regardless of the type of Pulumi Package you want to author, there are a few key steps in the process of authoring a Pulumi package.

  1. Decide the type of package you want to create and create a repository for it using one of the template repos provided by Pulumi
  2. Create the Resources or Components you want to include in the package, either by authoring them manually (in the case of a Component Package) or generating them from a cloud provider’s API or via a provider bridge
  3. Build the resource provider plugin: the binary file that contains all of the components or resources you defined in your source code
  4. Generate the SDK code for all languages supported by Pulumi and packs the SDK packages–the npm, NuGet, and Python packages–that the Pulumi Package’s users will reference in their own programs
  5. Publish the SDK packages and the resource provider plugin

A graphic representation of the steps listed above

All Pulumi Packages must include a schema, which defines the resources and functions exposed by the package, and is used to drive the generation of language-specific SDKs and documentation.

Get started

To get started, create a repository from your component from the appropriate template repository: