Manjaro/Arch Linux Ansible Provision

This is an Ansible playbook meant to configure a Manjaro OS (Arch Linux distribution) GNOME 3 desktop. It should run locally after a clean OS install.

This playbook follows the Manjaro community recommendation when installing the additional software packages from the Arch User Repository:

• Using Arch Linux Package Manager pacman to install Arch Linux official packages
• Using the command line Pamac for a more automated way of installing AUR packages
• Using a bespoke script install-aur.sh to provide a "manual installation" for AUR packages

🪧 Table of contents

• Manjaro/Arch Linux Ansible Provision
  • 🪧 Table of contents
  • Provision and configure a Vagrant VM
    • Provision and configure a Manjaro Vagrant VM
  • Run and configure the localhost machine
    • Install everything
    • Install everything with debug turned on
    • Install only the 'dev-tools' role with minimal logging
  • 🧰 Playbook Roles
  • 🚀 Instructions to install a new Manjaro image
    • 1. Creating Bootable Linux USB Drive from the Command Line
    • 2. Refresh pacaman mirrors, the copy of the master package database from the server and install ansible, git and xclip
    • 3. Set Git SSH credentials
    • 4. Git clone the current project
  • ☁️ Google Cloud Configuration
  • 🚧 TODO

Provision and configure a Vagrant VM

Before applying the changes against your desktop/laptop, being able to test against a Docker container or a Vagrant VM machine allows to test the playbook safer, quicker and often.

Since this is a Manjaro/Arch Desktop setup, having a Virtual Box to be able to login and inspect the UI is somewhat useful, although this is still an experimentation as the preferred approach was to opt for a Docker container.

The Vagrant VM box is based on a Manjaro Gnome X64 21.0 box. This should not be an issue if you want the latest Manjaro release, as the playbook will upgrade the VM to the lastest Manjaro release version.

Provision and configure a Manjaro Vagrant VM

Install and configure Vagrant & Oracle VirtualBox locally

# if from a different Linux distribution or on a Mac make sure to install Vagrant and Oracle
# if you are using a Manjaro/Arch, install and configure Vagrant & Oracle VirtualBox locally
ansible-playbook playbook.yml -l localhost --extra-vars="user_name=USERNAME user_git_name=GIT_USERNAME" --ask-become-pass --tags virtualization

#Provision the Vagrant box
vagrant up --provision

# Run Ansible playbook against the Vagrant VM
ansible-playbook playbook.yml -l testbuild --extra-vars="user_name=USERNAME user_git_name=GIT_USERNAME user_email=EMAIL" --ask-become-pass

Run and configure the localhost machine

Install everything

ansible-lint
ansible-playbook playbook.yml -l localhost --extra-vars="user_name=USERNAME user_git_name=GIT_USERNAME user_email=EMAIL" --ask-become-pass

Install everything with debug turned on

ansible-lint
ansible-playbook -vvvv playbook.yml -l localhost --extra-vars="user_name=USERNAME user_git_name=GIT_USERNAME user_email=EMAIL" --ask-become-pass

Install only the 'dev-tools' role with minimal logging

ansible-lint
ansible-playbook -v playbook.yml -l localhost --extra-vars="user_name=USERNAME user_git_name=GIT_USERNAME user_email=EMAIL" --ask-become-pass --tags dev-tools

🧰 Playbook Roles

Roles supported:

Example on how to install only browsers:

ansible-playbook playbook.yml --extra-vars="user_name=USERNAME user_git_name=GIT_USERNAME user_email=EMAIL" --ask-become-pass --tags browsers

🚀 Instructions to install a new Manjaro image

1. Creating Bootable Linux USB Drive from the Command Line

Find out the name of the USB drive

lsblk

Flash the ISO image to the USB drive

dd bs=4M if=/path/to/iso of=/dev/sdx status=progress oflag=sync

Change boot order and install Manjaro.

2. Refresh pacaman mirrors, the copy of the master package database from the server and install ansible, git and xclip

After installing Manjaro, ensure that ansible, git and xclip are installed

sudo pacman-mirrors -f && sudo pacman -Syyu
sudo pacman -S ansible ansible-lint git xclip --noconfirm

3. Set Git SSH credentials

Generate a new SSH Key

ssh-keygen -t rsa -b 4096 -C "[email protected]"

Start the ssh-agent in the background

eval "$(ssh-agent -s)"

Add SSH Key to the ssh-agent

ssh-add ~/.ssh/id_rsa

Copy the SSH public key to the clipboard

xclip -sel clip < ~/.ssh/id_rsa.pub

4. Git clone the current project

git clone [email protected]:PauloPortugal/manjaro-playbook.git
cd manjaro-playbook

☁️ Google Cloud Configuration

On the command line run

gcloud init
gcloud auth login

For more information about Gcloud command lines read https://cloud.google.com/sdk/gcloud

🚧 TODO

1. It would be nice to include more audio-tools.