Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

Actions Status Slack NPM version Python version NuGet version PkgGoDev License

postgresql Resource Provider

The postgresql resource provider for Pulumi lets you manage postgresql resources in your cloud programs. To use this package, please install the Pulumi CLI first.

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/postgresql

or yarn:

$ yarn add @pulumi/postgresql

Python

To use from Python, install using pip:

$ pip install pulumi_postgresql

Go

To use from Go, use go get to grab the latest version of the library

$ go get github.com/pulumi/pulumi-postgresql/sdk/v3

.NET

To use from .NET, install using dotnet add package:

$ dotnet add package Pulumi.Postgresql

Configuration

The following configuration points are available:

  • postgresql:host - (required) The address for the postgresql server connection. Can also be specified with the PGHOST environment variable.
  • postgresql:port - (optional) The port for the postgresql server connection. The default is 5432. Can also be specified with the PGPORT environment variable.
  • postgresql:database - (optional) Database to connect to. The default is postgres. Can also be specified with the PGDATABASE environment variable.
  • postgresql:username - (required) Username for the server connection. The default is postgres. Can also be specified with the PGUSER environment variable.
  • postgresql:password - (optional) Password for the server connection. Can also be specified with the PGPASSWORD environment variable.
  • postgresql:database_username - (optional) Username of the user in the database if different than connection username (See user name maps).
  • postgresql:superuser - (optional) Should be set to false if the user to connect is not a PostgreSQL superuser (as is the case in RDS). In this case, some features might be disabled (e.g.: Refreshing state password from database).
  • postgresql:sslmode - (optional) Set the priority for an SSL connection to the server. Valid values for sslmode are (note: prefer is not supported by Go's lib/pq):
    • disable - No ssl
    • require - always SSL (the default, also skip verification)
    • verify-ca - always SSL (verify that the certificate presented by the server was signed by a trusted CA)
    • verify-full - Always SSL (verify that the certification presented by the server was signed by a trusted CA and the server host name matches the one in the certificate) Additional information on the options and their implications can be seen in the libpq(3) SSL guide. Can also be specified with the PGSSLMODE environment variable.
  • postgresql:connect_timeout - (optional) Maximum wait for connection, in seconds. The default is 180s. Zero or not specified means wait indefinitely. Can also be specified with the PGCONNECT_TIMEOUT environment variable.
  • postgresql:max_connections - (optional) Set the maximum number of open connections to the database. The default is 4. Zero means unlimited open connections.
  • postgresql:expected_version - (optional) Specify a hint to Terraform regarding the expected version that the provider will be talking with. This is a required hint in order for the provider to talk with an ancient version of PostgreSQL. This parameter is expected to be a PostgreSQL Version or current. Once a connection has been established, the provider will fingerprint the actual version. Default: 9.0.0.
  • postgresql:clientcert - (optional) Clientcert block for configuring SSL certificate.
    • postgresql:clientcert.cert - (required) The SSL client certificate file path. The file must contain PEM encoded data.
    • postgresql:clientcert.key - (required) The SSL client certificate private key file path. The file must contain PEM encoded data.

Reference

For further information, please visit the postgresql provider docs or for detailed reference documentation, please visit the API docs.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pulumi_postgresql-3.19.0a1785482078.tar.gz (51.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pulumi_postgresql-3.19.0a1785482078-py3-none-any.whl (76.9 kB view details)

Uploaded Python 3

File details

Details for the file pulumi_postgresql-3.19.0a1785482078.tar.gz.

File metadata

File hashes

Hashes for pulumi_postgresql-3.19.0a1785482078.tar.gz
Algorithm Hash digest
SHA256 f2baabd85283e1f7c813e380ef185729c8b41ae9e57c72a41be16d324012a786
MD5 cb147281df8756a9bde0d6a1f2671b08
BLAKE2b-256 b94ed7627b9ba126128c63aefd9923133da2c3eed704c7cbc81ece3efdd60c1a

See more details on using hashes here.

File details

Details for the file pulumi_postgresql-3.19.0a1785482078-py3-none-any.whl.

File metadata

File hashes

Hashes for pulumi_postgresql-3.19.0a1785482078-py3-none-any.whl
Algorithm Hash digest
SHA256 298706c869eb9c28b5d63121663308d50d7a71f1280cf649e742a87b071f84e5
MD5 38f035472a23d2426e4e11a94e9e6173
BLAKE2b-256 461bbfa7f64ab1a6af0bba7e1a2076b7152970ed52f39ea6cedf42eded116f17

See more details on using hashes here.

Release history Release notifications | RSS feed

Supported by

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