39 lines
2.5 KiB
ReStructuredText
39 lines
2.5 KiB
ReStructuredText
.. _postgresql_db:
|
|
|
|
postgresql_db
|
|
`````````````
|
|
|
|
.. versionadded:: 0.6
|
|
|
|
Add or remove PostgreSQL databases from a remote host.
|
|
|
|
The default authentication assumes that you are either logging in as or
|
|
sudo'ing to the postgres account on the host.
|
|
|
|
This module uses psycopg2, a Python PostgreSQL database adapter. You must
|
|
ensure that psycopg2 is installed on the host before using this module. If
|
|
the remote host is the PostgreSQL server (which is the default case), then
|
|
PostgreSQL must also be installed on the remote host. For Ubuntu-based systems,
|
|
install the postgresql, libpq-dev, and python-psycopg2 packages on the remote
|
|
host before using this module.
|
|
|
|
|
|
+--------------------+----------+----------+----------------------------------------------------------------------------+
|
|
| parameter | required | default | comments |
|
|
+====================+==========+==========+============================================================================+
|
|
| name | yes | | name of the database to add or remove |
|
|
+--------------------+----------+----------+----------------------------------------------------------------------------+
|
|
| login_user | no | postgres | user (role) used to authenticate with PostgreSQL |
|
|
+--------------------+----------+----------+----------------------------------------------------------------------------+
|
|
| login_password | no | | password used to authenticate with PostgreSQL |
|
|
+--------------------+----------+----------+----------------------------------------------------------------------------+
|
|
| login_host | no | | host running PostgreSQL. Default (blank) implies localhost |
|
|
+--------------------+----------+----------+----------------------------------------------------------------------------+
|
|
| owner | no | | name of the role to set as owner of the database |
|
|
+--------------------+----------+----------+----------------------------------------------------------------------------+
|
|
| state | | present | 'absent' or 'present' |
|
|
+--------------------+----------+----------+----------------------------------------------------------------------------+
|
|
|
|
Example action from Ansible :doc:`playbooks`::
|
|
|
|
postgresql_db db=acme
|