1
0
mirror of https://github.com/gjkcz/ansible-void.git synced 2024-11-01 00:45:59 +01:00

Add readme

This commit is contained in:
Emil Miler 2023-04-29 21:03:43 +02:00
parent d88ed5f3d2
commit 0cc1da08f0

36
readme.md Normal file
View File

@ -0,0 +1,36 @@
Ansible files for managing classroom machines at GJK.
There are two classrooms, POV and POM. All machines are running [Void Linux](https://voidlinux.org/) with [Gnome](https://www.gnome.org/) in dual-boot with Windows.
GDM configuration can be found at <https://help.gnome.org/admin/system-admin-guide/stable/index.html.en>.
## New client installation
There are several differences in the hardware. System installation is usually done in EFI, though MBR still exists on older machines in POV.
- Install Void
- Update `xbps`
- Install `python3`
- Import your SSH key to `/root/.ssh/authorized_keys`
Void has `sshd` enabled by default as well as having `prohibit-password` set for root. Post-installation setup can be automated using a script or USB keyboard injector.
## Running a playbook
```
ansible-playbook setup.yaml
ansible-playbook -l teachers setup.yaml
ansible-playbook --key-file ~/.ssh/keys/gjk-ansible setup.yaml
```
## SSH configuration
You should setup your ssh to avoid unnecessary settings when running a playbook, for example:
```
Host VU* MU*
User root
IdentityFile ~/.ssh/keys/gjk-ansible
StrictHostKeyChecking no
UserKnownHostsFile=/dev/null
```