====== cloud-init ======
De-facto-standard für die Initialisierung cloud - alle wichtigen Linux Distributionen + FreeBSD.
===== Merkmale =====
* basiert auf einer yaml config
* läuft als oneshot-dienst in [[software:systemd]]
* hat viele Module (kann z.B. chef oder puppet-code im stand-alone-modus laden)
* Frequenz (frequency) einstellbar (once, instance, always), ''/etc/cloud/cloud.cfg''
* datasource provider:
* EC2 style metadata server
* config-drive (openstack-style/cloudstack ab 4.11) entweder immer individuell oder nur defaults über und dann userdata im image verändert:
* https://cloudinit.readthedocs.io/en/latest/topics/datasources/configdrive.html
* https://github.com/jriguera/ansible-ironic-standalone/wiki/Cloud-Init-and-Config-Drive
===== Images =====
* Debian: https://cdimage.debian.org/images/cloud/
* 10 "buster": https://cdimage.debian.org/images/cloud/buster/latest/debian-10-genericcloud-amd64.qcow2
* 11 "bullseye": https://cdimage.debian.org/images/cloud/bullseye/latest/debian-11-genericcloud-amd64.qcow2
* Ubuntu:
* 18.04 "bionic": https://cloud-images.ubuntu.com/bionic/current/bionic-server-cloudimg-arm64.img
* 20.04 "focal": https://cloud-images.ubuntu.com/focal/current/focal-server-cloudimg-amd64.img
* 22.04 "jammy": https://cloud-images.ubuntu.com/jammy/current/jammy-server-cloudimg-amd64.img
* 24.04 "noble": https://cloud-images.ubuntu.com/noble/current/noble-server-cloudimg-amd64.img
* CentOS (incl. stream): https://cloud.centos.org/centos/
===== datasource =====
[[https://cloudinit.readthedocs.io/en/latest/topics/datasources/configdrive.html|configdrive]] / nocloud data source
openstack/latest/
meta_data.json
network_data.json
user_data
vendor_data.json
==== Dual-Stack ====
Der YAML-parser wirft bei doppelter v4/v6 (inet/inet6)-Konfiguration den folgenden parsing-Fehler aus: cloudinit.net.ParserError interface can only be defined once
Der "Trick" ist das gleiche Interface nochmal mit ":0" anzugeben, das wird dann als verschiedenes interface interpretiert.
network-interfaces: |
iface eth0 inet static
address 1.2.3.4/24
gateway 1.2.3.1
iface eth0:0 inet6 static
address 2a00:1:2:3::4/64
gateway 2a00:1:2:3::1
Die Netzwerkkonfiguration landet dann in:
* /var/lib/cloud/seed/nocloud-net/network-config (nocloud)
* /etc/network/interfaces.d/50-cloud-init.cfg (ifupdown)
* /etc/netplan/50-cloud-init.yaml (netplan)
===== weitere Partitionen =====
Standardmäßig vergrößert cloud-init das root-Dateisystem auf die maximale Größe des virtuellen Datenträgers ("ephemeral disk").
Beispiel: zwei zusätzliche Partitionen mit 10G und 30G Größe:
#cloud-config
growpart:
mode: off
runcmd:
# Parted asks whether to fix /dev/vda to use all available space, we reply "Fix" and continue
# Resize primary partition to 10GB
- "printf 'Fix\n1\nyes\n10GB\n' | parted ---pretend-input-tty /dev/vda resizepart"
# Prepare partitions
- "parted -s /dev/vda mkpart DATA ext4 10GB 20GB"
- "parted -s /dev/vda mkpart DATA ext4 20GB 50GB"
# Configure new partitions
- "echo $(parted /dev/vda -s print|grep DATA |awk '/^\ *[0-9]+/{print $1}') > /partition_nums.txt"
- "for i in $(cat /partition_nums.txt); do mkfs.ext4 /dev/vda${i}; done"
- "for i in $(cat /partition_nums.txt); do e2label /dev/vda${i} DATA${i}; done"
- "for i in $(cat /partition_nums.txt); do mkdir -p /mnt/disks/data${i}; done"
- "for i in $(cat /partition_nums.txt); do mount -t ext4 /dev/vda${i} /mnt/disks/data${i}; done"
- "for i in $(cat /partition_nums.txt); do echo LABEL=DATA${i} /mnt/disks/data${i} ext4 defaults 0 0 | sudo tee -a /etc/fstab; done"
# System is not aware of new space on main partition. Needs refresh.
- "resize2fs /dev/vda1"
https://docs.syseleven.de/syseleven-stack/de/howtos/repartition-vm-disk
===== Code =====
https://github.com/stefanux/cloud-init-example
===== Links =====
* **cloud-init Beispiele**: https://cloudinit.readthedocs.io/en/stable/topics/examples.html
* https://github.com/canonical/cloud-init
* [[https://registry.terraform.io/providers/Telmate/proxmox/latest/docs/guides/cloud_init|cloud-init + terraform]]
* KVM+cloud-init: https://stafwag.github.io/blog/blog/2019/03/03/howto-use-centos-cloud-images-with-cloud-init/
* virtualbox https://superuser.com/questions/827977/use-cloud-init-with-virtualbox
* proxmox (nocloud-v1, configdrive-v2 data sources): siehe [[software:proxmox|Cloud-init]]
* Ansible: https://github.com/Jooho/ansible-role-kvm-cloud-init-vm
* Vorträge:
* https://www.youtube.com/watch?v=2_m6EUo6VOI
* https://www.youtube.com/watch?v=1joQfUZQcPg
* Using Cloud Images in KVM https://www.theurbanpenguin.com/using-cloud-images-in-kvm/
===== Problembehandung =====
==== Passwort aus user-config setzen ====
Die Passwörter für root und den Standardbenutzer will man nicht als Klartext auf einem Server rumliegen haben. Daher RANDOM benutzen oder einen hash.
Leider werden nicht alle hashes erkannt (z.B. der Standardmäßig bei Debian11 verwendet yescrypt mit $y nicht) weil die Unterscheidung zwischen Klartext und Hash mit einem regex vorgenommen wird (r'\$(1|2a|2y|5|6)(\$.+){2}').
Daher am besten ein bcrypt-hash für cloud-init hinterlegen und ggf. später mit ansible neu setzen.
Mögliche Konfiguration https://cloudinit.readthedocs.io/en/latest/topics/modules.html
chpasswd:
list:
- root:{{ baserole_root_password_hash }}
==== Kernel panic nach resize ====
Nach disk-resize kommt es zu einer kernel-panic. Grund ist ein fehlendes serielles Gerät wenn das Image Konsolenparameter (wie hier Debian11) von "console=tty0 console=ttyS0,115200" hat.
Hier der Fix für libvirt:
"The problem is "fixed", if you remove '-serial none' from the kvm cmdline, and thus get the default serial device that kvm appends.
The original test.xml can be fixed in a similar manner by simply adding:
It can also be fixed by mounting the image and removing 'console=ttyS0' from the kernel command lines in /boot/grub/grub.cfg.
Its hard to see, because observing it makes it work. But, I suspect that the root of the problem is that cloud-initramfs-growpart is writing to stdout, which is redirected to /dev/console, and /dev/console writes are going to the non-existant device 'ttyS0' (as told to by the command line)."
[[https://bugs.launchpad.net/ubuntu/+source/cloud-initramfs-tools/+bug/1123220|Quelle]]
==== FQDN in /etc/hosts zeigt auf 127.0.1.1 ====
Default is:
127.0.1.1 $FQDN $Hostname
Lösungsweg:
* 'manage_etc_hosts' as True
* Anpassung des master file in /etc/cloud/templates/hosts.debian.tmpl
* oder ändern/entfernen manage_etc_hosts in /etc/cloud/cloud.cfg oder cloud-config from user-data
==== Debugging von cloud-init ====
auf dem host: /var/log/cloud-init-output.log
==== cloud-init aufräumen ====
cloud-init reset und logs entfernen: cloud-init clean -l