@pulumi/pulumi

What is @pulumi/pulumi?

@pulumi/pulumi is an infrastructure as code (IaC) tool that allows developers to define, deploy, and manage cloud infrastructure using familiar programming languages like JavaScript, TypeScript, Python, Go, and C#. It integrates with various cloud providers and services, enabling users to create, update, and manage cloud resources programmatically.

What are @pulumi/pulumi's main functionalities?

Defining Cloud Infrastructure

This feature allows you to define cloud infrastructure using code. In this example, an S3 bucket is created using the AWS provider.

const pulumi = require('@pulumi/pulumi');
const aws = require('@pulumi/aws');

const bucket = new aws.s3.Bucket('my-bucket');

exports.bucketName = bucket.id;

Managing Infrastructure State

Pulumi manages the state of your infrastructure, allowing you to respond to changes. This example sets up an event handler for when a new object is created in the S3 bucket.

const pulumi = require('@pulumi/pulumi');
const aws = require('@pulumi/aws');

const bucket = new aws.s3.Bucket('my-bucket');

bucket.onObjectCreated('onNewObject', async (event) => {
  console.log('New object created:', event);
});

Multi-Cloud Deployments

Pulumi supports multi-cloud deployments, allowing you to manage resources across different cloud providers. This example shows how to create an S3 bucket in AWS and a storage account in Azure.

const pulumi = require('@pulumi/pulumi');
const aws = require('@pulumi/aws');
const azure = require('@pulumi/azure');

const awsBucket = new aws.s3.Bucket('aws-bucket');
const azureStorageAccount = new azure.storage.Account('azure-storage', {
  resourceGroupName: 'my-resource-group',
  accountTier: 'Standard',
  accountReplicationType: 'LRS'
});

Other packages similar to @pulumi/pulumi

terraform

Terraform by HashiCorp is another popular IaC tool that allows you to define and provision infrastructure using a declarative configuration language. Unlike Pulumi, which uses general-purpose programming languages, Terraform uses its own domain-specific language (HCL). Terraform has a large ecosystem and strong community support.

aws-cdk

The AWS Cloud Development Kit (CDK) is an open-source software development framework to define cloud infrastructure in code and provision it through AWS CloudFormation. Similar to Pulumi, AWS CDK allows you to use familiar programming languages, but it is specific to AWS services.

serverless

The Serverless Framework is a tool for building and deploying serverless applications. It focuses on serverless architectures and supports multiple cloud providers. While it shares some similarities with Pulumi in terms of deployment and management, it is more specialized in serverless use cases.

README

Pulumi Node.js SDK

The Pulumi Node.js SDK lets you write cloud programs in JavaScript.

Installation

Using npm:

$ npm install --save @pulumi/pulumi

Using yarn:

$ yarn add @pulumi/pulumi

This SDK is meant for use with the Pulumi CLI. Visit Pulumi's Download & Install to install the CLI.

Building and Testing

For anybody who wants to build from source, here is how you do it.

Prerequisites

This SDK uses Node.js and we support any of the Current, Active and Maintenance LTS versions. We support both NPM and Yarn for package management.

At the moment, we only support building on macOS and Linux, where standard GNU tools like make are available.

Make Targets

To build the SDK, simply run make from the root directory (where this README lives, at sdk/nodejs/ from the repo's root). This will build the code, run tests, and install the package and its supporting artifacts.

At the moment, for local development, we install everything into $HOME/.dev-pulumi. You will want this on your $PATH.

The tests will verify that everything works, but feel free to try running pulumi preview and/or pulumi up from the examples/minimal/ directory. Remember to run tsc first, since pulumi expects JavaScript, not TypeScript.

Changelog

3.135.0 (2024-10-01)

Features

• [backend/{diy,service}] Send secrets managers as initial state when creating stacks #17387

• [sdk/python] Search upwards for pyproject.toml when using Poetry #17388

Bug Fixes

• [cli/config] Improve usage string for config env add/rm commands #17407

• [cli/new] Check zipped templates for Pulumi.yaml files #17437

• [engine] Disable the enviromental GITHUB_TOKEN on 401 responses #17351

• [engine] Fix a panic when multiple component provider construct calls fail #17439

• [sdkgen/go] Fix nested string map map map properties #17417

• [sdk/nodejs] Fix dependency installation for nodejs projects with a main property #17391

• [sdk/python] Add missing package_ref paramater to ProviderResource #17432

Miscellaneous

• [sdkgen] Validate schema version is provided when package supports packing #17420

• [sdk/python] Replace asyncio.ensure_future with create_task #17406

• [sdkgen/{nodejs,python}] Bump minimum valid SDK version to v3.134.1 so that output-invokes work and maintain secrets #17390