# This file is part of cloud-init. See LICENSE file for license information. """Ubuntu Drivers: Interact with third party drivers in Ubuntu.""" import logging import os from textwrap import dedent from cloudinit.cloud import Cloud from cloudinit.distros import Distro try: import debconf HAS_DEBCONF = True except ImportError: debconf = None HAS_DEBCONF = False from cloudinit import subp, temp_utils, type_utils, util from cloudinit.config import Config from cloudinit.config.schema import MetaSchema, get_meta_doc from cloudinit.settings import PER_INSTANCE LOG = logging.getLogger(__name__) distros = ["ubuntu"] meta: MetaSchema = { "id": "cc_ubuntu_drivers", "name": "Ubuntu Drivers", "title": "Interact with third party drivers in Ubuntu.", "description": dedent( """\ This module interacts with the 'ubuntu-drivers' command to install third party driver packages.""" ), "distros": distros, "examples": [ dedent( """\ drivers: nvidia: license-accepted: true """ ) ], "frequency": PER_INSTANCE, "activate_by_schema_keys": ["drivers"], } __doc__ = get_meta_doc(meta) OLD_UBUNTU_DRIVERS_STDERR_NEEDLE = ( "ubuntu-drivers: error: argument <command>: invalid choice: 'install'" ) # Use a debconf template to configure a global debconf variable # (linux/nvidia/latelink) setting this to "true" allows the # 'linux-restricted-modules' deb to accept the NVIDIA EULA and the package # will automatically link the drivers to the running kernel. NVIDIA_DEBCONF_CONTENT = """\ Template: linux/nvidia/latelink Type: boolean Default: true Description: Late-link NVIDIA kernel modules? Enable this to link the NVIDIA kernel modules in cloud-init and make them available for use. """ X_LOADTEMPLATEFILE = "X_LOADTEMPLATEFILE" def install_drivers(cfg, pkg_install_func, distro: Distro): if not isinstance(cfg, dict): raise TypeError( "'drivers' config expected dict, found '%s': %s" % (type_utils.obj_name(cfg), cfg) ) cfgpath = "nvidia/license-accepted" # Call translate_bool to ensure that we treat string values like "yes" as # acceptance and _don't_ treat string values like "nah" as acceptance # because they're True-ish nv_acc = util.translate_bool(util.get_cfg_by_path(cfg, cfgpath)) if not nv_acc: LOG.debug("Not installing NVIDIA drivers. %s=%s", cfgpath, nv_acc) return if not subp.which("ubuntu-drivers"): LOG.debug( "'ubuntu-drivers' command not available. " "Installing ubuntu-drivers-common" ) pkg_install_func(["ubuntu-drivers-common"]) driver_arg = "nvidia" version_cfg = util.get_cfg_by_path(cfg, "nvidia/version") if version_cfg: driver_arg += ":{}".format(version_cfg) LOG.debug( "Installing and activating NVIDIA drivers (%s=%s, version=%s)", cfgpath, nv_acc, version_cfg if version_cfg else "latest", ) # Register and set debconf selection linux/nvidia/latelink = true tdir = temp_utils.mkdtemp(dir=distro.get_tmp_exec_path(), needs_exe=True) debconf_file = os.path.join(tdir, "nvidia.template") try: util.write_file(debconf_file, NVIDIA_DEBCONF_CONTENT) with debconf.DebconfCommunicator("cloud-init") as dc: dc.command(X_LOADTEMPLATEFILE, debconf_file) except Exception as e: util.logexc( LOG, "Failed to register NVIDIA debconf template: %s", str(e) ) raise finally: if os.path.isdir(tdir): util.del_dir(tdir) try: subp.subp(["ubuntu-drivers", "install", "--gpgpu", driver_arg]) except subp.ProcessExecutionError as exc: if OLD_UBUNTU_DRIVERS_STDERR_NEEDLE in exc.stderr: LOG.warning( "the available version of ubuntu-drivers is" " too old to perform requested driver installation" ) elif "No drivers found for installation." in exc.stdout: LOG.warning("ubuntu-drivers found no drivers for installation") raise def handle(name: str, cfg: Config, cloud: Cloud, args: list) -> None: if "drivers" not in cfg: LOG.debug("Skipping module named %s, no 'drivers' key in config", name) return if not HAS_DEBCONF: LOG.warning( "Skipping module named %s, 'python3-debconf' is not installed", name, ) return install_drivers( cfg["drivers"], cloud.distro.install_packages, cloud.distro )
Name | Type | Size | Permission | Actions |
---|---|---|---|---|
__pycache__ | Folder | 0755 |
|
|
schemas | Folder | 0755 |
|
|
__init__.py | File | 14 B | 0644 |
|
cc_ansible.py | File | 8.69 KB | 0644 |
|
cc_apk_configure.py | File | 5.66 KB | 0644 |
|
cc_apt_configure.py | File | 41.99 KB | 0644 |
|
cc_apt_pipelining.py | File | 2.71 KB | 0644 |
|
cc_bootcmd.py | File | 2.85 KB | 0644 |
|
cc_byobu.py | File | 3.65 KB | 0644 |
|
cc_ca_certs.py | File | 9.13 KB | 0644 |
|
cc_chef.py | File | 13.77 KB | 0644 |
|
cc_disable_ec2_metadata.py | File | 2.03 KB | 0644 |
|
cc_disk_setup.py | File | 32.36 KB | 0644 |
|
cc_fan.py | File | 3.02 KB | 0644 |
|
cc_final_message.py | File | 3.39 KB | 0644 |
|
cc_growpart.py | File | 21.03 KB | 0644 |
|
cc_grub_dpkg.py | File | 6.65 KB | 0644 |
|
cc_install_hotplug.py | File | 3.81 KB | 0644 |
|
cc_keyboard.py | File | 2.38 KB | 0644 |
|
cc_keys_to_console.py | File | 3.61 KB | 0644 |
|
cc_landscape.py | File | 5.31 KB | 0644 |
|
cc_locale.py | File | 1.86 KB | 0644 |
|
cc_lxd.py | File | 18.14 KB | 0644 |
|
cc_mcollective.py | File | 6.1 KB | 0644 |
|
cc_migrator.py | File | 3.49 KB | 0644 |
|
cc_mounts.py | File | 19.71 KB | 0644 |
|
cc_ntp.py | File | 20.69 KB | 0644 |
|
cc_package_update_upgrade_install.py | File | 4.54 KB | 0644 |
|
cc_phone_home.py | File | 5.48 KB | 0644 |
|
cc_power_state_change.py | File | 7.41 KB | 0644 |
|
cc_puppet.py | File | 14.1 KB | 0644 |
|
cc_reset_rmc.py | File | 4.47 KB | 0644 |
|
cc_resizefs.py | File | 10.73 KB | 0644 |
|
cc_resolv_conf.py | File | 4.98 KB | 0644 |
|
cc_rh_subscription.py | File | 16.97 KB | 0644 |
|
cc_rightscale_userdata.py | File | 4.28 KB | 0644 |
|
cc_rsyslog.py | File | 13.48 KB | 0644 |
|
cc_runcmd.py | File | 2.9 KB | 0644 |
|
cc_salt_minion.py | File | 5.88 KB | 0644 |
|
cc_scripts_per_boot.py | File | 1.66 KB | 0644 |
|
cc_scripts_per_instance.py | File | 1.81 KB | 0644 |
|
cc_scripts_per_once.py | File | 1.76 KB | 0644 |
|
cc_scripts_user.py | File | 1.85 KB | 0644 |
|
cc_scripts_vendor.py | File | 2.29 KB | 0644 |
|
cc_seed_random.py | File | 4.72 KB | 0644 |
|
cc_set_hostname.py | File | 5.13 KB | 0644 |
|
cc_set_passwords.py | File | 10.97 KB | 0644 |
|
cc_snap.py | File | 6.3 KB | 0644 |
|
cc_spacewalk.py | File | 3.43 KB | 0644 |
|
cc_ssh.py | File | 14.86 KB | 0644 |
|
cc_ssh_authkey_fingerprints.py | File | 4.22 KB | 0644 |
|
cc_ssh_import_id.py | File | 6.12 KB | 0644 |
|
cc_timezone.py | File | 1.46 KB | 0644 |
|
cc_ubuntu_advantage.py | File | 17 KB | 0644 |
|
cc_ubuntu_autoinstall.py | File | 4.5 KB | 0644 |
|
cc_ubuntu_drivers.py | File | 4.56 KB | 0644 |
|
cc_update_etc_hosts.py | File | 5.16 KB | 0644 |
|
cc_update_hostname.py | File | 3.87 KB | 0644 |
|
cc_users_groups.py | File | 8.57 KB | 0644 |
|
cc_wireguard.py | File | 9.22 KB | 0644 |
|
cc_write_files.py | File | 6.66 KB | 0644 |
|
cc_write_files_deferred.py | File | 1.68 KB | 0644 |
|
cc_yum_add_repo.py | File | 7.45 KB | 0644 |
|
cc_zypper_add_repo.py | File | 6.59 KB | 0644 |
|
modules.py | File | 11.74 KB | 0644 |
|
schema.py | File | 54.85 KB | 0644 |
|