Scroll to navigation

CLOUD-INIT(1) General Commands Manual CLOUD-INIT(1)

NAME

cloud-init - Cloud instance initialization

SYNOPSIS

cloud-init [-h] [-d] [-f FILES] [--force] [-v] [SUBCOMMAND]

DESCRIPTION

Cloud-init provides a mechanism for cloud instance initialization. This is done by identifying the cloud platform that is in use, reading provided cloud metadata and optional vendor and user data, and then initializing the instance as requested.

Generally, this command is not normally meant to be run directly by the user. However, some subcommands may useful for development or debug of deployments.

OPTIONS

Show help message and exit.

Show additional pre-action logging (default: False).

Use additional YAML configuration files.

Force running even if no datasource is found (use at your own risk).

Show program's version number and exit.

SUBCOMMANDS

Please see the help output for each subcommand for additional details, flags, and subcommands.

Analyze cloud-init logs and data.

Collect and tar all cloud-init debug info.

Remove logs and artifacts so cloud-init can re-run.

Run development tools. See help output for subcommand details.

List defined features.

Initialize cloud-init and execute initial modules.

Activate modules using a given configuration key.

Query standardized instance metadata from the command line.

Validate cloud-config files using jsonschema.

Run a single module.

Report cloud-init status or wait on completion.

EXIT STATUS

0 - Success
1 - Error - Cloud-init failed.
2 - Recoverable error - Cloud-init completed but experienced errors.

COPYRIGHT

Copyright (C) 2020 Canonical Ltd. License GPL-3 or Apache-2.0

SEE ALSO

Full documentation at: <https://cloudinit.readthedocs.io>