unistack-org/cloudinit
4
0
Fork 0
Code Issues 1 Pull Requests Packages Projects Releases Wiki Activity
4a25948b53
cloudinit/Documentation/cloud-config-locations.md
kayrus 61e3595520 Added table for cloud-config locations
2015-08-31 12:04:23 +02:00

2.0 KiB
Raw Blame History

Cloud-Config Locations

On every boot, coreos-cloudinit looks for a config file to configure your host. Here is a list of locations which are used by the Cloud-Config utility, depending on your CoreOS platform:

Location Description
/media/configvirtfs/openstack/latest/user_data /media/configvirtfs mount point with config-2 label. It should contain a openstack/latest/user_data relative path. Usually used by cloud providers or in VM installations.
/media/configdrive/openstack/latest/user_data FAT or ISO9660 filesystem with config-2 label and /media/configdrive/ mount point. It should also contain a openstack/latest/user_data relative path. Usually used in installations which are configured by USB Flash sticks or CDROM media.
Kernel command line: cloud-config-url=http://example.com/user_data. You can find this string using this command cat /proc/cmdline. Usually used in PXE or iPXE boots.
/var/lib/coreos-install/user_data When you install CoreOS manually using the coreos-install tool. Usually used in bare metal installations.
/usr/share/oem/cloud-config.yml Path for OEM images.
/var/lib/waagent/CustomData Azure platform uses OEM path for first Cloud-Config initialization and then /var/lib/waagent/CustomData to apply your settings.
http://169.254.169.254/metadata/v1/user-data http://169.254.169.254/2009-04-04/user-data https://metadata.packet.net/userdata DigitalOcean, EC2 and Packet cloud providers correspondingly use these URLs to download Cloud-Config.

You can also run the coreos-cloudinit tool manually and provide a path to your custom Cloud-Config file:

sudo coreos-cloudinit --from-file=/home/core/cloud-config.yaml

This command will apply your custom cloud-config.