Forge Home

archlinux_workstation

Configure an Arch Linux workstation/desktop/laptop

6,437 downloads

1,817 latest version

5.0 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 0.5.0 (latest)
  • 0.3.2
  • 0.3.1
  • 0.3.0
released Dec 28th 2017
This version is compatible with:
  • Puppet Enterprise 2018.1.x, 2017.3.x, 2017.2.x, 2017.1.x, 2016.5.x, 2016.4.x
  • Puppet >= 4.0.0 < 6.0.0
  • ArchLinux

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'jantman-archlinux_workstation', '0.3.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add jantman-archlinux_workstation
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install jantman-archlinux_workstation --version 0.3.0

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download

Documentation

jantman/archlinux_workstation — version 0.3.0 Dec 28th 2017

Table of Contents

  1. Overview
  2. Module Description - What the module does and why it is useful
  3. Setup - The basics of getting started with archlinux_workstation
  4. Requirements
  5. Usage - Configuration options and additional functionality
  6. Reference - An under-the-hood peek at what the module is doing and how
  7. Limitations - OS compatibility, etc.
  8. Development - Guide for contributing to the module

Overview

Project Status: Active - The project has reached a stable, usable state and is being actively developed.

Provides many classes for configuring an Arch Linux workstation/laptop/desktop for graphical use and installing common software.

Module Description

This is one of the modules that I use to keep my personal desktop and work laptop, both running Arch Linux, in sync, up to date, and easily rebuild-able. It's intended to do three main things:

  1. Manage all installed packages, and all configuration outside of /home, so I don't need to back up anything outside /home.
  2. Keep my desktop and laptop perfectly in sync in terms of packages and global (non-user-specific) configuration.
  3. Allow me to quickly rebuild one of these machines if needed, to minimize downtime.

This module is intended to be part of a whole. For me, that includes my workstation-bootstrap module (GitHub) that uses r10k, a Puppetfile, and a few manifests to actually manage what's applied to my machines and install modules, as well as a private module ("privatepuppet") on GitHub for my sensitive/personal configuration, and a specific module for Arch Linux on my MacBook Pro Retina that handles some things specific to that platform.

Note: this module is quite opinionated; it is how I setup my machines, and may not be exactly what you want. Pull requests are welcome to add parameters for more control over its behavior.

Setup

What archlinux_workstation affects

See the Reference section below for details. In general, the goal is that it affects anything and everything you'd need to touch to take a base Arch Linux installation to a fully-usable, graphical workstation/laptop/desktop. This includes:

  • your login user, a primary group with the same name as the username, and their supplementary groups

Optionally:

  • sudoers file and sudoers.d entries for your user
  • sshd_config, including AllowUsers (your user only) and auth methods (pubkey/RSA only)
  • /etc/makepkg.conf, set to compile and cache sources under /tmp (tmpfs), and specify -j${::processorcount} make flag.
  • installation of some common base packages (see archlinux_workstation::base_packages below)
  • use of the puppetlabs/firewall module to manage iptables (note that it's expected you setup the module elsewhere, as I do in workstation_bootstrap - this module just adds rules for its services using the Firewall type).
  • enable dkms support by installing the package and enabling the service
  • creates and uses a swapfile at a configurable path and of configurable size (by defaylt, 4G at /swapfile), via an instance of archlinux_workstation::swapfile.
  • sets up CUPS printing
  • sets up the Chrony alternative NTP daemon
  • installs Xorg Xserver as well as related required and recommended/optional packages (note - this currently only installs the default vesa driver. See archlinux_workstation::xorg below for more information)
  • if the gui parameter is set to 'kde' (default), installs KDE Plasma and installs and runs SDDM
  • sets up my personal (jantman) pacman repo and the Multilib repo
  • installation of a number of different user applications (see archlinux_workstation::userapps:: classes below)

Usage

Classes are parameterized where that makes sense. Right now, there are two methods of usage:

  1. To install and setup everything this module is capable of, declare an instance of archlinux_workstation passing the username parameter for the name of your user, and an instance of archlinux_workstation::all to do everything.

    class {'archlinux_workstation': foo => bar, }

    class {'archlinux_workstation::all': }

  2. To pick and choose which parts you use, declare archlinux_workstation as shown above, and in place of archlinux_workstation::all, declare the classes that you want.

If you stick to one of these two usage methods (instead of forking this module and hacking on the internals), you should be safe to pull in updates as they happen.

Reference

For full automatically-generated documentation see: http://jantman.github.io/puppet-archlinux-workstation/

Limitations

This module is only usable with Arch Linux.

It assumes that you have a relatively vanilla base install of Arch, such as the one I document in my workstation-bootstrap module, pretty much the same as the Arch Linux Installation Guide documents.

Development

See CONTRIBUTING.md for information about development and contributing.

This module currently just has spec tests; run them with:

bundle install --path vendor
bundle exec rake spec

Adding Classes

To add a class:

  1. Add the class itself, using the template: sed 's/CLASSNAME/name_of_class/g' manifests/template.txt > manifests/name_of_class.pp
  2. Add spec tests, using the template: sed 's/CLASSNAME/name_of_class/g' spec/classes/template.txt > spec/classes/name_of_class.pp
  3. Add acceptance tests.
  4. Add the class to the Reference section above
  5. Add the class to the archlinux_workstation::all (manifests/all.pp) class.