j1mc / ansible-silverblue Goto Github PK

Configure a Fedora Silverblue host using Ansible

License: BSD 2-Clause "Simplified" License

Jinja 100.00%

ansible-silverblue's Introduction

ansible-silverblue

You can use this repository to configure a Fedora Silverblue workstation or laptop with Ansible. It will make it easier to apply the same settings to multiple hosts, saving you from having to manually configure your computer over and over again.

Included Roles

The main parts of this project can be seen in the 'roles' directory. Each role included there contains a README file that explains what the role is and how to use it. For starters, here is a brief summary of each role:

layered_packages: Install or remove packages into / from the base rpm-ostree image.
flatpaks: Install desired flatpak applications.
fonts: Install custom fonts (this role is under the GPLv3 License).
gnome_settings: Set various GNOME desktop settings. The role makes these changes via dconf.
os_updates: Configure the auto-update policy for the host.

Variables

I've consolidated the project's variables into the group_vars/all file. This makes it easy to update the project's variables from a single location. You should customize the values in that file to set what changes get applied in the various roles.

Setup

Clone this repository with:

git clone https://github.com/j1mc/ansible-silverblue.git

Install needed dependencies with:

cd ansible-silverblue
python3 -m venv venv
source venv/bin/activate
pip3 install -r requirements.txt
ansible-galaxy collection install -r requirements.yml

... then make edits to the group_vars/all file to customize this project to make it do what you want it to do.

Run the Playbooks

This command will run all of the included playbooks:

ansible-playbook -i hosts -l this_host -K -v playbook_base.yml

If you want to run any of the roles individually, please review that role's README file for the needed command.

License

Unless otherwise indicated in the individual role, this project is under the BSD License.

Author

Jim Campbell ([email protected])

ansible-silverblue's People

Contributors

Stargazers

Watchers

ansible-silverblue's Issues

Support for custom systemd units

It'd be nice if we could have a task for custom systemd units so they can customize the services they need on deplyoment.

Layer downloaded RPMs?

Is there a way to specify an RPM to download (e.g. Dropbox) and have rpm-ostree install it?
I do this manually for Dropbox and Vivaldi Browser...

There is already a Dropbox flatpak but doesn't work very well lately. So I've resorted to using their RPM again.

Fonts installation is hardcoded to jcampbell

Hi Jim, thanks for working on this, I"m hoping to adapt this playbook to my needs. Fonts role doesn't complete unless you're jcampbell. Modifying it to my username completes successfully.

Also should the homedir be: /var/home/$USER?

user: jcampbell
homedir: /home/jcampbell

TASK [settings : Apply desired settings via dconf] ***********************************************
An exception occurred during task execution. To see the full traceback, use -vvv. The error was: ModuleNotFoundError: No module named 'psutil'
failed: [localhost] (item={'key': '/org/gnome/settings-daemon/plugins/color/night-light-enabled', 'value': 'true'}) => changed=false 
  ansible_loop_var: item
  item:
    key: /org/gnome/settings-daemon/plugins/color/night-light-enabled
    value: 'true'
  msg: Failed to import the required Python library (psutil) on fedora's Python /usr/bin/python3. Please read the module documentation and install it in the appropriate location. If the required library is installed, but Ansible is using the wrong Python interpreter, please consult the documentation on ansible_python_interpreter
An exception occurred during task execution. To see the full traceback, use -vvv. The error was: ModuleNotFoundError: No module named 'psutil'
failed: [localhost] (item={'key': '/org/gnome/desktop/privacy/remember-recent-files', 'value': 'true'}) => changed=false 
  ansible_loop_var: item