community.general.postgresql_user – Создание, изменение или удаление пользователя (роли) на сервере PostgreSQL

• Описание
• Требования
• Параметры
• Примечания
• См. также
• Примеры
• Возвращаемые значения

Описание

• Создаёт, изменяет или удаляет пользователя (роль) на сервере PostgreSQL (в терминологии PostgreSQL — «кластер») и, при необходимости, предоставляет пользователю доступ к существующей базе данных или таблицам.
• Пользователь — это роль с привилегией входа.
• Также можно использовать для предоставления или отзыва привилегий пользователя в конкретной базе данных.
• Нельзя удалить пользователя, пока он имеет какие-либо привилегии в любой базе данных.
• Установите fail_on_user в no чтобы модуль игнорировал ошибки при попытке удаления пользователя. В этом случае модуль, как обычно, сообщает о произошедших изменениях и дополнительно — об удалении или неудалении пользователя.

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

• psycopg2

Параметры

Примечания

См. также

Примеры

- name: Connect to acme database, create django user, and grant access to database and products table
  community.general.postgresql_user:
    db: acme
    name: django
    password: ceec4eif7ya
    priv: "CONNECT/products:ALL"
    expires: "Jan 31 2020"

- name: Add a comment on django user
  community.general.postgresql_user:
    db: acme
    name: django
    comment: This is a test user

# Connect to default database, create rails user, set its password (MD5-hashed),
# and grant privilege to create other databases and demote rails from super user status if user exists
- name: Create rails user, set MD5-hashed password, grant privs
  community.general.postgresql_user:
    name: rails
    password: md59543f1d82624df2b31672ec0f7050460
    role_attr_flags: CREATEDB,NOSUPERUSER

- name: Connect to acme database and remove test user privileges from there
  community.general.postgresql_user:
    db: acme
    name: test
    priv: "ALL/products:ALL"
    state: absent
    fail_on_user: no

- name: Connect to test database, remove test user from cluster
  community.general.postgresql_user:
    db: test
    name: test
    priv: ALL
    state: absent

- name: Connect to acme database and set user's password with no expire date
  community.general.postgresql_user:
    db: acme
    name: django
    password: mysupersecretword
    priv: "CONNECT/products:ALL"
    expires: infinity

# Example privileges string format
# INSERT,UPDATE/table:SELECT/anothertable:ALL

- name: Connect to test database and remove an existing user's password
  community.general.postgresql_user:
    db: test
    user: test
    password: ""

- name: Create user test and grant group user_ro and user_rw to it
  community.general.postgresql_user:
    name: test
    groups:
    - user_ro
    - user_rw

# Create user with a cleartext password if it does not exist or update its password.
# The password will be encrypted with SCRAM algorithm (available since PostgreSQL 10)
- name: Create appclient user with SCRAM-hashed password
  community.general.postgresql_user:
    name: appclient
    password: "secret123"
  environment:
    PGOPTIONS: "-c password_encryption=scram-sha-256"

Значения возврата

Общие значения возврата описаны здесь, а ниже приведены поля, уникальные для данного модуля:

Авторы

• Команда разработчиков Ansible