Fedora Workstation Ansible

This project contains ansible resources for setting up a new Fedora workstation.

The following roles will be set up, with descriptions providing a minimum of what will be installed:

• Git User: git, gitk, git-gui, user configuration
• SSH User: Creates a bunch of ssh keys for you to use. Optional system variable for if you want to register keys. Key management is left to you.
• Power User:
  • zsh tasks: zsh, oh-my-zsh, extensions, powerlevel10k, plugins
  • numerous command line tools
    • bat, eza, fzf, mc, tldr, tmux, tree, vim, wget
  • system information, monitoring, and performance tools
    • fastfetch, process, i/o, and GPU monitoring
  • .vimrc file
  • IOSevka fonts for terminals
• App User: audio and video redcording, email
  • Wallpapers
• Amateur Radio: QRQ, OpenSCAD, kiCAD, Ngspice, SDR software
• Developer: gcc, python3, go lang, elixir, ruby, podman, VS Code, gitnuro
• AI researcher: numpy, pandas, scikit-learn, keras, matplotlib, ggplot, bokeh
• Database Engineer: pgcli, pgadmin4-desktop, valkey, valkey-doc
• Communicator: Slack, Discord, Zoom, Edge

Project Structure

fedora-workstation-ansible/
├── README.md
├── workstation.yml
└── roles/
    ├── role_name/
    │   ├── handlers/
    │   ├── tasks/
    │   │   └── main.yml
    ...

Initial bootstrap

How to do the initial bootstrap of getting ansible on the system:

sudo dnf install ansible

Running the playbook

• Clone the repo onto your computer.
• It is fine to use https at this point.
• Change into the cloned directory.
• To run the playbook on your local workstation, use the following command:

ansible-playbook -i localhost, -c local workstation.yml --ask-become-pass

Gotchas

If you have already enrolled a fingerprint, this is likely to block the playbook from properly running. It can get stuck at gathering facts. Delete enrolled fingerprints and try to run again.

If there is a failure downloading during a task, simply run the playbook again.

Install Custom roles

To run with selected roles, you can modify the workstation.yml file or duplicate it. Alter the duplicated file to have only the roles you want to run. You can do this by adding a # before the role name. On the command line specify the new file name instead of workstation.yml

Post install

Run p10k configure in a new terminal if you aren't prompted to set up powerlevel 10K.

Set up TensorFlow in virtual environment.

The client tool for postgresql is installed. However, you will need to install the postgresql server if you want a local server.

Install nvm and a version of node.

Install mongodb mongosh

Install dBeaver

Install AWS CLI

Developer Information

How to do a dry run of the playbook

ansible-playbook -i localhost, -c local workstation.yml --check --ask-become-pass

Testing with WSL2 or a container

• How to test in a WSL2 instance
• How to test with a container not functional

Testing using Virtualization

You can use Boxes on a Fedora Workstation. Or if you have a Windows Pro OS you can use Hyper-V. Create a VM with a clean instance of Fedora Workstation. To test your changes, clone down your forked repo. Switch to the appropriate branch and test installing