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
ansible-galaxy install singleplatform-eng/ansible-users