Skip to content

shipilovds/workstation

Repository files navigation

Galaxy page

shipilovds.workstation

This colection created to store some modules and roles I wrote to setup my workstation.

Included content

Modules

Name Description
shipilovds.workstation.gnome_extension Gnome shell extensions management
shipilovds.workstation.gsettings Gnome applications settings management

NOTE: I`ve made some cool stuff to make "docs.ansible.com"-like modules documentation. Generated pages you can find on the links above. Template file and tool itself:

Roles

Name Description
gnome Setup Gnome and Gnome-Shell
pkgs Install dnf, apt and pip packages
services Setup for system services (Shadowsocks for now)
tools Setup system tools and shell environment (git, neovim, ohmyzsh, pypi, ssh, tmux, yamllint)

See more here

Ansible version compatibility

Honestly, I have never really checked compatibility with ansible version.

Modules 100% works with ansible core == 2.12

Installation

Ansible galaxy

You can install the shipilovds.workstation collection with the Ansible Galaxy CLI:

# Install from https://galaxy.ansible.com
ansible-galaxy collection install shipilovds.workstation

# Install from GitHub
ansible-galaxy collection install [email protected]:shipilovds/workstation.git

You can also include it in a requirements.yml file and install it with

ansible-galaxy collection install -r requirements.yml, using the format:

---
collections:
  - name: shipilovds.workstation

PIP (deprecated method)

To get pip package with modules just type pip install git+https://github.com/shipilovds/workstation@latest

You can choose pip installation if you only need modules. I've decided not to make roles installation via pip.

Using this collection

See roles documentation to understand how to use roles.

See Ansible Using collections for more details.

Contributing to this collection

Licensing

GNU General Public License v3.0 or later.

See COPYING to see the full text.