Ubuntu Desktop Ansible Playbook

This playbook installs and configures most of the software I use on Ubuntu.

Customization

• config.yml add or remove packages to be installed via tasks defined in tasks/loops/
• files/.dotfiles replace with your own dotfiles
• tasks/ add or remove unique ways of installations and configurations

Installation & Configuration

Manual steps

• Install Ubuntu from a flashdrive compliting the setup wizard (creating a local user account with a password).
• Update APT cache and upgrade the packages:

sudo apt update
sudo apt upgrade --yes

• Install NVIDIA drivers:

sudo ubuntu-drivers install

• Copy SSH keys with proper permissions:

chmod 600 <id>_rsa
chmod 600 <id>_rsa.pub

Automated steps

Requirements

• Install Ansible by running these commands:

sudo apt update && apt upgrade --yes
sudo apt install --yes curl git software-properties-common python3-pip
pip3 install ansible

• Clone this repository:

git clone git@github.com:annaghi/ansible-ubuntu-desktop.git

• Open files/.dotfiles/.gitconfig in the root of this repository, and change user.name and user.email to your own.

Run Ansible playbook

Go to the root of the cloned repository, and run this command. Enter your user account password when prompted for the BECOME password:

ansible-playbook main.playbook.yml --ask-become-pass

or narrow down the tasks with tags:

ansible-playbook main.playbook.yml --ask-become-pass --tags zsh,nvm

• Finally, reboot your system.

Development

Requirements

• Install Ansible and Ansible Lint by running these commands:

sudo apt update && apt upgrade --yes
sudo apt install --yes curl git software-properties-common python3-pip
pip3 install ansible ansible-lint

• Clone this repository:

git clone git@github.com:annaghi/ansible-ubuntu-desktop.git

• Now you can use Ansible in order to install Vagrant and VirtualBox by running this command in the root of this repository:

ansible-playbook dev.playbook.yml --ask-become-pass

Start, provision, ssh, and destroy virtual machine

vagrant up          # Start the VM, and generate .vagrant directory
vagrant provision   # Re-run playbook
vagrant ssh-config  # Print SSH config
vagrant ssh         # SSH into the VM
vagrant destroy     # Destroy the VM for good