Role - edpm_accel_drivers

osp.edpm.edpm_accel_drivers role – The main entry point for the edpm_accel_drivers role.

Entry point main – The main entry point for the edpm_accel_drivers role.

Synopsis

  • Installs and configures GPU accelerator drivers on RHEL systems. Supports installation of NVIDIA and AMD GPU drivers from repositories or custom URLs. Uses a plugin-style architecture where new GPU vendors can be added via configuration.

Parameters

Parameter

Comments

edpm_accel_drivers

dictionary

Main configuration dictionary for GPU accelerator drivers

cache_dir

string

The directory to cache downloaded driver packages

Default: "/var/cache/accel-drivers"

cleanup_temp_files

boolean

Whether to cleanup temporary files after driver installation

Choices:

  • false

  • true ← (default)

download

dictionary

Download configuration settings

delay

integer

The seconds between retries for failed download tasks

Default: 60

retries

integer

The number of retries for failed download tasks

Default: 5

features

dictionary

GPU-specific feature configurations

nvidia_mig

dictionary

NVIDIA MIG (Multi-Instance GPU) configuration

geometries

list / elements=string

List of MIG geometry strings, one per GPU. Index 0 applies to GPU 0, index 1 to GPU 1, etc. Each string is passed to nvidia-smi mig -cgi (e.g. “14,14,14,14” or “2g.12gb,2g.12gb”). Required when manage is true. An empty (or shortened) list removes previously configured systemd units and disables MIG on affected GPUs.

Default: []

manage

boolean

Whether to configure NVIDIA MIG (Multi-Instance GPU) partitioning

Choices:

  • false ← (default)

  • true

vendors

dictionary

Map of GPU vendor configurations. Each vendor key (e.g., nvidia_gpu, amd_gpu, intel_gpu) contains its driver installation configuration. New vendors can be added by adding a new key with the same structure.

amd_gpu

dictionary

AMD GPU driver configuration

custom_url

dictionary

AMD GPU custom URL configuration

disable_gpg_check

boolean

Whether to disable GPG check when installing RPM (not recommended for production)

Choices:

  • false ← (default)

  • true

ssl_no_verify

boolean

Whether to disable SSL certificate verification when downloading (not recommended for production)

Choices:

  • false ← (default)

  • true

url

string

Custom AMD driver URL. Must end with .rpm (SUPPORTED) extension. NOTE: file:/// URLs are supported, for example a local NFS mount.

Default: ""

denylist_modules

list / elements=string

List of kernel modules to disable for AMD GPU

Default: ["amdgpu"]

enabled

boolean

Whether to install AMD GPU drivers

Choices:

  • false ← (default)

  • true

repo

dictionary

AMD GPU repository configuration

disable_gpg_check

boolean

Whether to disable GPG check when installing AMD driver (not recommended for production)

Choices:

  • false ← (default)

  • true

gpgkey

string

GPG key URL for AMD repository verification

Default: ""

module_name

string

DNF module name for AMD GPU drivers. Used only if module_stream is set

Default: ""

module_stream

string

DNF module stream for AMD GPU drivers. If set to empty string, no DNF module will be selected

Default: ""

no_basearch

boolean

Set to true for repositories with flat structure (no $basearch subdirectory). The URL will be used as-is without appending /$basearch/

Choices:

  • false ← (default)

  • true

package_name

string

Package name to install from repository for AMD GPU drivers

Default: ""

url

string

AMD repository URL for driver installation

Default: ""

nvidia_gpu

dictionary

NVIDIA GPU driver configuration

custom_url

dictionary

NVIDIA GPU custom URL configuration

disable_gpg_check

boolean

Whether to disable GPG check when installing RPM (not recommended for production)

Choices:

  • false ← (default)

  • true

ssl_no_verify

boolean

Whether to disable SSL certificate verification when downloading (not recommended for production)

Choices:

  • false ← (default)

  • true

url

string

Custom NVIDIA driver URL. Must end with .rpm (SUPPORTED) or .run extension (UNSUPPORTED on RHEL). NOTE: file:/// URLs are supported, for example a local NFS mount.

Default: ""

denylist_modules

list / elements=string

List of kernel modules to disable for NVIDIA GPU

Default: ["nouveau"]

enabled

boolean

Whether to install NVIDIA GPU drivers

Choices:

  • false ← (default)

  • true

repo

dictionary

NVIDIA GPU repository configuration

disable_gpg_check

boolean

Whether to disable GPG check when installing NVIDIA driver (not recommended for production)

Choices:

  • false ← (default)

  • true

gpgkey

string

GPG key URL for NVIDIA repository verification

Default: ""

module_name

string

DNF module name for NVIDIA GPU drivers. Used only if module_stream is set

Default: "nvidia-driver"

module_stream

string

DNF module stream for NVIDIA GPU drivers. If set to empty string, no DNF module will be selected

Default: "latest"

no_basearch

boolean

Set to true for repositories with flat structure (no $basearch subdirectory). The URL will be used as-is without appending /$basearch/

Choices:

  • false ← (default)

  • true

package_name

string

Package name to install from repository for NVIDIA GPU drivers

Default: "nvidia-driver"

url

string

NVIDIA repository URL for driver installation

Default: ""