LinuxCommandLibrary

pulumi-env

Manage Pulumi environment configurations

TLDR

List all environments

$ pulumi env ls
copy

Create an environment
$ pulumi env init [environment_name]
copy

Set a value in an environment
$ pulumi env set [environment_name] [key] [value]
copy

Edit an environment definition
$ pulumi env edit [environment_name]
copy

Delete a value from an environment
$ pulumi env rm [environment_name] [key]
copy

Delete an environment entirely
$ pulumi env rm [environment_name]
copy

Display help
$ pulumi env --help
copy

SYNOPSIS

pulumi-env [command] [flags]

PARAMETERS

--help
    Show help message and exit.

--version
    Show version and exit.

DESCRIPTION

The `pulumi-env` command is a helper utility designed to simplify and secure the management of Pulumi environment variables, particularly those containing sensitive information like secrets or API keys. It provides mechanisms to load environment variables from various sources, including encrypted files and remote secrets management systems, without exposing the raw values directly in your shell or version control. This promotes better security practices by reducing the risk of accidentally committing sensitive data. The command facilitates creating, updating, and deleting environment variables used by Pulumi stacks. It's often used in CI/CD pipelines or automated deployment scenarios where you need to dynamically configure your Pulumi environment.

CAVEATS

The exact functionality and available commands within `pulumi-env` depend on the specific Pulumi provider and any custom extensions installed. Always refer to the provider's documentation for detailed usage instructions.

EXAMPLE USAGE

Loading variables from a file: pulumi-env load --file myvars.enc
Setting env value: pulumi-env set MY_VAR=myvalue
Getting env value: pulumi-env get MY_VAR

SECURITY CONSIDERATIONS

Always encrypt files containing sensitive environment variables. Use strong encryption methods and manage encryption keys securely to protect your data. Avoid storing secrets directly in your Pulumi code or state files.

SEE ALSO

pulumi(1), env(1), getopt(1)

Copied to clipboard