X-Git-Url: https://git.proxmox.com/?p=pve-docs.git;a=blobdiff_plain;f=qm-cloud-init-opts.adoc;h=a03f3ac56cc694d72a7e05aa56fad9107584b982;hp=705a8c507c6d2d86be24be46fedf54f859a37c3a;hb=HEAD;hpb=65c8d802b99295cb33a3667f256cd7749d764c70 diff --git a/qm-cloud-init-opts.adoc b/qm-cloud-init-opts.adoc index 705a8c5..8e0e920 100644 --- a/qm-cloud-init-opts.adoc +++ b/qm-cloud-init-opts.adoc @@ -1,11 +1,36 @@ +`cicustom`: `[meta=] [,network=] [,user=] [,vendor=]` :: + +Specify custom files to replace the automatically generated ones at start. + +`meta`=`` ;; + +Specify a custom file containing all meta data passed to the VM via" + ." cloud-init. This is provider specific meaning configdrive2 and nocloud differ. + +`network`=`` ;; + +To pass a custom file containing all network data to the VM via cloud-init. + +`user`=`` ;; + +To pass a custom file containing all user data to the VM via cloud-init. + +`vendor`=`` ;; + +To pass a custom file containing all vendor data to the VM via cloud-init. + `cipassword`: `` :: Password to assign the user. Using this is generally not recommended. Use ssh keys instead. Also note that older cloud-init versions do not support hashed passwords. -`citype`: `` :: +`citype`: `` :: Specifies the cloud-init configuration format. The default depends on the configured operating system type (`ostype`. We use the `nocloud` format for Linux, and `configdrive2` for windows. +`ciupgrade`: `` ('default =' `1`):: + +do an automatic package upgrade after the first boot. + `ciuser`: `` :: User name to change ssh keys and password for instead of the image's configured default user. @@ -16,10 +41,13 @@ Specify IP addresses and gateways for the corresponding interface. + IP addresses use CIDR notation, gateways are optional but need an IP of the same type specified. + -The special string 'dhcp' can be used for IP addresses to use DHCP, in which case no explicit gateway should be provided. -For IPv6 the special string 'auto' can be used to use stateless autoconfiguration. +The special string 'dhcp' can be used for IP addresses to use DHCP, in which case no explicit +gateway should be provided. +For IPv6 the special string 'auto' can be used to use stateless autoconfiguration. This requires +cloud-init 19.4 or newer. + -If cloud-init is enabled and neither an IPv4 nor an IPv6 address is specified, it defaults to using dhcp on IPv4. +If cloud-init is enabled and neither an IPv4 nor an IPv6 address is specified, it defaults to using +dhcp on IPv4. `gw`=`` ;;