- index.rst: changed contributing link to :ref:
- found CONTRIBUTING.rst had rtd.io links still in it
- added labels to several topic pages to fix that issue
- changed all of those to :ref: links

Since 3.12 is the development release, failures of it
shouldn't fail the overall build.

Handles any situation where `status.json` does not yet contain
datasource information, by gracefully fulfilling a 
`datasource=None` in `StatusDetails`.

LP: #1997559

Bump the version in cloudinit/version.py to 22.4.2 and
update ChangeLog.

Currently, FreeBSD ignores IPv6 addresses. This PR adds support for static IPv6 addresses

Remove managed key in network config on LXD preseed configs
as it is not a valid key in LXD > v4.

As previously discussed, the Analyze page contains the content we want
to present under the "Performance" topic and should be uprated.

I have changed the title of the "Analyze" page to "Performance" so
that it shows correctly in the LHS menu. The anchors are the same,
and I have not changed the file name so as to avoid having to update
any links.

I took the opportunity to make some minor tidying edits to the text.
Hopefully these will add clarity and not change the intended meaning.

Currently, Alibaba cloud provides a security hardening mode for its
metadata server, which is alike IMDSv2, and we should support it.

Detailed information be found here:
https://www.alibabacloud.com/help/en/elastic-compute-service/latest/view-instance-metadata#concept-dwj-y1x-wgb

All components of cloudinit need to run, and in a specific order.
If cloudinit is to be enabled, it should only rely on one variable.
This change better encodes that, than canonical#161

Sponsored by: FreeBSD Foundation

This commit adds Rocky Linux, AlmaLinux, CloudLinux, EuroLinux, Miracle
Linux, and Virtuozzo to the is_rhel list. Recent downstream patch from
Red Hat causes issues with RHEL derivatives with the cloud.cfg template,
which leads to derivatives having to make small changes to bring back
expected functionality.

overriding __init__() means we need to call super().__init__()

Sponsored By: FreeBSD Foundation

…#1888)

* Add support for setting uid when creating users on FreeBSD

* Test if uid in config is used when creating user in FreeBSD

* Merge two branches in if statement.

Unit test uid in pw call for create user on freebsd.

Guide the user through setting up a virtual machine.
Introduce commonly used terminology and architecture.
Include a debugging page and example script to guide
the audience through pitfalls.

Networkd supports multiple [Route] sections within the same file.
Currently all [Route] section tags are squashed into one and if there
is a default gateway it means defining a device route is not possible
as the target is set to the default gateway.

This patch adds support for multiple [Route] sections allowing us to
support device routes. This is done by tracking each route in the route
list individually and ensuring the key-value pairs are maintained within
their respective [Route] section. This both maintains backwards
compatibility with previous behavior and allows the specification of
routes with no destination IP, causing the destination to be added with
a device target.

It was accidentally removed in f1a9e44.

If utf-8 characters are used in the report, it will fail to encode:

azure.py[ERROR]: exception while reporting ready: 'latin-1' codec can't
encode characters in position 392-397:
Body ('乱写一些单词') is not valid Latin-1.
Use body.encode('utf-8') if you want to send it encoded in UTF-8.

Explicitly encode document as utf-8.

Signed-off-by: Chris Patterson cpatterson@microsoft.com

Add autoinstall pointer to subiquity docs to FAQ.

Remove cc_ubuntu_autoinstall from docs module definitions
since it doesn't give users actionable information.

On netplan systems, network v2 is passed directly though and written
to /etc/netplan/50-cloud-init.yaml without validation. Current
netplan configuration provides the ability to configure sensitive
information such as `wifi:access-points:password`.

Limit permissions for /etc/network/50-cloud-init.yaml as read-only
for root (600). Since configuration or modification or netplan config
needs to be performed by an admin user this permission restriction
aligns with netplan tooling.

Set root read-only only always and not just 'if' sensitive material
exists within custom config because it will add confusion to have
two expected modes for this file based on external conditions.

Avoid breakage on newer Azure SDK versions
Bump commit to c9db5bfc

…nical#1895)

LP: #1999042

net: clarify network function name and docstring

…l#1908)

Bump commit to 89804926

To make retaining original behavior in stable downstreams easier,
provide a feature flag NETPLAN_CONFIG_ROOT_READ_ONLY so
/etc/netplan/50-cloud-init.yaml config can remain unchanged as
world-readable.

Set this flag False to ensure world-readable 50-cloud-init.yaml.

Add tests.integration_tests.util.get_feature_flag to extract
feature values from cloudinit.features on test system.

Co-authored-by: James Falcon <james.falcon@canonical.com>

Use the sphinx-copybutton extension.
Separate commands from output for ease of use.

…l#1893)

LP: #1998655

Currently tests attempt to delete /run/dhclient.pid and
/run/dhclient.leases from the host. This leads to host-dependent test
failure. Fix it.

Add coverage for:
- atomic_helper.write_file()
- util.human2bytes()

Add test and support for parsing IEC prefix format.

NoCloud meta-data seedfrom (or kernel commandline seedfrom) URL can
now provide variable expansion for system-specific DMI values as seen
in /sys/class/dmi/id on Linux or kenv on FreeBSD platforms.

Variable names of the format __dmi.SOME_VAR__ will be replaced when
determining the URL from which NoCloud datasource GETs its user-data
and meta-data.

This allows for a common templated seedfrom URL which can be reused
for mass deployments, but can allow for unique URLs based on classes
of DMI system characteristics such as chassis serial, product name,
UUID etc.

LP: #1994980