Pulumi v3.273.0: resourceExists, Automation API Upgrades, and Removal of pulumi watch
Pulumi v3.273.0 adds resourceExists, extends Automation APIs, drops pulumi watch, and restricts AI agent auto-signup.
Infrastructure as Code
Pulumi v3.277.0 adds a preview delivery register CLI command, Automation API preview() in NodeJS/Python/Go, and provider CheckConfig2. Upgrade and verification steps included.
Pulumi v3.277.0 was released on 2026-11-18, following v3.276.0. This release introduces a preview CLI command for Pulumi Delivery, extends the Automation API with a preview method, adds a new provider protocol method, and includes several fixes and small improvements. This article covers what matters for teams writing and running Pulumi programs day to day.
pulumi delivery register (preview)A new preview command registers the Pulumi Delivery pipeline that a program declares (#25729):
pulumi delivery registerThis is marked as a preview feature, so expect behavior and flags to evolve in future releases. Treat it as experimental in production workflows.
preview() for NodeJS, Python, and GoThe generated Automation API now exposes a preview method for NodeJS, Python, and Go SDKs (#25054). This lets automation scripts run a dry-run preview without going through the CLI directly.
NodeJS example:
const stack = await LocalWorkspace.createOrSelectStack({ stackName, projectName, program });
const previewResult = await stack.preview();
console.log(previewResult.stdout);Python example:
stack = auto.create_or_select_stack(stack_name=stack_name, project_name=project_name, program=pulumi_program)
preview_result = stack.preview()
print(preview_result.stdout)Go example:
previewResult, err := stack.Preview(ctx)
if err != nil {
return err
}
fmt.Println(previewResult.StdOut)CheckConfig2The engine adds a CheckConfig2 method to the provider protocol, with its own request and response types (#25670). This is primarily relevant to provider authors implementing the resource provider gRPC interface; it does not change HCL/program-level syntax but is worth tracking if you maintain a custom provider.
pulumi state move --parentThe pulumi state move command gains a --parent flag to parent moved resources under a resource in the destination stack (#25697):
pulumi state move \
--source-stack my-org/my-project/dev \
--parent urn:pulumi:dev::my-project::aws:s3/bucket:Bucket::target-parent \
urn:pulumi:dev::old-project::aws:s3/bucket:Bucket::my-bucketThis is useful when consolidating stacks and you need the moved resource to sit under an existing parent resource rather than at the top level.
property.Map.Keys()The Go SDK adds a Keys() method to property.Map, giving plugin and provider authors a direct way to enumerate map keys (#25712).
pulumi convert --help now has the correct blank line between the target languages list and example usage (#22559).up --plan, this surfaces errors that were previously swallowed.up --plan no longer fails in the NodeJS SDK when a stack output is a whole resource (#25629).pulumi package publish reference docs formatting is fixed (#25695).pyproject.toml files (#25735).pulumi new flow is easier to read (#25663).As part of #25751, several language/runtime components were upgraded:
No breaking changes or deprecations are called out in these release notes.
Update the Pulumi CLI directly:
curl -fsSL https://get.pulumi.com | sh -s -- --version 3.277.0Or via a package manager, for example Homebrew:
brew upgrade pulumiIf pinning the CLI or SDK version in CI, update the constraint accordingly, for example in a NodeJS package.json:
{
"dependencies": {
"@pulumi/pulumi": "^3.277.0"
}
}For projects using a provider plugin version lock, refresh plugins after upgrading the CLI:
pulumi plugin installConfirm the CLI is on the new version:
pulumi versionExpected output: v3.277.0
Run a preview against an existing stack to confirm the engine and provider changes behave as expected:
pulumi previewIf using the Automation API's new preview() method, run the automation script and confirm it returns a preview result without invoking the CLI manually.
v3.277.0 is a moderate release: the headline items are the preview pulumi delivery register command, Automation API preview() support for NodeJS, Python, and Go, and the --parent flag for pulumi state move. None of the changes require HCL rewrites, but teams using up --plan should note that previously silent plan violations are now reported. Upgrade via the standard CLI install path and re-run pulumi plugin install to pick up any provider refresh. Full details are on the release page.
Pulumi v3.273.0 adds resourceExists, extends Automation APIs, drops pulumi watch, and restricts AI agent auto-signup.
Pulumi v3.276.0 adds destroy, template, and insights commands to the generated Automation API for NodeJS, Python, and Go, plus a Node.js sdkgen import fix.
Pulumi 3.274.0 adds policy group/stack commands, Automation API schema/usage/api/audit-log support, and resourceExists for Go/Python.
terraform-docs v0.25.1 is a maintenance release. See what's in the changelog, how to upgrade, and how to verify your install.