diff --git a/knowledge base/pulumi.md b/knowledge base/pulumi.md
index d888063..de18be2 100644
--- a/knowledge base/pulumi.md
+++ b/knowledge base/pulumi.md
@@ -8,6 +8,9 @@
## TL;DR
+When a stack is not explicitly requested in a command (`-s`, `--stack`), Pulumi defaults to the current one.
+Target single resources with `-t`, `--target`. Target also their dependencies with `--target-dependents`.
+
Installation
@@ -27,14 +30,27 @@ pulumi completion 'fish' > "$HOME/.config/fish/completions/pulumi.fish"
Usage
```sh
+# List available templates.
+pulumi new -l
+pulumi new --list-templates
+
+# Create new projects in the current directory.
+# Creates basic scaffolding files based on the specified cloud and language.
+pulumi new
+pulumi new 'aws-go' -d 'description' -n 'name'
+pulumi new 'azure-python' --dir '.' -s 'stack' --name 'name'
+pulumi new 'gcp-typescript' --description 'description' --stack 'stack'
+pulumi new 'kubernetes-yaml' --generate-only
+pulumi new 'oci-java'
+
+
# Operate entirely from the local machine (local-only mode).
# Stores the state under the '.pulumi' folder in the given directory.
pulumi login --local
pulumi login "file://~"
pulumi login "file://."
pulumi login "file://path/to/folder"
-yq '. += {"backend": {"url": "file://."}}' 'path/to/program/Pulumi.yaml' \
- | sponge 'path/to/program/Pulumi.yaml'
+yq -iy '. += {"backend": {"url": "file://."}}' 'Pulumi.yaml'
# Store the state in object storage backends.
pulumi login 'azblob://state-bucket'
@@ -50,24 +66,18 @@ pulumi whoami -v
pulumi logout
-# List available templates.
-pulumi new -l
-pulumi new --list-templates
-
-# Create new projects in the current directory.
-# Creates basic scaffolding files based on the specified cloud and language.
-pulumi new
-pulumi new 'aws-go' -d 'description' -n 'name'
-pulumi new 'azure-python' --dir '.' -s 'stack' --name 'name'
-pulumi new 'gcp-typescript' --description 'description' --stack 'stack'
-pulumi new 'kubernetes-yaml'
-pulumi new 'oci-java'
-
-
# Get the full program configuration.
# Secrets are obscured.
pulumi config get
+# Set configuration values.
+pulumi config set
+
+# Copy the configuration over to other stacks.
+pulumi config cp -d 'local'
+pulumi config cp -s 'prod' -d 'dev'
+
+
# Set secrets.
pulumi config set --secret 'dbPassword' 'S3cr37'
@@ -82,7 +92,7 @@ pulumi config get 'dbPassword'
pulumi pre
pulumi pre --diff -p '10' -m 'message' -s 'stack'
pulumi pre --expect-no-changes --parallel '10' --show-reads
-pulumi preview -t 'targetResourceUrn'
+pulumi preview -t 'targetResourceUrn' --target-dependents
# Save any resource creation seen during the preview into an import file to use
# with the `import` subcommand.
@@ -121,19 +131,30 @@ pulumi stack ls
pulumi stack ls -o 'organization' -p 'project' -t 'tag'
pulumi stack ls -a
-# Export stacks.
+# Create stacks.
+pulumi stack init 'prod'
+pulumi stack init 'local' --copy-config-from 'dev' --no-select
+
+# Export stacks' state.
pulumi stack export
pulumi stack export -s 'dev' --show-secrets --file 'dev.stack.json'
-# Create graphs of the dependency relations.
-pulumi stack graph 'path/to/graph.dot'
-pulumi stack graph -s 'dev' 'dev.dot' --short-node-name
+# Import stacks' state.
+pulumi stack import --file 'dev.stack.json'
+pulumi stack import -s 'local' --file 'dev.stack.json'
+
+# Change the current stack.
+pulumi select 'prod'
# Delete stacks.
pulumi stack rm
pulumi stack rm -fy
pulumi stack rm --preserve-config --yes --stack 'stack'
+# Create graphs of the dependency relations.
+pulumi stack graph 'path/to/graph.dot'
+pulumi stack graph -s 'dev' 'dev.dot' --short-node-name
+
# Rename resources in states.
pulumi state rename 'resourceUrn' 'newName'
@@ -181,15 +202,25 @@ pulumi stack export \
| yq -r '.deployment.resources[]|select(.id=="myBucket").urn' - \
| xargs -n 1 pulumi refresh --preview-only -t
-# Change backend.
+# Migrate backend.
# From Pulumi Cloud to S3.
pulumi login \
&& pulumi stack select 'myOrg/dev' \
&& pulumi stack export --show-secrets --file 'dev.stack.json' \
&& pulumi logout \
-&& pulumi login 's3://myBucket/myOrg/dev' \
+&& pulumi login 's3://myBucket/prefix' \
&& pulumi stack init 'dev' \
&& pulumi stack import --file 'dev.stack.json'
+
+# Use a local state for testing.
+# Remote state on S3.
+mkdir -pv '.pulumi/stacks/myWonderfulInfra' \
+&& aws s3 cp \
+ 's3://myBucket/prefix/.pulumi/stacks/myWonderfulInfra/prod.json' \
+ '.pulumi/stacks/myWonderfulInfra/' \
+&& yq -iy '. += {"backend": {"url": "file://."}}' 'Pulumi.yaml'
+# Revert to the remote state.
+yq -iy '. += {"backend": {"url": "s3://myBucket/prefix"}}' 'Pulumi.yaml'
```