- Overview
- Usage - Configuration options
- Reference - Parameter and detailed reference to all options
- Limitations - OS compatibility, etc.
- Development - Guide for contributing to the module
- TODO
- Additional Information
We've modified this module according the requirements of our organization. Changes are not intended to work in any other environments
This module manages the singularity package installation and configuration of singularity.conf.
Install and configure singularity:
class { 'singularity': }
singularity
: Installs and configures singularity.
singularity::install
: Installs singularity packages.singularity::config
: Configures singularity.singularity::params
: Sets parameter defaults based on fact values.
Below are parameter defaults in Hiera format:
singularity::package_ensure: present
singularity::package_name: singularity
singularity::manage_epel: true
singularity::config_path: /etc/singularity/singularity.conf
singularity::config_template: singularity/singularity.conf.erb
singularity::allow_setuid: 'yes'
singularity::max_loop_devices: 256
singularity::allow_pid_ns: 'yes'
singularity::config_passwd: 'yes'
singularity::config_group: 'yes'
singularity::config_resolv_conf: 'yes'
singularity::mount_proc: 'yes'
singularity::mount_sys: 'yes'
singularity::mount_dev: 'yes'
singularity::mount_devpts: 'yes'
singularity::mount_home: 'yes'
singularity::mount_tmp: 'yes'
singularity::mount_hostfs: 'no'
singularity::bind_paths:
- /etc/localtime
- /etc/hosts
singularity::user_bind_control: 'yes'
singularity::enable_overlay: 'try'
singularity::mount_slave: 'yes'
singularity::sessiondir_max_size: 16
#singularity::limit_container_owners: undef
#singularity::limit_container_groups: undef
#singularity::limit_container_paths: undef
singularity::allow_containers:
squashfs: 'yes'
extfs: 'yes'
dir: 'yes'
#singularity::autofs_bug_paths: undef
Package ensure parameter, defaults to present
Package name, defaults to singularity
Determines whether to include EPEL class before installing singularity. Defaults to true
This module has been tested on:
- CentOS 6 x86_64
- CentOS 7 x86_64
Testing requires the following dependencies:
- rake
- bundler
Install gem dependencies
bundle install
Run unit tests
bundle exec rake test
If you have Vagrant >= 1.2.0 installed you can run system tests
bundle exec rake beaker