Files
opentf/website/source/docs/providers/postgresql/index.html.markdown
Martin Atkins 220d73f32c provider/postgresql: default ssl_mode is "prefer"
According to the libpq documentation, "prefer" is the default in the
underlying library and so setting a different default in the Terraform
layer would be a breaking change for existing users of this provider
whose servers do not have TLS correctly configured.

The docs now link to the libpq manual's discussion of the security
implications of each of the ssl_mode options, so the user can understand
the limitations of the "prefer" default and can make an informed decision
about which setting is appropriate for their situation.
2016-04-17 08:32:02 -07:00

1.7 KiB

layout, page_title, sidebar_current, description
layout page_title sidebar_current description
postgresql Provider: PostgreSQL docs-postgresql-index A provider for PostgreSQL Server.

PostgreSQL Provider

The PostgreSQL provider gives the ability to deploy and configure resources in a PostgreSQL server.

Use the navigation to the left to read about the available resources.

Usage

provider "postgresql" {
  host = "postgres_server_ip"
  port = 5432
  username = "postgres_user"
  password = "postgres_password"
  ssl_mode = "require"
}

Configuring multiple servers can be done by specifying the alias option.

provider "postgresql" {
  alias = "pg1"
  host = "postgres_server_ip1"
  username = "postgres_user1"
  password = "postgres_password1"
}

provider "postgresql" {
  alias = "pg2"
  host = "postgres_server_ip2"
  username = "postgres_user2"
  password = "postgres_password2"
}

resource "postgresql_database" "my_db1" {
  provider = "postgresql.pg1"
  name = "my_db1"
}
resource "postgresql_database" "my_db2" {
  provider = "postgresql.pg2"
  name = "my_db2"
}


Argument Reference

The following arguments are supported:

  • host - (Required) The address for the postgresql server connection.
  • port - (Optional) The port for the postgresql server connection. The default is 5432.
  • username - (Required) Username for the server connection.
  • password - (Optional) Password for the server connection.
  • ssl_mode - (Optional) Set the priority for an SSL connection to the server. The default is prefer; the full set of options and their implications can be seen in the libpq SSL guide.