Sysconfig

This is an Ansible playbook to deploy my system configurations for desktop usage.

🧰 Usage

• Have a fresh installation of Alpine (after running setup-alpine and reboot)

• Install ansible-core and git

• Clone this repository

• Install needed external modules (e.g. apk, pamd, mount):

  ansible-galaxy collection install -r requirements/collections.yml
  

• Create an encrypted file to store your user password:

  mkdir -p host_vars/YOUR_HOSTNAME
  touch host_vars/YOUR_HOSTNAME/secrets.yml
  ansible-vault encrypt host_vars/YOUR_HOSTNAME/secrets.yml
  ansible-vault edit host_vars/YOUR_HOSTNAME/secrets.yml
  

  The file should look like this: vault_password: <strong_&_secure_password>

• Customize the variables in group_vars/all.yml.

  Some variables only accept a list of defined values. They are listed in requirements/accepted_variables.yml.

• Run the playbook:

  ansible-playbook setup.yml
  

• Reboot and login as the newly created normal user

• Proceed with dotfiles-ansible playbook

✔️ Testing

• You need to have Vagrant installed, with vagrant-libvirt plugin.
• Run the playbook inside the VM:

# Start the VM
vagrant up

# ssh into the VM (OpenSSH is required)
# Alternatively run 'vagrant ssh-config' to get the machine's IP address
# and manually ssh into it, e.g. 'dbclient -y vagrant@<ip_address>'
vagrant ssh

# Run the playbook as root
$ cd /vagrant
$ sudo ansible-playbook -v setup.yml

🖊️ Notes

• This playbook assumes that the person running it is me 😃. It might do specific tasks that you don't like. Use with your own risks.

• The playbook assumes it's only run once, so it doesn't take into account conflicted services when switching options in later runs.

• The playbook is intended to be run as root. It is separated from dotfiles-ansible, which should only be run as a normal user.

📄 License

MIT