RICE scripts for configuring a Ubuntu desktop environment.
This repo houses two components: an Ansible playbook and a command line utility.
The Ansible playbook is responsible for doing 98% of the configuration and
installation on the system. The core tag will setup some common tooling, the
SwayWM window manager with all my presets and scripts, and a functioning
development environment. Other tags may or may not be available for special
situations such as a laptop or macbook specific hardware configuration.
The command line utility is called ricectl and is meant to make the process
of iteratively applying and updating the RICE configuration and tools easier.
The ricectl command can be used to easily execute Ansible, update the
local RICE repository, and add/remove ansible tags.
The installation process is expected to be run on a fresh installation of Ubuntu. Simply login to the system, start a terminal and run the following:
curl https://raw.githubusercontent.com/calebstewart/rice/main/setup.sh | shNOTE: You should not run this with
sudo. Instead, the setup script will usesudowhen needed, and mark log entries requiring administrative access withSUDO.
The setup script will ensure we have Python and git installed, and then clone
the RICE repository to $HOME/.local/share/rice. Next, it will setup a virtual
environment in $HOME/.local/share/rice/env for installing Ansible and ricectl.
After the ricectl and ansible packages are installed, the script will symlink
the ricectl binary to /usr/local/bin so that you have access to it normally.
The last thing the setup script does is run ricectl status, which will show the
current commit and tags that you have configured. At this point, you can add or
remove tags with the ricectl add-tag and ricectl remove-tag commands.
Once you have configured your tags, you are ready to apply the Ansible playbook!
Simply the following to kick off ansible. You will be prompted for the BECOME
password, which is your user password, which is used to elevate permissions as
needed.
ricectl applyFor system packages, the ricectl apply command will perform a full apt upgrade.
You can update the ricectl command itself and the Ansible playbooks with the
ricectl sync command.
If you have made modifications to the ansible playbook, and want to push those
changes back to the remote repository, you'll need to navigate to
$HOME/.local/share/rice, make a commit, and push using standard git commands.
You will have to authenticate to GitHub. By default, the setup.sh script clones
the repository with https, but you can change the URL to use SSH (and therefore
SSH keys) with this command:
cd ~/.local/share/rice
git remote set-url origin git@github.com:calebstewart/rice.git