Skip to main content

A Pulumi package to safely use randomness in Pulumi programs.

Project description

Actions Status Slack NPM version NuGet version Python version PkgGoDev License

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

pulumi_random-4.18.2.tar.gz (21.4 kB view details)

Uploaded Source

Built Distribution

pulumi_random-4.18.2-py3-none-any.whl (31.2 kB view details)

Uploaded Python 3

File details

Details for the file pulumi_random-4.18.2.tar.gz.

File metadata

  • Download URL: pulumi_random-4.18.2.tar.gz
  • Upload date:
  • Size: 21.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.8

File hashes

Hashes for pulumi_random-4.18.2.tar.gz
Algorithm Hash digest
SHA256 b63f810c9adb6150b55fca1159c8804f961e928365b02cc54775d31c16185148
MD5 e5bc57abea308091593e7e374725e6a0
BLAKE2b-256 1cd3b162d6852160ff3837995b45bd71fa00af74aea59d5315a6a2ebef290c25

See more details on using hashes here.

File details

Details for the file pulumi_random-4.18.2-py3-none-any.whl.

File metadata

  • Download URL: pulumi_random-4.18.2-py3-none-any.whl
  • Upload date:
  • Size: 31.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.8

File hashes

Hashes for pulumi_random-4.18.2-py3-none-any.whl
Algorithm Hash digest
SHA256 67cef99633d2bdf839324882d779503900b8d81f8f5fb73007d5f3794a5e859b
MD5 f61b039d94447e55e0ac5e7b188a264a
BLAKE2b-256 fe94cfcf1fff9d5818a4ed5958ca07bcb464c9670929473a8d969a33c30fb823

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page