Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

Select Status

RSS

systemd (30) Versions 0.4.0

chef cookbook for managing linux systems via systemd

Policyfile
Berkshelf
Knife
cookbook 'systemd', '= 0.4.0', :supermarket
cookbook 'systemd', '= 0.4.0'
knife supermarket install systemd
knife supermarket download systemd
README
Dependencies
Changelog
Quality 100%

Systemd Chef Cookbook

Cookbook
Build Status

A resource-driven Chef cookbook for managing GNU/Linux systems via systemd.

<a name="toc">Table of Contents</a>

<a name="recommended-reading">Recommended Reading</a>

<a name="attributes">Attributes</a>

too many to describe in detail ;).
in general, the attributes correspond to the related resource attributes.

<a name="recipes">Recipes</a>

  • default: no-op recipe

<a name="daemon-recipes">Daemon Recipes</a>

  • journald: configure, manage systemd-journald
  • journal_gatewayd: configure, manage systemd-journal-gatewayd
  • logind: configure, manage systemd-logind
  • machined: manage systemd-machined service
  • networkd: manage systemd-networkd service
  • resolved: configure, manage systemd-resolved
  • timesyncd: configure, manage systemd-timesyncd
  • udevd: configure, manage systemd-udevd

<a name="utility-recipes">Utility Recipes</a>

  • binfmt: manage systemd-binfmt one-shot boot-up unit
  • bootchart: configure systemd-bootchart
  • coredump: configure systemd-coredump
  • hostname: configure, manage hostname with systemd-hostnamed
  • locale: configure, manage locale with systemd-localed
  • real_time_clock: configure system clock mode (UTC,local) with timedatectl
  • sleep: configure system sleep, suspend, hibernate behavior with systemd-sleep
  • sysctl: manage systemd-sysctl one-shot boot-up unit (apply sysctl at boot)
  • system: configure systemd manager system-mode defaults
  • sysusers: manage systemd-sysusers one-shot boot-up unit (set up system users at boot)
  • timedated: manage systemd-timedated one-shot boot-up unit (set time/date at boot)
  • timezone: configure, manage timezone with timedatectl
  • user: configure systemd manager user-mode defaults
  • vconsole: configure, manage virtual console font and keymap with systemd-vconsole

<a name="resources"></a>Resources

<a name="unit-resources"></a>Unit Resources

<a name="systemd-automount"></a>systemd_automount

Unit which describes a file system automount point controlled by systemd.
Documentation

Attribute Description Default
where see docs nil
directory_mode see docs nil
timeout_idle_sec see docs nil

Also supports:

--

<a name="systemd-device"></a>systemd_device

Unit which describes a device as exposed in the sysfs/udev device tree.
Documentation

This resource has no specific options.

Also supports:

--

<a name="systemd-mount"></a>systemd_mount

Unit which describes a file system mount point controlled by systemd.
Documentation

Attribute Description Default
directory_mode see docs nil
kill_mode see docs nil
kill_signal see docs nil
options see docs nil
send_sighup see docs nil
send_sigkill see docs nil
sloppy_options see docs nil
timeout_sec see docs nil
type see docs nil
what see docs nil
where see docs nil

Also supports:

--

<a name="systemd-path"></a>systemd_path

Unit which describes information about a path monitored by systemd for
path-based activities.
Documentation

Attribute Description Default
directory_mode see docs nil
directory_not_empty see docs nil
make_directory see docs nil
path_changed see docs nil
path_exists see docs nil
path_exists_glob see docs nil
path_modified see docs nil
unit see docs nil

Also supports:

--

<a name="systemd-service"></a>systemd_service

Unit which describes information about a process controlled and supervised by systemd.
Documentation

Attribute Description Default
bus_name see docs nil
bus_policy see docs nil
exec_reload see docs nil
exec_start see docs nil
exec_start_post see docs nil
exec_start_pre see docs nil
exec_stop see docs nil
exec_stop_post see docs nil
failure_action see docs nil
file_descriptor_store_max see docs nil
guess_main_pid see docs nil
non_blocking see docs nil
notify_access see docs nil
permissions_start_only see docs nil
pid_file see docs nil
reboot_argument see docs nil
remain_after_exit see docs nil
restart see docs nil
restart_force_exit_status see docs nil
restart_prevent_exit_status see docs nil
restart_sec see docs nil
root_directory_start_only see docs nil
sockets see docs nil
start_limit_action see docs nil
start_limit_burst see docs nil
start_limit_interval see docs nil
success_exit_status see docs nil
timeout_sec see docs nil
timeout_start_sec see docs nil
timeout_stop_sec see docs nil
type see docs nil
watchdog_sec see docs nil

Also supports:

--

<a name="systemd-slice"></a>systemd_slice

Unit which describes a "slice" of the system; useful for managing resources
for of a group of processes.
Documentation

This resource has no specific options.

Also supports:

--

<a name="systemd-socket"></a>systemd_socket

Unit which describes an IPC, network socket, or file-system FIFO controlled
and supervised by systemd for socket-based service activation.
Documentation

Attribute Description Default
accept see docs nil
backlog see docs nil
bind_i_pv6_only see docs nil
bind_to_device see docs nil
broadcast see docs nil
defer_accept_sec see docs nil
directory_mode see docs nil
exec_start_post see docs nil
exec_start_pre see docs nil
exec_stop_post see docs nil
exec_stop_pre see docs nil
free_bind see docs nil
iptos see docs nil
ipttl see docs nil
keep_alive see docs nil
keep_alive_interval_sec see docs nil
keep_alive_probes see docs nil
keep_alive_time_sec see docs nil
listen_datagram see docs nil
listen_fifo see docs nil
listen_message_queue see docs nil
listen_netlink see docs nil
listen_sequential_packet see docs nil
listen_special see docs nil
listen_stream see docs nil
mark see docs nil
max_connections see docs nil
message_queue_max_messages see docs nil
message_queue_message_size see docs nil
no_delay see docs nil
pass_credentials see docs nil
pass_security see docs nil
pipe_size see docs nil
priority see docs nil
receive_buffer see docs nil
remove_on_stop see docs nil
reuse_port see docs nil
se_linux_context_from_net see docs nil
send_buffer see docs nil
service see docs nil
smack_label see docs nil
smack_label_ip_in see docs nil
smack_label_ip_out see docs nil
socket_group see docs nil
socket_mode see docs nil
socket_user see docs nil
symlinks see docs nil
tcp_congestion see docs nil
timeout_sec see docs nil
transparent see docs nil

Also supports:

--

<a name="systemd-swap"></a>systemd_swap

Unit which describes a swap device or file for memory paging.
Documentation

Attribute Description Default
options see docs nil
priority see docs nil
timeout_sec see docs nil
what see docs nil

Also supports:

--

<a name="systemd-target"></a>systemd_target

Unit which describes a systemd target, used for grouping units and
synchronization points during system start-up.
Documentation

This unit has no specific options.

Also supports:

--

<a name="systemd-timer"></a>systemd_timer

Unit which describes a timer managed by systemd, for timer-based unit
activation (typically a service of the same name).
Documentation

Attribute Description Default
accuracy_sec see docs nil
on_active_sec see docs nil
on_boot_sec see docs nil
on_calendar see docs nil
on_startup_sec see docs nil
on_unit_active_sec see docs nil
on_unit_inactive_sec see docs nil
persistent see docs nil
unit see docs nil
wake_system see docs nil

Also supports:

<a name="daemon-resources"></a>Daemon Resources

<a name="systemd-journald"></a>systemd_journald

Resource for configuring systemd-journald

Attribute Description Default
storage see docs nil
compress see docs nil
seal see docs nil
split_mode see docs nil
rate_limit_interval see docs nil
rate_limit_burst see docs nil
system_max_use see docs nil
system_keep_free see docs nil
system_max_file_size see docs nil
runtime_max_use see docs nil
runtime_keep_free see docs nil
runtime_max_file_size see docs nil
max_file_sec see docs nil
max_retention_sec see docs nil
sync_interval_sec see docs nil
forward_to_syslog see docs nil
forward_to_k_msg see docs nil
forward_to_console see docs nil
forward_to_wall see docs nil
max_level_store see docs nil
max_level_syslog see docs nil
max_level_k_msg see docs nil
max_level_console see docs nil
max_level_wall see docs nil
tty_path see docs nil

Also supports:

--

<a name="systemd-logind"></a>systemd_logind

Resource for configuring systemd-logind

Attribute Description Default
n_auto_v_ts see docs nil
reserve_vt see docs nil
kill_user_processes see docs nil
kill_only_users see docs nil
kill_exclude_users see docs nil
idle_action see docs nil
idle_action_sec see docs nil
inhibit_delay_max_sec see docs nil
handle_power_key see docs nil
handle_suspend_key see docs nil
handle_hibernate_key see docs nil
handle_lid_switch see docs nil
handle_lid_switch_docked see docs nil
power_key_ignore_inhibited see docs nil
suspend_key_ignore_inhibited see docs nil
hibernate_key_ignore_inhibited see docs nil
lid_switch_ignore_inhibited see docs nil
holdoff_timeout_sec see docs nil
runtime_directory_size see docs nil
remove_ipc see docs nil

Also supports:

--

<a name="systemd-resolved"></a>systemd_resolved

Resource for configuring systemd-resolved

Attribute Description Default
dns see docs nil
fallback_dns see docs nil
llmnr see docs nil

Also supports:

--

<a name="systemd-timesyncd"></a>systemd_timesyncd

Resource for configuring systemd-timesyncd

Attribute Description Default
ntp see docs nil
fallback_ntp see docs nil

Also supports:

<a name="utility-resources"></a>Utility Resources

<a name="systemd-bootchart"></a>systemd_bootchart

Resource for configuring systemd-bootchart

Attribute Description Default
samples see docs nil
frequency see docs nil
relative see docs nil
filter see docs nil
output see docs nil
init see docs nil
plot_memory_usage see docs nil
plot_entropy_graph see docs nil
scale_x see docs nil
scale_y see docs nil
control_group see docs nil

Also supports:

--

<a name="systemd-coredump"></a>systemd_coredump

Resource for configuring systemd-coredump

Attribute Description Default
storage see docs nil
compress see docs nil
process_size_max see docs nil
external_size_max see docs nil
journal_size_max see docs nil
max_use see docs nil
keep_free see docs nil

Also supports:

--

<a name="systemd-sleep"></a>systemd_sleep

Resource for configuring systemd-sleep

Attribute Description Default
suspend_mode see docs nil
hibernate_mode see docs nil
hybrid_sleep_mode see docs nil
suspend_state see docs nil
hibernate_state see docs nil
hybrid_sleep_state see docs nil

Also supports:

<a name="misc-resources"></a>Miscellaneous Resources

<a name="systemd-system"></a>systemd_system

Resource for configuring systemd system service manager:

Attribute Description Default
log_level see docs nil
log_target see docs nil
log_color see docs nil
log_location see docs nil
dump_core see docs nil
crash_shell see docs nil
show_status see docs nil
crash_ch_vt see docs nil
default_standard_output see docs nil
default_standard_error see docs nil
cpu_affinity see docs nil
join_controllers see docs nil
runtime_watchdog_sec see docs nil
shutdown_watchdog_sec see docs nil
capability_bounding_set see docs nil
system_call_architectures see docs nil
timer_slack_n_sec see docs nil
default_timer_accuracy_sec see docs nil
default_timeout_start_sec see docs nil
default_timeout_stop_sec see docs nil
default_restart_sec see docs nil
default_start_limit_interval see docs nil
default_start_limit_burst see docs nil
default_environment see docs nil
default_cpu_accounting see docs nil
default_block_io_accounting see docs nil
default_memory_accounting see docs nil
default_limit_cpu see docs nil
default_limit_fsize see docs nil
default_limit_data see docs nil
default_limit_stack see docs nil
default_limit_core see docs nil
default_limit_rss see docs nil
default_limit_nofile see docs nil
default_limit_as see docs nil
default_limit_nproc see docs nil
default_limit_memlock see docs nil
default_limit_locks see docs nil
default_limit_sigpending see docs nil
default_limit_msgqueue see docs nil
default_limit_nice see docs nil
default_limit_rtprio see docs nil
default_limit_rttime see docs nil

Also supports:

--

<a name="systemd-user"></a>systemd_user

Supports same options as the systemd_system resource.

--

<a name="systemd-binfmt-d"></a>systemd_binfmt_d

Resource for managing binfmt.d files
(configure binary formats for executables at boot)

Attribute Description Default
name see docs nil
type see docs M
offset see docs nil
magic see docs nil
mask see docs nil
interpreter see docs nil
flags see docs nil

--

<a name="systemd-modules"></a>systemd_modules

Resource for managing modules

Attribute Description Default
blacklist boolean, controls whether to blacklist or load false
modules Array, list of modules to act on []

--

<a name="systemd-networkd-link"></a>systemd_networkd_link

Resource for managing network devices

Attribute Description Default
original_name see docs nil
path see docs nil
driver see docs nil
type see docs nil
host see docs nil
virtualization see docs nil
kernel_command_line see docs nil
architecture see docs nil
description see docs nil
mac_address_policy see docs nil
name_policy see docs nil
name see docs nil
mtu_bytes see docs nil
bits_per_second see docs nil
duplex see docs nil
wake_on_lan see docs nil
match_mac_addr MacAddr setting for match section nil
link_mac_addr MacAddr setting for link section nil
link_alias Alias setting for link section nil

--

<a name="systemd-sysctl"></a>systemd_sysctl

Resource for managing sysctls with systemd-sysctl

Attribute Description Default
name resource name is sysctl name resource name
value sysctl value nil

--

<a name="systemd-sysuser"></a>systemd_sysuser

Resource for managing system users with systemd-sysusers

Attribute Description Default
name resource name is username resource name
type see docs u
id see docs nil
gecos see docs -
home see docs -

--

<a name="systemd-tmpfile"></a>systemd_tmpfile

Resource for managing tmp files with systemd-tmpfiles

Attribute Description Default
path see docs nil
mode see docs -
uid see docs -
gid see docs -
age see docs -
argument see docs -
type see docs f

--

<a name="systemd-udev-rules"></a>systemd_udev_rules

Resource for managing udev rules files

Attribute Description Default
rules array of arrays of hashes (see docs & example below) []

<a name="common-resource-attributes"></a>Common Resource Attributes

<a name="common-organization"></a>Organization

special no-op attributes that yield a block for the purpose of being
able to group attributes of a resource similar to their rendered grouping.

Attribute Description Default
install no-op block yielder nil
$unit_type no-op block yielder nil

By way of explanation:

systemd_automount 'vagrant-home' do
  description 'Test Automount'
  install do
    wanted_by 'local-fs.target'
  end
  automount do
    where '/home/vagrant'
  end
end

--

<a name="common-exec"></a>Exec

Execution environment configuration. Documentation

Attribute Description Default
app_armor_profile see docs nil
capabilities see docs nil
capability_bounding_set see docs nil
cpu_affinity see docs nil
cpu_scheduling_policy see docs nil
cpu_scheduling_priority see docs nil
cpu_scheduling_reset_on_fork see docs nil
environment see docs nil
environment_file see docs nil
group see docs nil
ignore_sigpipe see docs nil
inaccessible_directories see docs nil
io_scheduling_class see docs nil
io_scheduling_priority see docs nil
limit_as see docs nil
limit_core see docs nil
limit_cpu see docs nil
limit_data see docs nil
limit_fsize see docs nil
limit_locks see docs nil
limit_memlock see docs nil
limit_msgqueue see docs nil
limit_nice see docs nil
limit_nofile see docs nil
limit_nproc see docs nil
limit_rss see docs nil
limit_rtprio see docs nil
limit_rttime see docs nil
limit_sigpending see docs nil
limit_stack see docs nil
mount_flags see docs nil
nice see docs nil
no_new_privileges see docs nil
oom_score_adjust see docs nil
pam_name see docs nil
personality see docs nil
private_devices see docs nil
private_network see docs nil
private_tmp see docs nil
protect_home see docs nil
protect_system see docs nil
read_only_directories see docs nil
read_write_directories see docs nil
restrict_address_families see docs nil
root_directory see docs nil
runtime_directory see docs nil
runtime_directory_mode see docs nil
se_linux_context see docs nil
secure_bits see docs nil
smack_process_label see docs nil
standard_error see docs nil
standard_input see docs nil
standard_output see docs nil
supplementary_groups see docs nil
syslog_facility see docs nil
syslog_identifier see docs nil
syslog_level see docs nil
syslog_level_prefix see docs nil
system_call_architectures see docs nil
system_call_error_number see docs nil
system_call_filter see docs nil
timer_slack_n_sec see docs nil
tty_path see docs nil
tty_reset see docs nil
ttyv_hangup see docs nil
ttyvt_disallocate see docs nil
u_mask see docs nil
user see docs nil
utmp_identifier see docs nil
working_directory see docs nil

--

<a name="common-kill"></a>Kill

Process killing procedure configuration. Documentation

Attribute Description Default
kill_mode see docs nil
kill_signal see docs nil
send_sighup see docs nil
send_sigkill see docs nil

--

<a name="common-resource-control"></a>Resource Control

Resource control unit settings. Documentation

Attribute Description Default
block_io_accounting see docs nil
block_io_device_weight see docs nil
block_io_read_bandwidth see docs nil
block_io_weight see docs nil
block_io_write_bandwidth see docs nil
cpu_accounting see docs nil
cpu_quota see docs nil
cpu_shares see docs nil
delegate see docs nil
device_allow see docs nil
device_policy see docs nil
memory_accounting see docs nil
memory_limit see docs nil
slice see docs nil
startup_block_io_weight see docs nil
startup_cpu_shares see docs nil

--

<a name="common-unit"></a>Unit

Common configuration options of all the unit types.
Documentation

Attribute Description Default
after see docs nil
allow_isolate see docs nil
assert_ac_power see docs nil
assert_architecture see docs nil
assert_capability see docs nil
assert_directory_not_empty see docs nil
assert_file_is_executable see docs nil
assert_file_not_empty see docs nil
assert_first_boot see docs nil
assert_host see docs nil
assert_kernel_command_line see docs nil
assert_needs_update see docs nil
assert_path_exists see docs nil
assert_path_exists_glob see docs nil
assert_path_is_directory see docs nil
assert_path_is_mount_point see docs nil
assert_path_is_read_write see docs nil
assert_path_is_symbolic_link see docs nil
assert_security see docs nil
assert_virtualization see docs nil
before see docs nil
binds_to see docs nil
condition_ac_power see docs nil
condition_architecture see docs nil
condition_capability see docs nil
condition_directory_not_empty see docs nil
condition_file_is_executable see docs nil
condition_file_not_empty see docs nil
condition_first_boot see docs nil
condition_host see docs nil
condition_kernel_command_line see docs nil
condition_needs_update see docs nil
condition_path_exists see docs nil
condition_path_exists_glob see docs nil
condition_path_is_directory see docs nil
condition_path_is_mount_point see docs nil
condition_path_is_read_write see docs nil
condition_path_is_symbolic_link see docs nil
condition_security see docs nil
condition_virtualization see docs nil
conflicts see docs nil
default_dependencies see docs nil
description see docs nil
documentation see docs nil
ignore_on_isolate see docs nil
ignore_on_snapshot see docs nil
job_timeout_action see docs nil
job_timeout_reboot_argument see docs nil
job_timeout_sec see docs nil
joins_namespace_of see docs nil
on_failure see docs nil
on_failure_job_mode see docs nil
part_of see docs nil
propagates_reload_to see docs nil
refuse_manual_start see docs nil
refuse_manual_stop see docs nil
reload_propagated_from see docs nil
requires see docs nil
requires_mounts_for see docs nil
requires_overridable see docs nil
requisite see docs nil
requisite_overridable see docs nil
source_path see docs nil
stop_when_unneeded see docs nil
wants see docs nil

--

<a name="common-install"></a>Install

Carries installation information for units. Used exclusively by
enable/disable commands of systemctl. Documentation

Attribute Description Default
aliases array of aliases []
also see docs nil
default_instance see docs nil
required_by see docs nil
wanted_by see docs nil

--

<a name="common-drop-in"></a>Drop-In

Cookbook-specific attributes that activate and control drop-in mode for units.

Attribute Description Default
drop_in boolean which sets if resource is a drop-in unit false
override which unit to override, prefix only. suffix determined by resource unit type (e.g. "ssh" on a systemd_service -> "ssh.service.d") nil
overrides drop-in unit options that require a reset (e.g. "ExecStart" -> "ExecStart=" at top of section) []

--

Dependent cookbooks

This cookbook has no specified dependencies.

Contingent cookbooks

7dtd Applicable Versions
ayte-yandex-disk Applicable Versions
cassandra-dse Applicable Versions
chef_libvirt Applicable Versions
clickhouse Applicable Versions
dbforbix Applicable Versions
depot Applicable Versions
devopsdance-consul-template Applicable Versions
gobblin Applicable Versions
gobgp Applicable Versions
haproxy-ng Applicable Versions
hekad Applicable Versions
kibana5 Applicable Versions
kubelet Applicable Versions
microfocus Applicable Versions
mw_application_service Applicable Versions
nomad Applicable Versions
proxysql Applicable Versions
rkt Applicable Versions
solr-lts Applicable Versions
traefik Applicable Versions
vitess Applicable Versions
wildfly Applicable Versions
xenserver-tools Applicable Versions

0.4.0 / 2015-10-16

  • add binfmt resource
  • add udev resource
  • add sysuser resource
  • reorganize libraries
  • reorganize and expand docs

0.3.0 / 2015-09-18

  • enhanced resource attributes (type, value appropriate)
  • add init helpers
  • add reload action for service resources

0.2.0 / 2015-08-15

  • add non-unit resources/providers
  • add recipes
  • expanded testing
  • expanded documentation

0.1.2 / 2015-07-29

  • hotfix provider

0.1.1 / 2015-07-10

  • initial release

Foodcritic Metric
            

0.4.0 passed this metric