ubuntu-config-scripts

Development environment configuration scripts for Ubuntu Desktop (22.04).

Not intended for production. Use at your own risk!

Goal: Reduce the time it takes to configure a new Ubuntu Desktop environment for software development.

Usage

Clone the repo:

git clone https://github.com/yaphott/ubuntu-config-scripts.git

Run the script:
```
cd ubuntu-config-scripts
bash ./run.sh
```
A system upgrade will commence and the system will prompt to reboot.
After rebooting, run the script once more and respond to any prompts.

Testing with Vagrant

Testing occurs in 2 steps.

Provision a base box and create a snapshot.
Restore the snapshot and run the configuration scripts.

Creating the snapshot reduces the overall time needed to test the configuration scripts in a clean environment.

First time (base box + main box):

make test-cold

Subsequent times (main box):

make test-hot

Note: Password for the user is vagrant.

Convenience Scripts

`bin/utils/add_keyring.sh`

Add a keyring to the system by providing a URL to the keyring and the complete desired path to the keyring file.

sudo add_keyring.sh <key URL> <keyring path>

For example:

cd ./bin/utils
sudo bash add_keyring.sh https://example.com/apt/keys.asc \
    /etc/apt/keyrings/example-keyring.gpg

`bin/utils/add_repository.sh`

Add a repository to the system by providing the key URL, distribution, components, and the destination path for the list file.

sudo add_repository.sh <key options> <key URL> <distribution> <components> <list file path>

For example, if there is one component:

cd ./bin/utils
sudo add_repository.sh "arch=amd64 signed-by=/etc/apt/keyrings/example-keyring.gpg" \
    https://example.com/example-pub.gpg \
    stable \
    main \
    /etc/apt/sources.list.d/example.list

Or if there are multiple components:

cd ./bin/utils
sudo add_repository.sh "arch=amd64 signed-by=/etc/apt/keyrings/example-keyring.gpg" \
    https://example.com/example-pub.gpg \
    stable \
    "main contrib non-free" \
    /etc/apt/sources.list.d/example.list

Or if there are no components:

cd ./bin/utils
sudo add_repository.sh "arch=amd64 signed-by=/etc/apt/keyrings/example-keyring.gpg" \
    https://example.com/example-pub.gpg \
    stable \
    none \
    /etc/apt/sources.list.d/example.list

See Ubuntu Manpage: sources.list for more information on the format of the list file.

yaphott / ubuntu-config-scripts