Gecko [ contributie.vriendennsm.nl ]

Name	Size	Permission	Date
__pycache__	[ DIR ]	drwxr-xr-x	2026-07-12 06:55
schemas	[ DIR ]	drwxr-xr-x	2026-07-12 06:55
__init__.py	14 B	-rw-r--r--	2022-11-23 21:17
cc_ansible.py	8.38 KB	-rw-r--r--	2022-11-23 21:17
cc_apk_configure.py	5.75 KB	-rw-r--r--	2022-11-23 21:17
cc_apt_configure.py	33.06 KB	-rw-r--r--	2026-06-01 19:13
cc_apt_pipelining.py	2.82 KB	-rw-r--r--	2022-11-23 21:17
cc_bootcmd.py	2.87 KB	-rw-r--r--	2022-11-23 21:17
cc_byobu.py	3.67 KB	-rw-r--r--	2022-11-23 21:17
cc_ca_certs.py	7.54 KB	-rw-r--r--	2022-11-23 21:17
cc_chef.py	13.79 KB	-rw-r--r--	2022-11-23 21:17
cc_disable_ec2_metadata.py	2.04 KB	-rw-r--r--	2022-11-23 21:17
cc_disk_setup.py	32.76 KB	-rw-r--r--	2022-11-23 21:17
cc_fan.py	3.11 KB	-rw-r--r--	2022-11-23 21:17
cc_final_message.py	3.41 KB	-rw-r--r--	2022-11-23 21:17
cc_growpart.py	19.42 KB	-rw-r--r--	2022-11-23 21:17
cc_grub_dpkg.py	5.49 KB	-rw-r--r--	2022-11-23 21:17
cc_install_hotplug.py	3.81 KB	-rw-r--r--	2022-11-23 21:17
cc_keyboard.py	2.08 KB	-rw-r--r--	2022-11-23 21:17
cc_keys_to_console.py	3.63 KB	-rw-r--r--	2022-11-23 21:17
cc_landscape.py	4.86 KB	-rw-r--r--	2022-11-23 21:17
cc_locale.py	1.88 KB	-rw-r--r--	2022-11-23 21:17
cc_lxd.py	17.96 KB	-rw-r--r--	2022-11-23 21:17
cc_mcollective.py	6.2 KB	-rw-r--r--	2022-11-23 21:17
cc_migrator.py	3.51 KB	-rw-r--r--	2022-11-23 21:17
cc_mounts.py	19.03 KB	-rw-r--r--	2022-11-23 21:17
cc_ntp.py	19.32 KB	-rw-r--r--	2022-11-23 21:17
cc_package_update_upgrade_install.py	4.42 KB	-rw-r--r--	2022-11-23 21:17
cc_phone_home.py	5.5 KB	-rw-r--r--	2022-11-23 21:17
cc_power_state_change.py	7.65 KB	-rw-r--r--	2022-11-23 21:17
cc_puppet.py	13.13 KB	-rw-r--r--	2022-11-23 21:17
cc_refresh_rmc_and_interface.py	5.48 KB	-rw-r--r--	2022-11-23 21:17
cc_reset_rmc.py	4.53 KB	-rw-r--r--	2022-11-23 21:17
cc_resizefs.py	10.07 KB	-rw-r--r--	2022-11-23 21:17
cc_resolv_conf.py	4.77 KB	-rw-r--r--	2022-11-23 21:17
cc_rh_subscription.py	17.05 KB	-rw-r--r--	2022-11-23 21:17
cc_rightscale_userdata.py	4.3 KB	-rw-r--r--	2022-11-23 21:17
cc_rsyslog.py	9.77 KB	-rw-r--r--	2022-11-23 21:17
cc_runcmd.py	2.92 KB	-rw-r--r--	2022-11-23 21:17
cc_salt_minion.py	5.54 KB	-rw-r--r--	2022-11-23 21:17
cc_scripts_per_boot.py	1.68 KB	-rw-r--r--	2022-11-23 21:17
cc_scripts_per_instance.py	1.83 KB	-rw-r--r--	2022-11-23 21:17
cc_scripts_per_once.py	1.78 KB	-rw-r--r--	2022-11-23 21:17
cc_scripts_user.py	1.87 KB	-rw-r--r--	2022-11-23 21:17
cc_scripts_vendor.py	2.31 KB	-rw-r--r--	2022-11-23 21:17
cc_seed_random.py	4.81 KB	-rw-r--r--	2022-11-23 21:17
cc_set_hostname.py	4.86 KB	-rw-r--r--	2022-11-23 21:17
cc_set_passwords.py	11.78 KB	-rw-r--r--	2022-11-23 21:17
cc_snap.py	6.39 KB	-rw-r--r--	2022-11-23 21:17
cc_spacewalk.py	3.52 KB	-rw-r--r--	2022-11-23 21:17
cc_ssh.py	13.98 KB	-rw-r--r--	2022-11-23 21:17
cc_ssh_authkey_fingerprints.py	4.24 KB	-rw-r--r--	2022-11-23 21:17
cc_ssh_import_id.py	5.82 KB	-rw-r--r--	2022-11-23 21:17
cc_timezone.py	1.44 KB	-rw-r--r--	2022-11-23 21:17
cc_ubuntu_advantage.py	16.88 KB	-rw-r--r--	2022-11-23 21:17
cc_ubuntu_autoinstall.py	4.56 KB	-rw-r--r--	2022-11-23 21:17
cc_ubuntu_drivers.py	4.63 KB	-rw-r--r--	2022-11-23 21:17
cc_update_etc_hosts.py	5.11 KB	-rw-r--r--	2022-11-23 21:17
cc_update_hostname.py	3.63 KB	-rw-r--r--	2022-11-23 21:17
cc_users_groups.py	7.6 KB	-rw-r--r--	2022-11-23 21:17
cc_wireguard.py	9.28 KB	-rw-r--r--	2022-11-23 21:17
cc_write_files.py	6.65 KB	-rw-r--r--	2022-11-23 21:17
cc_write_files_deferred.py	1.68 KB	-rw-r--r--	2022-11-23 21:17
cc_yum_add_repo.py	7.44 KB	-rw-r--r--	2022-11-23 21:17
cc_zypper_add_repo.py	6.49 KB	-rw-r--r--	2022-11-23 21:17
modules.py	11.43 KB	-rw-r--r--	2022-11-23 21:17
schema.py	40.29 KB	-rw-r--r--	2022-11-23 21:17

Rename

# Copyright (C) 2011 Canonical Ltd.
# Copyright (C) 2012 Hewlett-Packard Development Company, L.P.
#
# Author: Scott Moser <scott.moser@canonical.com>
# Author: Juerg Haefliger <juerg.haefliger@hp.com>
#
# This file is part of cloud-init. See LICENSE file for license information.

"""Update Etc Hosts: Update the hosts file (usually ``/etc/hosts``)"""

from logging import Logger
from textwrap import dedent

from cloudinit import templater, util
from cloudinit.cloud import Cloud
from cloudinit.config import Config
from cloudinit.config.schema import MetaSchema, get_meta_doc
from cloudinit.settings import PER_ALWAYS

MODULE_DESCRIPTION = """\
This module will update the contents of the local hosts database (hosts file;
usually ``/etc/hosts``) based on the hostname/fqdn specified in config.
Management of the hosts file is controlled using ``manage_etc_hosts``. If this
is set to false, cloud-init will not manage the hosts file at all. This is the
default behavior.

If set to ``true``, cloud-init will generate the hosts file
using the template located in ``/etc/cloud/templates/hosts.tmpl``. In the
``/etc/cloud/templates/hosts.tmpl`` template, the strings ``$hostname`` and
``$fqdn`` will be replaced with the hostname and fqdn respectively.

If ``manage_etc_hosts`` is set to ``localhost``, then cloud-init will not
rewrite the hosts file entirely, but rather will ensure that a entry for the
fqdn with a distribution dependent ip is present (i.e. ``ping <hostname>`` will
ping ``127.0.0.1`` or ``127.0.1.1`` or other ip).

.. note::
    if ``manage_etc_hosts`` is set ``true``, the contents
    of the hosts file will be updated every boot. To make any changes to
    the hosts file persistent they must be made in
    ``/etc/cloud/templates/hosts.tmpl``

.. note::
    for instructions on specifying hostname and fqdn, see documentation for
    ``cc_set_hostname``
"""

distros = ["all"]

meta: MetaSchema = {
    "id": "cc_update_etc_hosts",
    "name": "Update Etc Hosts",
    "title": "Update the hosts file (usually ``/etc/hosts``)",
    "description": MODULE_DESCRIPTION,
    "distros": distros,
    "examples": [
        dedent(
            """\
    # Do not update or manage /etc/hosts at all. This is the default behavior.
    #
    # Whatever is present at instance boot time will be present after boot.
    # User changes will not be overwritten.
    manage_etc_hosts: false
    """
        ),
        dedent(
            """\
    # Manage /etc/hosts with cloud-init.
    # On every boot, /etc/hosts will be re-written from
    # ``/etc/cloud/templates/hosts.tmpl``.
    #
    # The strings '$hostname' and '$fqdn' are replaced in the template
    # with the appropriate values either from the config-config ``fqdn`` or
    # ``hostname`` if provided. When absent, the cloud metadata will be
    # checked for ``local-hostname` which can be split into <hostname>.<fqdn>.
    #
    # To make modifications persistent across a reboot, you must modify
    # ``/etc/cloud/templates/hosts.tmpl``.
    manage_etc_hosts: true
    """
        ),
        dedent(
            """\
    # Update /etc/hosts every boot providing a "localhost" 127.0.1.1 entry
    # with the latest hostname and fqdn as provided by either IMDS or
    # cloud-config.
    # All other entries will be left as is.
    # 'ping `hostname`' will ping 127.0.1.1
    manage_etc_hosts: localhost
    """
        ),
    ],
    "frequency": PER_ALWAYS,
    "activate_by_schema_keys": ["manage_etc_hosts"],
}

__doc__ = get_meta_doc(meta)

def handle(
    name: str, cfg: Config, cloud: Cloud, log: Logger, args: list
) -> None:
    manage_hosts = util.get_cfg_option_str(cfg, "manage_etc_hosts", False)

hosts_fn = cloud.distro.hosts_fn

if util.translate_bool(manage_hosts, addons=["template"]):
        if manage_hosts == "template":
            log.warning(
                "DEPRECATED: please use manage_etc_hosts: true instead of"
                " 'template'"
            )
        (hostname, fqdn, _) = util.get_hostname_fqdn(cfg, cloud)
        if not hostname:
            log.warning(
                "Option 'manage_etc_hosts' was set, but no hostname was found"
            )
            return

# Render from a template file
        tpl_fn_name = cloud.get_template_filename(
            "hosts.%s" % (cloud.distro.osfamily)
        )
        if not tpl_fn_name:
            raise RuntimeError(
                "No hosts template could be found for distro %s"
                % (cloud.distro.osfamily)
            )

templater.render_to_file(
            tpl_fn_name, hosts_fn, {"hostname": hostname, "fqdn": fqdn}
        )

elif manage_hosts == "localhost":
        (hostname, fqdn, _) = util.get_hostname_fqdn(cfg, cloud)
        if not hostname:
            log.warning(
                "Option 'manage_etc_hosts' was set, but no hostname was found"
            )
            return

log.debug("Managing localhost in %s", hosts_fn)
        cloud.distro.update_etc_hosts(hostname, fqdn)
    else:
        log.debug(
            "Configuration option 'manage_etc_hosts' is not set,"
            " not managing %s in module %s",
            hosts_fn,
            name,
        )

# vi: ts=4 expandtab