Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/juju4/ansible-adduser
simple ansible role to add a unix user with its ssh key
https://github.com/juju4/ansible-adduser
Last synced: 2 months ago
JSON representation
simple ansible role to add a unix user with its ssh key
- Host: GitHub
- URL: https://github.com/juju4/ansible-adduser
- Owner: juju4
- License: bsd-2-clause
- Created: 2016-02-14T20:46:56.000Z (almost 9 years ago)
- Default Branch: main
- Last Pushed: 2024-11-06T21:44:46.000Z (2 months ago)
- Last Synced: 2024-11-06T22:27:05.047Z (2 months ago)
- Language: Shell
- Size: 477 KB
- Stars: 9
- Watchers: 2
- Forks: 9
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
[](https://github.com/juju4/ansible-adduser/actions?query=branch%3Amaster)
[](https://github.com/juju4/ansible-adduser/actions?query=branch%3Adevel)
# adduser ansible role
A simple ansible role to add a unix user with its ssh key.
## Requirements & Dependencies
### Ansible
It was tested on the following versions:
* 1.9
* 2.0 (required for Windows)
* 2.3
* 2.4
* 2.5
### Operating systems
Tested on Ubuntu 14.04, 16.04, 18.04, Centos 6, 7 and OpenBSD 5.8.
## Example Playbook
Just include this role in your list.
For example
```
- host: myhost
roles:
- juju4.adduser
```
you probably want to review variables
## Variables
```
adduser_user_name: deploy
adduser_user_comments: ""
adduser_sudoroot: true
adduser_password: change_me_or_die!
adduser_public_keys:
- dummykey.pub
```
* adduser_user_name: username to add
* adduser_password: input should be hash except for darwin. please use ansible vault to store your real password
* adduser_public_keys: list of corresponding authorized keys
## Continuous integration
This role has a travis basic test (for github), more advanced with kitchen and also a Vagrantfile (test/vagrant).
Default kitchen config (.kitchen.yml) is lxd-based, while (.kitchen.vagrant.yml) is vagrant/virtualbox based.
Once you ensured all necessary roles are present, You can test with:
```
$ gem install kitchen-ansible kitchen-lxd_cli kitchen-sync kitchen-vagrant
$ cd /path/to/roles/juju4.adduser
$ kitchen verify
$ kitchen login
$ KITCHEN_YAML=".kitchen.vagrant.yml" kitchen verify
```
or
```
$ cd /path/to/roles/juju4.adduser/test/vagrant
$ vagrant up
$ vagrant ssh
```
or
```
$ pip install molecule docker
$ molecule test
$ MOLECULE_DISTRO=ubuntu:20.04 molecule test --destroy=never
```
## Troubleshooting & Known issues
* under OpenBSD, leaving password field cause an issue.
* ```repomd.xml does not match metalink for epel``` on Centos/Redhat
uncomment baselist and comment mirrorlist in /etc/yum.repos.d/epel.repo
(http://stackoverflow.com/questions/30949707/centos-6-6-errno-1-repomd-xml-does-not-match-metalink-for-updates-when-tryin)
Centos6 might also need ansible 2.1 (not 2.2) because of ```ERROR! Unexpected Exception: 'module' object has no attribute 'HAVE_DECL_MPZ_POWM_SEC'```
## License
BSD 2-clause