postgresql_user – Добавить или удалить пользователя (роль) из экземпляра сервера PostgreSQL

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

Описание

• Добавляет или удаляет пользователя (роль) из экземпляра сервера PostgreSQL («кластер» в терминологии PostgreSQL) и, необязательно, предоставляет пользователю доступ к существующей базе данных или таблицам.
• Пользователь — это роль с правом входа.
• Основной функцией модуля является создание или удаление пользователей из экземпляров PostgreSQL. Назначение или удаление привилегий — необязательный шаг, который выполняется для одной базы данных за раз. Это позволяет вызывать модуль несколько раз в том же модуле для изменения разрешений в разных базах данных или для предоставления разрешений уже существующим пользователям.
• Пользователя нельзя удалить, пока от него не будут отозваны все привилегии. В такой ситуации, если модуль пытается удалить пользователя, он завершится ошибкой. Чтобы этого избежать, параметр fail_on_user сигнализирует модулю попытаться удалить пользователя, но если это невозможно, продолжить выполнение; модуль сообщит, были ли внесены изменения и отдельно, был ли удален пользователь или нет.

Требования

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

• psycopg2

Параметры

Примечания

См. также

Примеры

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

# 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
  postgresql_user:
    name: rails
    password: md59543f1d82624df2b31672ec0f7050460
    role_attr_flags: CREATEDB,NOSUPERUSER

- name: Connect to acme database and remove test user privileges from there
  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
  postgresql_user:
    db: test
    name: test
    priv: ALL
    state: absent

- name: Connect to acme database and set user's password with no expire date
  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
  postgresql_user:
    db: test
    user: test
    password: ""

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

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

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

Статус

• Данный модуль гарантирует обратную совместимость изменений интерфейса в дальнейшем. [stableinterface]
• Этот модуль поддерживается сообществом Ansible. [community]

Авторы

• Команда Ansible Core