users

Статус сборки

ansible-users

Роль для управления пользователями на системе.

Настройки роли

  • users_create_per_user_group (по умолчанию: true) - при создании пользователей также создается группа с таким же именем, и она становится основной группой пользователя.
  • users_group (по умолчанию: users) - если users_create_per_user_group не установлен, тогда это основная группа для всех созданных пользователей.
  • users_default_shell (по умолчанию: /bin/bash) - оболочка по умолчанию, если для пользователя не указана.
  • users_create_homedirs (по умолчанию: true) - создать домашние директории для новых пользователей. Установите значение false, если вы управляете домашними директориями отдельно.
  • authorized_keys_file (по умолчанию: .ssh/authorized_keys) - укажите это, если ssh-сервер настроен на использование нестандартного файла авторизованных ключей.

Создание пользователей

Добавьте переменную users, содержащую список пользователей для добавления. Хорошее место для этого - в group_vars/all или group_vars/groupname, если вы хотите, чтобы пользователи были только на определенных машинах.

Следующие атрибуты обязательны для каждого пользователя:

  • username - Имя пользователя.
  • name - Полное имя пользователя (поле gecos).
  • home - Домашняя директория пользователя для создания (опционально, по умолчанию /home/username).
  • uid - Числовой идентификатор пользователя (опционально). Необходим для обеспечения согласованности uid между системами.
  • gid - Числовой идентификатор группы (опционально). В противном случае будет использован uid.
  • password - Если указан хэш, то он будет использован, в противном случае аккаунт будет заблокирован.
  • update_password - Может быть либо 'always', либо 'on_create'
    • 'always' будет обновлять пароли, если они отличаются. (по умолчанию)
    • 'on_create' будет устанавливать пароль только для вновь созданных пользователей.
  • group - Необязательный переопределение основной группы.
  • groups - Список дополнительных групп для пользователя.
  • append - Если да, то будет только добавлять группы, а не устанавливать их только в списке groups (опционально).
  • profile - Строковый блок для установки пользовательских оболочек.
  • ssh_key - Это должен быть список SSH-ключей для пользователя (опционально). Каждый SSH-ключ должен быть включен напрямую и не должен содержать переносов строк.
  • generate_ssh_key - Генерировать ли SSH-ключ для пользователя (опционально, по умолчанию - нет).

Кроме того, следующие элементы являются опциональными для каждого пользователя:

  • shell - Оболочка пользователя. По умолчанию это /bin/bash. По умолчанию это настраивается с помощью переменной users_default_shell, если вы хотите дать всем пользователям одну и ту же оболочку, но она отличается от /bin/bash.

Пример:

---
users:
  - username: foo
    name: Фу Баррингтон
    groups: ['wheel','systemd-journal']
    uid: 1001
    home: /local/home/foo
    profile: |
      alias ll='ls -lah'
    ssh_key:
      - "ssh-rsa AAAAA.... foo@machine"
      - "ssh-rsa AAAAB.... foo2@machine"
groups_to_create:
  - name: разработчики
    gid: 10000
users_deleted:
  - username: bar
    name: Бар Пользователь
    uid: 1002

Удаление пользователей

Переменная users_deleted содержит список пользователей, которые больше не должны быть в системе, и они будут удалены при следующем запуске ansible. Формат такой же, как для добавления пользователей, но единственное обязательное поле - username. Однако рекомендуется также сохранять поле uid для справки, чтобы числовые идентификаторы пользователей не были случайно переиспользованы.

Вы можете по желанию выбрать удаление домашней директории пользователя и почтового ящика с помощью параметра remove, а также принудительно удалить файлы с помощью параметра force.

users_deleted:
  - username: bar
    uid: 1002
    remove: yes
    force: yes
О проекте

User creation role

Установить
ansible-galaxy install singleplatform-eng/ansible-users
Лицензия
mit
Загрузки
8414146
Владелец
Open source code from the SinglePlatform Engineering team.