A Pulumi package to safely use randomness in Pulumi programs.
Project description
Random Provider
The random provider allows the safe use of randomness in a Pulumi program. This allows you to generate resource properties, such as names, that contain randomness in a way that works with Pulumi's goal state oriented approach. Using randomness as usual would not work well with Pulumi, because by definition, each time the program is evaluated, a new random state would be produced, necessitating re-convergence on the goal state. This provider understands how to work with the Pulumi resource lifecycle to accomplish randomness safely and in a way that works as desired.
Installing
This package is available in many languages in the standard packaging formats.
Node.js (Java/TypeScript)
To use from JavaScript or TypeScript in Node.js, install using either npm
:
$ npm install @pulumi/random
or yarn
:
$ yarn add @pulumi/random
Python
To use from Python, install using pip
:
$ pip install pulumi_random
Go
To use from Go, use go get
to grab the latest version of the library
$ go get github.com/pulumi/pulumi-random/sdk/v4/go/...
.NET
To use from .NET, install using dotnet add package
:
$ dotnet add package Pulumi.Random
Example
For example, to generate a random password, allocate a RandomPassword
resource
and then use its result
output property (of type Output<string>
) to pass
to another resource.
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
import * as random from "@pulumi/random";
const password = new random.RandomPassword("password", {
length: 16,
overrideSpecial: "_%@",
special: true,
});
const example = new aws.rds.Instance("example", {
password: password.result,
});
Reference
For further information, please visit the random provider docs or for detailed reference documentation, please visit the API docs.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pulumi_random-4.15.0a1700114559.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 94f889ddcf43d56c4654fd7a1c7d67dba0c1ced4a6c174875109a940343c78a1 |
|
MD5 | 2dbd25ffedb8b41f7476c242315822f1 |
|
BLAKE2b-256 | 78ec4f7f775492d8a8ca5ab3adb7792da2b1f4b4b178cf76e5897910fbd47df9 |
Hashes for pulumi_random-4.15.0a1700114559-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7f1741df2dfa87315f773035aecc879ff945eb0944d6e882f84ddcda2b229474 |
|
MD5 | a5f88c96eee94f7fd9d2a81c5f048c21 |
|
BLAKE2b-256 | ee1dcec28faecb7c9afae40a5480f2a8a9befaca9987a4d1837e89f96ef1dc61 |