ansible-role-plank

This is an Ansible role for installing Plank and setting it up.

Requirements

You need to have Poetry installed. You can get it from https://python-poetry.org/docs/

Role Variables

config_owner:
  String (required) to set the Linux user who will use Plank.
  Default: "{{ ansible_user_id }}"

config_owner_primary_group:
  String (optional) to set the group for the Plank setup.
  Default: "{{ config_owner }}"

plank_dock_items:
  List (required) to define which apps to add to the Plank launcher.

You can find more optional variables in defaults/main.yml, and others are used with the plankrc.j2 template.

Dependencies

None

Example Playbook

- hosts: all
  vars:
    config_owner: 'maya'
    plank_dock_items:
      - {name: 'atom', path: '/usr/share/applications/atom.desktop'}
      - {name: 'chromium-browser', path: '/usr/share/applications/chromium-browser.desktop'}
      - {name: 'keepassx2', path: '/usr/share/applications/keepassx2.desktop'}
      - {name: 'lxterminal', path: '/usr/share/applications/lxterminal.desktop'}
      - {name: 'nm-connection-editor', path: '/usr/share/applications/nm-connection-editor.desktop'}
      - {name: 'pcmanfm', path: '/usr/share/applications/pcmanfm.desktop'}
  roles:
     - { role: avnes.ansible-role-plank }

For pip compatibility

poetry export --dev --output requirements.txt

Test

poetry install
poetry shell
molecule test

License

MIT

Author Information

https://github.com/avnes/