Pulumi CLI overview
Pulumi is controlled primarily using the command line interface (CLI). It works in conjunction with the Pulumi Cloud to deploy changes to your cloud apps and infrastructure. It keeps a history of who updated what in your team and when. This CLI has been designed for great inner loop productivity, in addition to continuous integration and delivery scenarios.
Installation
The Pulumi CLI is open source and free to use:
Common Commands
The most common commands in the CLI that you’ll be using are as follows:
pulumi new
: creates a new project using a templatepulumi stack
: manage your stacks (at least one is required to perform an update)pulumi config
: configure variables such as keys, regions, and so onpulumi up
: preview and deploy changes to your program and/or infrastructurepulumi preview
: preview your changes explicitly before deployingpulumi destroy
: destroy your program and its infrastructure when you’re done
Complete Reference
Below is the complete documentation for all available commands:
Pulumi command line
Synopsis
Pulumi - Modern Infrastructure as Code
To begin working with Pulumi, run the pulumi new
command:
$ pulumi new
This will prompt you to create a new project for your cloud and language of choice.
The most common commands from there are:
- pulumi up : Deploy code and/or resource changes
- pulumi stack : Manage instances of your project
- pulumi config : Alter your stack's configuration or secrets
- pulumi destroy : Tear down your stack's resources entirely
For more information, please visit the project page: https://www.pulumi.com/docs/
Options
--color string Colorize output. Choices are: always, never, raw, auto (default "auto")
-C, --cwd string Run pulumi as if it had been started in another directory
--disable-integrity-checking Disable integrity checking of checkpoint files
-e, --emoji Enable emojis in the output
-Q, --fully-qualify-stack-names Show fully-qualified stack names
-h, --help help for pulumi
--logflow Flow log settings to child processes (like plugins)
--logtostderr Log to stderr instead of to files
--memprofilerate int Enable more precise (and expensive) memory allocation profiles by setting runtime.MemProfileRate
--non-interactive Disable interactive mode for all commands
--profiling string Emit CPU and memory profiles and an execution trace to '[filename].[pid].{cpu,mem,trace}', respectively
--tracing file: Emit tracing to the specified endpoint. Use the file: scheme to write tracing data to a local file
-v, --verbose int Enable verbose logging (e.g., v=3); anything >3 is very verbose
SEE ALSO
- pulumi about - Print information about the Pulumi environment.
- pulumi cancel - Cancel a stack’s currently running update, if any
- pulumi config - Manage configuration
- pulumi console - Opens the current stack in the Pulumi Console
- pulumi convert - Convert Pulumi programs from a supported source program into other supported languages
- pulumi destroy - Destroy all existing resources in the stack
- pulumi env - Manage environments
- pulumi gen-completion - Generate completion scripts for the Pulumi CLI
- pulumi import - Import resources into an existing stack
- pulumi install - Install packages and plugins for the current program or policy pack.
- pulumi login - Log in to the Pulumi Cloud
- pulumi logout - Log out of the Pulumi Cloud
- pulumi logs - Show aggregated resource logs for a stack
- pulumi new - Create a new Pulumi project
- pulumi org - Manage Organization configuration
- pulumi package - Work with Pulumi packages
- pulumi plugin - Manage language and resource provider plugins
- pulumi policy - Manage resource policies
- pulumi preview - Show a preview of updates to a stack’s resources
- pulumi refresh - Refresh the resources in a stack
- pulumi schema - Analyze package schemas
- pulumi stack - Manage stacks and view stack state
- pulumi state - Edit the current stack’s state
- pulumi up - Create or update the resources in a stack
- pulumi version - Print Pulumi’s version number
- pulumi watch - Continuously update the resources in a stack
- pulumi whoami - Display the current logged-in user
Environment Variables
For a list of environment variables that you can use to work with the Pulumi CLI, see Environment Variables.
Thank you for your feedback!
If you have a question about how to use Pulumi, reach out in Community Slack.
Open an issue on GitHub to report a problem or suggest an improvement.