canonical / canonical/cloud-init

[docs]: document default behaviors

Open
#5,650 0 comments 1 reaction 0 assignees View on GitHub
documentation
Dominant language
Python
Stars
3.8k
Forks
1.1k
Avg merge
2d 23h
Merged PRs (30d)
18

Description

# Documentation request

Cloud-init does several things on first boot without any configuration that a user may want to be aware of.

Some of these behaviors are cloud-specific (ex: azure, cloudstack: setting default password).
Some of these behaviors occur on most or all clouds (ex: generate ssh host keys, install user-provided ssh public keys, etc).

Many default behaviors may be modified or overridden using cloud-config.

The problem is that most users are not aware of what cloud-init does by default, and this is not documented. A new explanation page that describes cloud-init's default behaviors would be very useful.

A good start to documenting this would be to create a short summary of what happens when no configuration is passed in each cloud-config module whose metaschema contains `"activate_by_schema_keys": [],`.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.