222 lines
8.8 KiB
Puppet
222 lines
8.8 KiB
Puppet
#
|
|
# Copyright (C) 2013 eNovance SAS <licensing@enovance.com>
|
|
#
|
|
# Author: Emilien Macchi <emilien.macchi@enovance.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.
|
|
|
|
# Configure the PXE driver in Ironic
|
|
#
|
|
# === Parameters
|
|
#
|
|
# [*kernel_append_params*]
|
|
# (optional) Additional append parameters for baremetal PXE boot.
|
|
# Should be valid pxe parameters
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*pxe_bootfile_name*]
|
|
# (optional) Bootfile DHCP parameter.
|
|
# If not set, its value is detected.
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*pxe_config_template*]
|
|
# (optional) Template file for PXE configuration.
|
|
# If set, should be an valid template file. Otherwise, its value is detected.
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*ipxe_bootfile_name*]
|
|
# (optional) Bootfile DHCP parameter when the ipxe boot interface is set
|
|
# for a baremetal node. If not set, its value is detected.
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*ipxe_config_template*]
|
|
# (optional) Template file for PXE configuration with the iPXE boot
|
|
# interface. If set, should be an valid template file. Otherwise,
|
|
# its value is detected.
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*tftp_server*]
|
|
# (optional) IP address of Ironic compute node's tftp server.
|
|
# Should be an valid IP address
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*tftp_root*]
|
|
# (optional) Ironic compute node's tftp root path.
|
|
# Should be an valid path
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*images_path*]
|
|
# (optional) Directory where images are stored on disk.
|
|
# Should be an valid directory
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*tftp_master_path*]
|
|
# (optional) Directory where master tftp images are stored on disk.
|
|
# Should be an valid directory
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*instance_master_path*]
|
|
# (optional) Directory where master tftp images are stored on disk.
|
|
# Should be an valid directory
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*uefi_pxe_bootfile_name*]
|
|
# (optional) Bootfile DHCP parameter for UEFI boot mode.
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*uefi_pxe_config_template*]
|
|
# (optional) Template file for PXE configuration for UEFI boot loader.
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*uefi_ipxe_bootfile_name*]
|
|
# (optional) Bootfile DHCP parameter for UEFI boot mode for the
|
|
# ipxe boot interface. No separate configuration template is required
|
|
# when using ipxe.
|
|
# Defaults to snponly.efi, which supports UEFI firmware with network
|
|
# enablement, which is a standard feature in UEFI.
|
|
#
|
|
# [*ipxe_timeout*]
|
|
# (optional) ipxe timeout in second.
|
|
# Should be an valid integer
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*enable_ppc64le*]
|
|
# (optional) Boolean value to dtermine if ppc64le support should be enabled
|
|
# Defaults to false (no ppc64le support)
|
|
#
|
|
# [*boot_retry_timeout*]
|
|
# (optional) Timeout (in seconds) after which PXE boot should be retried.
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*boot_retry_check_interval*]
|
|
# (optional) How often (in seconds) to check for PXE boot status.
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*dir_permission*]
|
|
# (optional) THe permission that will be applied to the TFTP folders upon
|
|
# creation.
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*file_permission*]
|
|
# (optional) The permission which is used on files created as part of
|
|
# configuration and setup of file assets for PXE based operations.
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*loader_file_paths*]
|
|
# (optional) Dictionary describing the bootloaders to load into conductor
|
|
# PXE/iXPE boot folders values from the host operating system.
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# DEPRECATED PARAMETERS
|
|
#
|
|
# [*ip_version*]
|
|
# DEPRECATED: (optional) The IP version that will be used for PXE booting.
|
|
# Ironic presently attempts both IPv4 and IPv6, this option is effectively
|
|
# ignored by ironic, and should anticipate being removed in a future
|
|
# release.
|
|
# Defaults to $::os_service_default.
|
|
#
|
|
# [*pxe_append_params*]
|
|
# (optional) Additional append parameters for baremetal PXE boot.
|
|
# Should be valid pxe parameters
|
|
# Defaults to undef.
|
|
#
|
|
class ironic::drivers::pxe (
|
|
$kernel_append_params = $::os_service_default,
|
|
$pxe_bootfile_name = $::os_service_default,
|
|
$pxe_config_template = $::os_service_default,
|
|
$ipxe_bootfile_name = $::os_service_default,
|
|
$ipxe_config_template = $::os_service_default,
|
|
$tftp_server = $::os_service_default,
|
|
$tftp_root = $::os_service_default,
|
|
$images_path = $::os_service_default,
|
|
$tftp_master_path = $::os_service_default,
|
|
$instance_master_path = $::os_service_default,
|
|
$uefi_pxe_bootfile_name = $::os_service_default,
|
|
$uefi_pxe_config_template = $::os_service_default,
|
|
$uefi_ipxe_bootfile_name = 'snponly.efi',
|
|
$ipxe_timeout = $::os_service_default,
|
|
$enable_ppc64le = false,
|
|
$boot_retry_timeout = $::os_service_default,
|
|
$boot_retry_check_interval = $::os_service_default,
|
|
$dir_permission = $::os_service_default,
|
|
$file_permission = $::os_service_default,
|
|
$loader_file_paths = $::os_service_default,
|
|
# DEPRECATED PARAMETERS
|
|
$ip_version = undef,
|
|
$pxe_append_params = undef,
|
|
) {
|
|
|
|
include ironic::deps
|
|
include ironic::pxe::common
|
|
$tftp_root_real = pick($::ironic::pxe::common::tftp_root, $tftp_root)
|
|
$ipxe_timeout_real = pick($::ironic::pxe::common::ipxe_timeout, $ipxe_timeout)
|
|
$uefi_ipxe_bootfile_name_real = pick($::ironic::pxe::common::uefi_ipxe_bootfile_name, $uefi_ipxe_bootfile_name)
|
|
|
|
if $ip_version != undef {
|
|
warning('The ironic::drivers::pxe:ip_version parameter is deprecated and will be removed in the future.')
|
|
}
|
|
$ip_version_real = pick($ip_version, $::os_service_default)
|
|
|
|
if $pxe_append_params != undef {
|
|
warning('The ironic::drivers::pxe::pxe_append_params parameter is deprecated. \
|
|
Use the kernel_append_params parameter instead')
|
|
}
|
|
$kernel_append_params_real = pick($pxe_append_params, kernel_append_params)
|
|
ironic_config {
|
|
'pxe/pxe_append_params': ensure => absent
|
|
}
|
|
|
|
# Configure ironic.conf
|
|
ironic_config {
|
|
'pxe/kernel_append_params': value => $kernel_append_params;
|
|
'pxe/pxe_bootfile_name': value => $pxe_bootfile_name;
|
|
'pxe/pxe_config_template': value => $pxe_config_template;
|
|
'pxe/ipxe_bootfile_name': value => $ipxe_bootfile_name;
|
|
'pxe/ipxe_config_template': value => $ipxe_config_template;
|
|
'pxe/tftp_server': value => $tftp_server;
|
|
'pxe/tftp_root': value => $tftp_root_real;
|
|
'pxe/images_path': value => $images_path;
|
|
'pxe/tftp_master_path': value => $tftp_master_path;
|
|
'pxe/instance_master_path': value => $instance_master_path;
|
|
'pxe/uefi_pxe_bootfile_name': value => $uefi_pxe_bootfile_name;
|
|
'pxe/uefi_pxe_config_template': value => $uefi_pxe_config_template;
|
|
'pxe/uefi_ipxe_bootfile_name': value => $uefi_ipxe_bootfile_name_real;
|
|
'pxe/ipxe_timeout': value => $ipxe_timeout_real;
|
|
'pxe/boot_retry_timeout': value => $boot_retry_timeout;
|
|
'pxe/boot_retry_check_interval': value => $boot_retry_check_interval;
|
|
'pxe/dir_permission': value => $dir_permission;
|
|
'pxe/file_permission': value => $file_permission;
|
|
'pxe/loader_file_paths': value => join(any2array($loader_file_paths), ',');
|
|
'pxe/ipxe_enabled': ensure => absent;
|
|
'pxe/ip_version': value => $ip_version_real;
|
|
}
|
|
|
|
if $enable_ppc64le {
|
|
# FXIME(tonyb): As these are really hash values it would be better to model
|
|
# them that way. We can do that later, probably when we add another
|
|
# architecture
|
|
ironic_config {
|
|
# NOTE(tonyb): This first value shouldn't be needed but seems to be?
|
|
# NOTE(TheJulia): Likely not needed as this just points to the default,
|
|
# and when the explicit pxe driver is used everything should fall to
|
|
# it but in the interest of minimizing impact, the output result
|
|
# is preserved as we now just allow the default for normal template
|
|
# operation to be used.
|
|
'pxe/pxe_config_template_by_arch': value => 'ppc64le:$pybasedir/drivers/modules/pxe_config.template';
|
|
'pxe/pxe_bootfile_name_by_arch': value => 'ppc64le:config';
|
|
}
|
|
}
|
|
|
|
}
|