EvoBSD/README.md

49 lines
1.4 KiB
Markdown
Raw Normal View History

# EvoBSD
2018-12-28 11:23:49 +01:00
EvoBSD is an ansible project used for customising OpenBSD hosts used by Evolix.
2018-12-28 11:23:49 +01:00
## How to install an OpenBSD machine
**Note :** The system must be installed with a root account only.
2018-12-28 11:23:49 +01:00
1. Install ansible's prerequisites
2018-12-28 11:23:49 +01:00
```
ansible-playbook prerequisite.yml -CDi hosts -l HOSTNAME
```
2. Run it
2018-12-28 11:23:49 +01:00
The variables files evolix-main.yml and evolinux-secrets.yml are customized variables for Evolix that overwrite main.yml variables. They are not needed if you are not from Evolix.
First use (become_method: su) :
2020-09-10 11:54:21 +02:00
```
ansible-playbook evolixisation.yml --ask-vault-pass -CDki hosts -u root -l HOSTNAME
2020-09-10 11:54:21 +02:00
```
Subsequent use (become_method: sudo) :
2018-12-28 11:23:49 +01:00
```
ansible-playbook evolixisation.yml --ask-vault-pass -CDKi hosts --skip-tags pf -l HOSTNAME
2018-12-28 11:23:49 +01:00
```
## How to update scripts
Several tags in the format `*utils` are configured to update the different scripts, to be used with the update-utils.yml playbook :
* utils : update scripts from base role, utils.yml task
* motd-utils : update script from post-install role, motd.yml task
* evomaintenance-utils : update scripts from evomaintenance role, main.yml task
* evocheck-utils : update scripts from evocheck role, main.yml task
* nagios-nrpe-utils : update scripts and checks from nagios-nrpe role, main.yml task
* etc-git-utils : update scripts from etc-git role, utils.yml task
2018-12-28 11:23:49 +01:00
## Contributions
See the [contribution guidelines](CONTRIBUTING.md)
2018-12-28 11:23:49 +01:00
## License
2018-12-28 11:23:49 +01:00
2019-01-02 14:35:20 +01:00
[MIT License](LICENSE)