Version information
This version is compatible with:
- Puppet Enterprise 2023.8.x, 2023.7.x, 2023.6.x, 2023.5.x, 2023.4.x, 2023.3.x, 2023.2.x, 2023.1.x, 2023.0.x, 2021.7.x, 2021.6.x, 2021.5.x, 2021.4.x, 2021.3.x, 2021.2.x, 2021.1.x, 2021.0.x
- Puppet >= 7.0.0 < 9.0.0
- , ,
Start using this module
Add this module to your Puppetfile:
mod 'treydock-kernel', '2.0.0'Learn more about managing modules with a PuppetfileDocumentation
puppet-module-kernel
####Table of Contents
Overview
The kernel Puppet module allows for managing the kernel packages and the default GRUB2 kernel.
Usage
kernel
The default behavior of this module is to ensure the kernel package is present.
class { 'kernel': }
This is an example of ensuring a specific version of the kernel is installed and set as the default in GRUB2.
class { 'kernel'
version => '4.18.0-513.24.1.el8_9'
}
Reference
Reference
Table of Contents
Classes
kernel: Manage kernelkernel::configkernel::grubbykernel::install
Classes
kernel
Manage kernel
Examples
include ::kernel
Parameters
The following parameters are available in the kernel class:
versionpackage_ensurepackage_nameinstall_develdevel_package_nameinstall_headersheaders_package_nameinstall_firmwarefirmware_package_nameset_default_kernelgrub_default_kernelgrub_conf_pathgrub_class
version
Data type: Optional[String[1]]
The desired kernel version to be installed.
Must be the full string that would be output by running uname -r.
Default of 'UNSET' disables management of kernel package version.
Default value: undef
package_ensure
Data type: Enum['present', 'latest']
Package ensure parameter.
Default value: 'present'
package_name
Data type: String[1]
The kernel package name.
Default value: 'kernel'
install_devel
Data type: Boolean
Boolean to specify whether the kernel-devel package should be installed.
Default value: false
devel_package_name
Data type: String[1]
The kernel development package name.
Default value: 'kernel-devel'
install_headers
Data type: Boolean
Boolean to specify whether the kernel-headers package should be installed.
Default value: false
headers_package_name
Data type: String[1]
The kernel headers package name.
Default value: 'kernel-headers'
install_firmware
Data type: Boolean
Boolean to specify whether the kernel-firmware package should be installed.
Default value: false
firmware_package_name
Data type: String[1]
The kernel firmware package name.
Default value: 'kernel-firmware'
set_default_kernel
Data type: Boolean
Boolean to specify whether if the default kernel in GRUB should be modified by this module.
Default value: true
grub_default_kernel
Data type: Optional[String[1]]
The kernel version to set as default in GRUB.
Default is the value of $version.
Default value: undef
grub_conf_path
Data type: Stdlib::Unixpath
The path to GRUB configuration file. Default is OS dependent.
Default value: '/etc/default/grub'
grub_class
Data type: Enum['grubby']
The class to be used to manage GRUB.
Default value: 'grubby'
kernel::config
The kernel::config class.
kernel::grubby
The kernel::grubby class.
kernel::install
The kernel::install class.
Change log
All notable changes to this project will be documented in this file. The format is based on Keep a Changelog and this project adheres to Semantic Versioning.
v2.0.0 (2024-05-24)
Changed
Added
1.0.0 (2017-10-26)
0.0.1 (2017-10-26)
UNCATEGORIZED PRS; GO LABEL THEM
- RFC: Create new 'grubby' grub_class #2 (alexjfisher)
* This Changelog was automatically generated by github_changelog_generator
Dependencies
- puppetlabs/stdlib (>= 4.13.1 <10.0.0)
Copyright (C) 2014 Trey Dockendorf <treydock@gmail.com>
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.