pulumi-local 1.2.1

Thin wrapper script to use Pulumi with LocalStack

Pulumi CLI for LocalStack

DISCLAIMER: pulumi-local currently does not support the aws-native package. (pulumi/pulumi-aws-native #108)

This package provides the pulumilocal command, which is a thin wrapper around the pulumi command line interface to use Pulumi with LocalStack.

Installation

You can install the pulumilocal command via pip:

pip install pulumi-local

Prerequisites

Please make sure you have a LocalStack instance running on your local machine.

Usage

The pulumilocal command has the same usage as the pulumi command. For detailed usage, please refer to the man pages of pulumi -h.

Add environment variables to store state on local backend (optional)

export PULUMI_CONFIG_PASSPHRASE=lsdevtest
export PULUMI_BACKEND_URL=file://`pwd`/myproj

Note: For further options please consult the official documentation on available environment variables and local backend.

Create a new Pulumi project with stack name lsdev

mkdir myproj
pulumilocal new typescript -y -s lsdev --cwd myproj

Note: --cwd switch is unnecessary if commands are being run in project directory.

Select and create the lsdev Pulumi stack

This is unnecessary if you just did the new typescript command above as it will already be selected.

pulumilocal stack select -c lsdev --cwd myproj

Deploy the stack to LocalStack

pulumilocal up --cwd myproj

How it works

When running any pulumi deployment command like pulumilocal ["up", "destroy", "preview", "cancel"], the wrapper script runs the pulumi config command to augment the pulumi config with LocalStack AWS configuration, and then runs the original pulumi command.

Configurations

You can configure the following environment variables:

• AWS_ENDPOINT_URL: hostname and port of the target LocalStack instance
• LOCALSTACK_HOSTNAME: (Deprecated) Target host to use for connecting to LocalStack (default: localhost)
• EDGE_PORT: (Deprecated) Target port to use for connecting to LocalStack (default: 4566)
• PULUMI_CMD: Name of the executable Pulumi command on the system PATH (default: pulumi)

Deploying to AWS

Use your preferred Pulumi backend. https://www.pulumi.com/docs/concepts/state/#deciding-on-a-state-backend Change the pulumilocal command in the instructions above to pulumi.

Change Log

• v1.2.1: Add support for AWS_ENDPOINT_URL env variable
• v1.2.0: Added dynamic endpoint generation and tests
• v1.1: Added README to long description and update twine publish.
• v1.0: Using pulumi config set-all to set all the AWS provider configurating instead of modifying the Stack file directly. Removed defaulting the stack name to localstack. Added argparse. Removed pyyaml dependency. Removed python2 package classifiers.
• v0.6: Replace deprecated s3ForcePathStyle with s3UsePathStyle in default config
• v0.5: Remove deprecated mobileanalytics service config to fix invalid key error
• v0.4: Point pulumilocal.bat to the correct script
• v0.3: Add apigatewayv2 service endpoint
• v0.2: Add init command and add aws:region key by default
• v0.1: Initial release

License

This software library is released under the Apache License, Version 2.0 (see LICENSE).