brlin-tw/brlin-os-customizations

This project provides personally preferred operating system customizations, for convenience after re-installing the system.

Buo-ren, Lin's OS customizations

This project provides personally preferred operating system customizations, for convenience after re-installing the system.

Via the use of Ansible automation, it should be able to extend it to other OS distributions.

https://gitlab.com/brlin/brlin-os-customizations

Dependencies

• Ansible

How to use

1. Download the release archive from the project's Releases page

2. Extract the downloaded release archive

3. Launch a text terminal application

4. In the text terminal application, change the working directory to the extracted project folder

5. Run the following command to execute the customization playbook and provide your sudo password on prompt:

   ansible_playbook_opts=(
       # Ask the user's become password
       --ask-become-pass
   )
   ansible-playbook \
       "${ansible_playbook_opts[@]}" \
       playbooks/apply-customizations.yml

   If you intend to use the remotehost inventory, add the -i inventory/remotehost command option and argument to the ansible_playbook_opts array definition, note that in this case the system will automatically reboot to apply the changes while running the customization apply playbook.

6. (If using the localhost inventory) Reboot the system to apply the changes

References

The following external materials are reference during the development of this project:

• Ubuntu Flathub Setup | Flathub
  For the setup instructions of the Flatpak runtime on Ubuntu.
• community.general.flatpak_remote module – Manage flatpak repository remotes — Ansible Community Documentation
  Explains how to use the community.general.flatpak_remote module to setup up the Flathub software source.
• community.general.dconf module – Modify and read dconf database — Ansible Community Documentation
  Explains how to use the community.general.dconf module module to configure input method settings.
• Linux_Downloads – Oracle VirtualBox
  Explains the supported GNU+Linux distributions of the official Oracle VirtualBox packages distribution.
• ansible/lib/ansible/module_utils/facts/system/distribution.py at aa24e97 · ansible/ansible
  Explains the logic of determine the value of the ansible_distribution Ansible fact variable.
• Detect Latest VirtualBox Version | ChatGPT
  Explains how to programmatically detect the latest released version of Oracle VirtualBox without installing the application.
• ansible.builtin.uri module – Interacts with webservices — Ansible Community Documentation
  Explains how to use the ansible.builtin.uri module to access the version string of the latest Oracle VirtualBox release.
• ansible.builtin.set_fact module – Set host variable(s) and fact(s). — Ansible Community Documentation
  Explains how to use the ansible.builtin.set_fact module to set a managed node variable.
• Grammar — JMESPath Specification — JMESPath
  Explains the grammar of the literal and json-value values.
• ends_with — Built-in Functions — JMESPath Specification — JMESPath
  Explains the usage of the ends_with built-in function.
• Examples – ansible.builtin.get_url module – Downloads files from HTTP, HTTPS, or FTP to node — Ansible Community Documentation
  Explains the usage of the ansible.builtin.get_url Ansible module.
• extra_opts – Parameters – ansible.builtin.unarchive module – Unpacks an archive after (optionally) copying it from the local machine — Ansible Community Documentation
  Explains the usage of the extra_opts parameter of the ansible.builtin.unarchive Ansible module.
• ansible.builtin.tempfile module – Creates temporary files and directories — Ansible Community Documentation
  Explains how to create a temporary directory using the ansible.builtin.tempfile Ansible module.

Licensing

Unless otherwise noted(individual file's header/REUSE DEP5), this product is licensed under the 4.0 International version of the Creative Commons Attribution-ShareAlike license(CC BY-SA 4.0), or any of its recent versions you would prefer.

This work complies to the REUSE Specification, refer the REUSE - Make licensing easy for everyone website for info regarding the licensing of this product.