Setup a new computer

readme.md

net.markfaine

Overview

This project contains an Ansible collection for Ubuntu that is used to configure a user environment and to install dotfiles.

• bash with bash-it
• asdf
• git
• fzf
• nvim with NVChad
• node/npm
• python3 (libraries)
• ruby
• tmux
• wsl configuration (for WSL2 environments)
• wsl vpn-kit (for WSL2 environments)
• zsh with zim
• zoxide
• fonts from NerdFonts

Note: I am assuming the commands below will be all executed as the root user and the ansible remote_user will also be root.

Instructions

See Setup a new computer for the files referenced below.

1. Create an Ansible vault file as ~/.vault and edit the file to add the password:

default SUPER_SECRET_PASSWORD

2. Set permissions on vault file

chmod 600 ~.vault

3. Create an inventory file as ~/inventory.yml with the following contents:

---
# Edit the below as required
all:
  hosts:
    marks-pc.markfaine.net:
      ansible_connection: local
      ansible_python_interpreter: "{{ ansible_playbook_python }}"
      dns_servers: ['127.0.0.1'] # dns servers should be added here, used by wsl role
      github_username: markfaine # username may be different in github
      user_name: mfaine
      user_comment: "Mark Faine"
      user_uid: 1000
      user_gid: 1000
      user_group: mfaine
      user_groups: ['sudo']
      user_shell: /usr/bin/zsh
      user_font_list: ['Meslo'] # Optional list of fonts to install from NerdFonts or ['all'] to install them all
      stow_dotfiles_repo: '[email protected]:markfaine/dotfiles.git'

4. Create ~/ansible.cfg with the following contents:

[defaults]
action_warnings=False
ansible_managed = This file is managed by Ansible, all changes will be lost
inventory = ~/inventory.yml
log_path = ~/ansible.log
remote_user = root
nocows = True
retry_files_enabled = False
timeout = 60
vault_identity_list="default@~/.vault"

[ssh_connection]
pipelining = True
scp_if_ssh = True

5. Create ~/bootstrap.sh with the following contents:

#!/usr/bin/env bash
apt-get update &>/dev/null
apt-get install -y python3-venv whois passlib
python3 -m venv --system-site-packages /tmp/venv
chmod -R u+rwX,g+rX,o+rX /tmp/venv
. /tmp/venv/bin/activate
python3 -m pip install ansible

6. Run bootstrap.sh

chmod +x bootstrap.sh
./bootstrap.sh

7. Install the collection:

. /tmp/venv/bin/activate
ansible-galaxy collection install git+https://github.com/markfaine/net-markfaine.git

8. Run the playbook

ansible-playbook -l <HOSTNAME> \
  ~/.ansible/collections/ansible_collections/net/markfaine/playbooks/playbook.yml 

9. Logout and login as the non-root user

Pre-requisites for WSL vpn-kit installations

The steps below for WSL vpn-kit are not managed by the role and must be performed prior to running the wsl role.

Setup a distro

Download the prebuilt file wsl-vpnkit.tar.gz from the latest release to $env:USERPROFILE\wsl-vpnkit wsl-vpnkit.tar.gz and import the distro into WSL 2.

# Powershell

wsl --import wsl-vpnkit --version 2 $env:USERPROFILE\wsl-vpnkit wsl-vpnkit.tar.gz

Run the wsl role

ansible-playbook -l <HOSTNAME> \
  ~/.ansible/collections/ansible_collections/net/markfaine/playbooks/playbook.yml -t wsl

# You may want to run with connection=local if SSH is not available
ansible-playbook -l <HOSTNAME> --connection=local \
  ~/.ansible/collections/ansible_collections/net/markfaine/playbooks/playbook.yml -t wsl 

Shutdown WSL

# Get the default distro
wsl --list
# The verstion will be the item marked with (Default)
# for example: Ubuntu-24.10 (Default)
# Now run
C:\Windows\System32\wsl.exe --shutdown "THE_DEFAULT_DISTRO"
# For example:
C:\Windows\System32\wsl.exe --shutdown Ubuntu-24.10

Restart WSL and wsl-vpnkit should be installed.

ansible.cfg

[defaults]
action_warnings=False
ansible_managed = This file is managed by Ansible, all changes will be lost
inventory = ~/inventory.yml
log_path = ~/ansible.log
remote_user = root
nocows = True
retry_files_enabled = False
timeout = 60
vault_identity_list="default@~/.vault"

[ssh_connection]
pipelining = True
scp_if_ssh = True

bootstrap.sh

#!/usr/bin/env bash
apt-get update &>/dev/null
apt-get install -y python3-venv whois passlib
python3 -m venv --system-site-packages /tmp/venv
chmod -R u+rwX,g+rX,o+rX /tmp/venv
. /tmp/venv/bin/activate
python3 -m pip install ansible

inventory.yml

---
all:
  hosts:
    marks-pc.markfaine.net:
      ansible_connection: local
      ansible_python_interpreter: "{{ ansible_playbook_python }}"
      dns_servers: ['192.168.1.1'] # dns servers should be added here, used by wsl role
      github_username: markfaine # username may be different in github
      user_name: mfaine
      user_comment: "Mark Faine"
      user_uid: 1000
      user_gid: 1000
      user_group: mfaine
      user_groups: ['sudo']
      user_shell: /usr/bin/zsh
      stow_dotfiles_repo: '[email protected]:markfaine/dotfiles.git'      

Stable