proxmox-mirrors/pve-docs
1
0
Fork 0
mirror of https://git.proxmox.com/git/pve-docs synced 2025-04-30 18:44:56 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

add cloudinit dump and snippets documentation

Browse Source 
Adds documentation for the cloudinit snippets support and how 'qm
cloudinit dump' can be used to get a base config file.

Signed-off-by: Mira Limbeck <m.limbeck@proxmox.com>
This commit is contained in:
Mira Limbeck 2019-06-25 11:36:33 +02:00 committed by Thomas Lamprecht
parent 270757a162
commit a3e7e4e350
1 changed files with 36 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
qm-cloud-init.adoc
View File

@ -131,6 +131,42 @@ commands for reducing the line length. Also make sure to adopt the IP
setup for your specific environment.
Custom Cloud-Init Configuration
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The Cloud-Init integration also allows custom config files to be used instead
of the automatically generated configs. This is done via the `cicustom`
option on the command line:
----
qm set 9000 --cicustom "user=<volume>,network=<volume>,meta=<volume>"
----
The custom config files have to be on a storage that supports snippets and have
to be available on all nodes the VM is going to be migrated to. Otherwise the
VM won't be able to start.
For example:
----
qm set 9000 --cicustom "user=local:snippets/userconfig.yaml"
----
There are three kinds of configs for Cloud-Init. The first one is the `user`
config as seen in the example above. The second is the `network` config and
the third the `meta` config. They can all be specified together or mixed
and matched however needed.
The automatically generated config will be used for any that don't have a
custom config file specified.
The generated config can be dumped to serve as a base for custom configs:
----
qm cloudinit dump 9000 user
----
The same command exists for `network` and `meta`.
Cloud-Init specific Options
~~~~~~~~~~~~~~~~~~~~~~~~~~~