1
0
mirror of https://github.com/gjkcz/ansible-void.git synced 2024-11-23 00:56:00 +01:00
ansible-void/readme.md
2023-11-01 15:52:24 +01:00

50 lines
1.6 KiB
Markdown

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`: `xbps-install -Su xbps`
- Install `python3` and `avahi`: `xbps-install python3 avahi`
- Enable `avahi` service: `ln -s /etc/sv/avai-deamon/ /var/service/`
- Enable `sshd` service: `ln -s /etc/sv/sshd/ /var/service`
- Import your SSH key to `/root/.ssh/authorized_keys`
Void has `prohibit-password` for root in the default `sshd` configuration. Post-installation setup can be automated using a script or USB keyboard injector.
## Running a playbook
Here are some examples for running a playbook.
```
ansible-playbook setup.yaml
ansible-playbook -l teachers setup.yaml
ansible-playbook -l VU00.local setup.yaml
ansible-playbook --key-file ~/.ssh/keys/gjk-ansible setup.yaml
```
Tags can be used to execute or exclude specific parts of the playbook.
```
ansible-playbook -t grub setup.yaml
ansible-playbook -t [grub, software] setup.yaml
ansible-playbook --skip-tags software 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
```