diff --git a/README.md b/README.md index 7bdfcbc..1288b7b 100644 --- a/README.md +++ b/README.md @@ -5,3 +5,140 @@ chmod +x all.sh # run ./all.sh + + + +# Cloud images in Proxmox +* [Preparing Cloud-Init Templates](https://pve.proxmox.com/pve-docs/qm.1.html) +* [Cloud-Init Support - Proxmox VE](https://pve.proxmox.com/wiki/Cloud-Init_Support) +* [Proxmox VE Administration Guide](https://pve.proxmox.com/pve-docs/pve-admin-guide.html) + +## A script which automates these steps for multiple distros incl. CoreOS, CentOS, Arch and ALpine +- [create-cloud-template.sh](https://gist.github.com/chriswayg/43fbea910e024cbe608d7dcb12cb8466) + +### Steps for creating an Ubuntu 18.04 cloud template +* Using a ready-to-use Ubuntu image +* [Ubuntu 18.04 LTS (Bionic Beaver) Daily Build](https://cloud-images.ubuntu.com/bionic/current/) + +```sh +wget https://cloud-images.ubuntu.com/bionic/current/bionic-server-cloudimg-amd64.img + +# Create a VM +qm create 9000 --name ubuntu1804-templ --memory 2048 --net0 virtio,bridge=vmbr1 + +# Import the disk in qcow2 format (as unused disk) +qm importdisk 9000 bionic-server-cloudimg-amd64.img local -format qcow2 + +# Attach the disk to the vm using VirtIO SCSI +qm set 9000 --scsihw virtio-scsi-pci --scsi0 /var/lib/vz/images/9000/vm-9000-disk-0.qcow2 + +# Important settings +qm set 9000 --ide2 local:cloudinit --boot c --bootdisk scsi0 --serial0 socket --vga serial0 + +# The initial disk is only 2GB, thus we make it larger +qm resize 9000 scsi0 +30G + +# Using a dhcp server on vmbr1 or use static IP +qm set 9000 --ipconfig0 ip=dhcp +#qm set 9000 --ipconfig0 ip=10.10.10.222/24,gw=10.10.10.1 + +# user authentication for 'ubuntu' user (optional password) +qm set 9000 --sshkey ~/.ssh/id_rsa.pub +#qm set 9000 --cipassword AweSomePassword + +# check the cloud-init config +qm cloudinit dump 9000 user + +# create tempalte and a linked clone +qm template 9000 +qm clone 9000 190 --name ubuntu1804-1 +qm start 190 + +rm -v bionic-server-cloudimg-amd64.img +``` + +* Login with: `ssh ubuntu@10.10.10.190` + +### Steps for creating a Debian 10 cloud template +* Using a ready-to-use Debian image +* [Debian Official Cloud Images for OpenStack](https://cdimage.debian.org/cdimage/openstack/) + +``` +wget https://cdimage.debian.org/cdimage/openstack/current/debian-10.0.2-20190721-openstack-amd64.qcow2 + +# Create a VM +qm create 9110 --name debian10-cloud --memory 2048 --net0 virtio,bridge=vmbr1 + +# Import the disk in qcow2 format (as unused disk) +qm importdisk 9110 debian-10.0.2-20190721-openstack-amd64.qcow2 local -format qcow2 + +# Attach the disk to the vm using VirtIO SCSI +qm set 9110 --scsihw virtio-scsi-pci --scsi0 /var/lib/vz/images/9110/vm-9110-disk-0.qcow2 + +# Important settings +qm set 9110 --ide2 local:cloudinit --boot c --bootdisk scsi0 --serial0 socket --vga serial0 + +# The initial disk is only 2GB, thus we make it larger +qm resize 9110 scsi0 +30G + +# Using a dhcp server on vmbr1 or use static IP +qm set 9110 --ipconfig0 ip=dhcp +#qm set 9110 --ipconfig0 ip=10.10.10.222/24,gw=10.10.10.1 + +# user authentication for 'debian' user (optional password) +qm set 9110 --sshkey ~/.ssh/id_rsa.pub +#qm set 9110 --cipassword AweSomePassword + +# check the cloud-init config +qm cloudinit dump 9110 user + +# create tempalte and a linked clone +qm template 9110 +qm clone 9110 191 --name debian10-1 +qm start 191 + +rm -v debian-10.0.2-20190721-openstack-amd64.qcow2 +``` + +* Login with: `ssh debian@10.10.10.191` + +#### To resize the VM disk later +``` +qm shutdown 190 && qm wait +qm resize 190 scsi0 +8G +qm start 190 +``` + +### To fully disable cloud-init +When booting under *systemd*, you can disable cloud-init completely by either: +* creating a file: `sudo touch /etc/cloud/cloud-init.disabled` +* or adding `cloud-init=disabled` to the kernel command line as found in `/proc/cmdline` + +### To partially disable cloud-init +To partially disable some functions, modify: `/etc/cloud/cloud.cfg`, for example to disable network configuration: +```sh +sudo su - +echo "network: {config: disabled}" > /etc/cloud/cloud.cfg.d/99-disable-network-config.cfg +``` + +### To show the Grub Menu on the serial console +`sudo nano /etc/default/grub config` + +``` +GRUB_TERMINAL="console serial" +``` + +`sudo update-grub` + +### Checking cloud-init + +* [Cloud-init v.18.2: CLI subcommands | Ubuntu](https://ubuntu.com/blog/cloud-init-v-18-2-cli-subcommands) +* [Directory layout — Cloud-Init 19.2 documentation](https://cloudinit.readthedocs.io/en/latest/topics/dir_layout.html) +* [Testing and debugging cloud-init — Cloud-Init 19.2 documentation](https://cloudinit.readthedocs.io/en/latest/topics/debugging.html) +[cloud-localds(1) — cloud-image-utils — Debian testing — Debian Manpages](https://manpages.debian.org/testing/cloud-image-utils/cloud-localds.1.en.html) + +### Convert Images +https://docs.openstack.org/image-guide/convert-images.html +``` +qemu-img convert -f raw -O qcow2 bionic-server-cloudimg-amd64.img bionic-server-cloudimg-amd64.qcow2 +``` \ No newline at end of file