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.
Example
For example, to generate a random string, simply allocate a resource:
const random = require("@pulumi/random");
const password = new random.RandomString("password", {
length: 16,
special: true,
overrideSpecial: "/@\" ",
});
From there we can use its result output property, of type Output<string>, to pass to another resource.
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/go/...
Reference
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
Hashes for pulumi_random-0.4.1.dev1551141308.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | da2e3c0f1e788b5b23cecafec9c2bab53a256bc7e52ee92c578d8e464dafccb5 |
|
MD5 | 7e1179a99ac6dff06f258515c199d275 |
|
BLAKE2b-256 | 1043d577969eeb3bcd93ef136045b7fd51e2d5021b2285cfffc2acdfba816a28 |