Chef Cookbook Gui

Cookbook to install linux guis like cinnamon, gnome, ...

The default cookbook is a No-Op. To install a gui, add the respective cookbook to your runlist.

Requirements

Supported Platforms

• Debian Stretch

Suported GUIs

• cinnamon
• xfce4
• gnome

Chef

• Chef 13.0+

Cookbook Depdendencies

• apt

Usage

Add the cookbook to your Berksfile:

cookbook 'codenamephp_gui'

Add the gui cookbook to your runlist, e.g. in a role:

{
  "name": "default",
  "chef_type": "role",
  "json_class": "Chef::Role",
  "run_list": [
      "recipe[codenamephp_gui::cinnamon]"
  ]
}

Note that the default recipe is a No-Op, so you need to add the gui you want

Recipes

Each recipe just uses the respective resource without any arguments. They are meant to use as a shortcut in a runlist or via chef manage gui. If you need some additional properties use the resources in a wrapper cookbook.

Resources

Cinnamon

The codenamephp_gui_cinnamon resource installs or uninstalls the cinnamon gui.

Actions

• :install: Installs the gui using apt and starts and enables the lightdm display manager
• :uninstall: Uninstalls the lightdm display manager

Properties

• package_name: The name of the apt package to use for install, defaults to 'cinnamon-core'
• lightdm: Boolean to enable or disable the lightdm handling, defaults to true

Examples

# Minmal parameters
codenamephp_gui_cinnamon 'install cinnamon gui'

# Custom package name and disabled lightdm
codenamephp_gui_cinnamon 'install cinnamon gui' do
  package_name 'cinnamon'
  lightdm false
end

# Uninstall
codenamephp_gui_cinnamon 'install cinnamon gui' do
  action :uninstall
end

XFCE4

The codenamephp_gui_xfce resource installs or uninstalls the xfce4 gui.

Actions

• :install: Installs the gui using apt and starts and enables the lightdm display manager
• :uninstall: Uninstalls the lightdm display manager

Properties

• package_name: The name of the apt package to use for install, defaults to 'xfce4-core'
• lightdm: Boolean to enable or disable the lightdm handling, defaults to true

Examples

# Minmal parameters
codenamephp_gui_xfce4 'install xfce4 gui'

# Custom package name and disabled lightdm
codenamephp_gui_xfce4 'install xfce4 gui' do
  package_name 'xfce4'
  lightdm false
end

# Uninstall
codenamephp_gui_xfce4 'install xfce4 gui' do
  action :uninstall
end

Gnome

The codenamephp_gui_xfce resource installs or uninstalls the gnome gui.

Actions

• :install: Installs the gui using apt
• :uninstall: Uninstalls the gui using apt

Properties

• package_name: The name of the apt package to use for install, defaults to 'gnome-core'

Examples

# Minmal parameters
codenamephp_gui_gnome 'install gnome gui'

# Custom package name
codenamephp_gui_gnome 'install gnome gui' do
  package_name 'gnome'
end

# Uninstall
codenamephp_gui_gnome 'install gnome gui' do
  action :uninstall
end