docs: proxmoxve: add promoxve install doc #337
Conversation
| ```bash | ||
| # THIS IS A DEVELOPMENT BUILD | ||
| # TODO: update link with an alpha build | ||
| wget http://bincache.flatcar-linux.net/images/amd64/9999.0.102+kai-proxmox-support/flatcar_production_proxmoxve_image.img.bz2 | bzip2 -d > flatcar_production_proxmoxve_image.img |
There was a problem hiding this comment.
I will check to directly provide uncompressed image. The benefit is not that important:
$ du --si flatcar_production_proxmoxve_image.img
548M flatcar_production_proxmoxve_image.img
$ du --si flatcar_production_proxmoxve_image.img.bz2
546M flatcar_production_proxmoxve_image.img.bz2
There was a problem hiding this comment.
Now done.
| wget http://bincache.flatcar-linux.net/images/amd64/9999.0.102+kai-proxmox-support/flatcar_production_proxmoxve_image.img.bz2 | bzip2 -d > flatcar_production_proxmoxve_image.img | |
| wget http://bincache.flatcar-linux.net/images/amd64/9999.0.102+kai-proxmox-support/flatcar_production_proxmoxve_image.img |
There was a problem hiding this comment.
Complete process for me:
curl -sS http://bincache.flatcar-linux.net/images/amd64/9999.9.100+kai-proxmox-support/flatcar_production_proxmoxve_image.img.bz2 | bzip2 -d > flatcar_production_proxmoxve_image.img
export VM_ID=123
qm create $VM_ID --cores 2 --memory 4096 --net0 "virtio,bridge=vmbr0" --ipconfig0 "ip=dhcp"
# On my Proxmox "out-of-the-box" installation, images are stored on `local-lvm` instead of `local`
qm disk import $VM_ID flatcar_production_proxmoxve_image.img local-lvm
qm set $VM_ID --scsi0 local-lvm:vm-$VM_ID-disk-0
qm set $VM_ID --boot order=scsi0
# Create the cloud-init CD-ROM drive which activates the cloud-init options for the VM.
qm set $VM_ID --ide2 local-lvm:cloudinit
# SKIPPED MANUAL STEP: paste iginition config into /var/lib/vz/snippets/user-data
qm set $VM_ID --cicustom "user=local:snippets/user-data"
| ```bash | ||
| # THIS IS A DEVELOPMENT BUILD | ||
| # TODO: update link with an alpha build | ||
| wget http://bincache.flatcar-linux.net/images/amd64/9999.0.102+kai-proxmox-support/flatcar_production_proxmoxve_image.img.bz2 | bzip2 -d > flatcar_production_proxmoxve_image.img |
There was a problem hiding this comment.
wget | bzip2 -d > … pipes the output from wget itself to bzip, not the downloaded file (that would be wget -O - ), replacing wget with curl would be better.
| In order to create a VM with our image we'll need to use the command line. Open a shell on the hypervisor, download the image and convert it to RAW : | ||
|
|
||
| ```bash | ||
| qemu-img convert -f qcow2 -O raw flatcar_production_proxmoxve_image.img flatcar_production_proxmoxve_image.bin |
There was a problem hiding this comment.
Converting the image is not required when you use the terminal. qm disk import can import the qcow2 file directly.
| qm disk import $VM_ID flatcar_production_proxmoxve_image.bin local | ||
|
|
||
| # tell the vm to boot from the imported image | ||
| qm set $VM_ID --scsi0 local:$VM_ID/vm-$VM_ID-disk-0.raw |
There was a problem hiding this comment.
Proxmox 8.2 uses a different notation:
qm set $VM_ID --scsi0 local-lvm:vm-$VM_ID-disk-0
| export VM_ID=123 | ||
|
|
||
| # create the vm and import the image to it's disk | ||
| qm create $VM_ID |
There was a problem hiding this comment.
Should include a network interface and probably some CPU/RAM settings:
qm create $VM_ID --cores 2 --memory 4096 --net0 "virtio,bridge=vmbr0" --ipconfig0 "ip=dhcp"
|
|
||
| # create the vm and import the image to it's disk | ||
| qm create $VM_ID | ||
| qm disk import $VM_ID flatcar_production_proxmoxve_image.bin local |
There was a problem hiding this comment.
local-lvm supports disks, local seems to support only ISOs
|
|
||
| ## Configuring the VM with Openstack-style cloud-init config | ||
|
|
||
| Our VM can be booted as-is, however we might want to add a cloud-init configuration. |
There was a problem hiding this comment.
The VM I booted without config drive is not booting - as it stops at the initrd stage and drops into an emergency shell, because the coreos-metadata service fails.
There was a problem hiding this comment.
Fixed by:
# Create the cloud-init CD-ROM drive which activates the cloud-init options for the VM.
qm set $VM_ID --ide2 local-lvm:cloudinit
| - Setting hostname (hostname is always $VM_ID) | ||
| - Writing SSH keys | ||
| - Writing network configuration | ||
|
|
There was a problem hiding this comment.
A small note should be added: if username and password is set, it will not work.
There was a problem hiding this comment.
Rather a big note. I've been messing around with the settings a bit:
- Setting username, password and SSH key via Proxmox-GUI, providing ignition.json only with "ignition" stanza: Doesn't work, Flatcar doesn't initialize.
- Setting username, password and SSH key via Proxmox-GUI, setting same username (w/o pw/key) in ignition: User settings are not merged, no login posssible.
- Setting only SSH key (leaving username/password), user
corew/o SSH key in ignition.json: User settings are not merged, no login posssible. - Hostname is not VM name/ID, console still shows
localhost, when no/etc/hostnameis provided in ignition.json.
Not saying it should be supposed at this point, but this will defninitively be an issue people will run into. Best would be to point out to use ignition config only and not cloud init settings in the GUI.
| ] | ||
| } | ||
| ] | ||
| } |
There was a problem hiding this comment.
it s also worth to add a kernelArguments with autologin here, just to have a more friendly environment for testing this out.
There was a problem hiding this comment.
also, the cloud-init config drive needs to be added in order for the snippet to work.
There was a problem hiding this comment.
This worked for me with ignition:
export VM_ID=124
# create the vm and import the image to it's disk
qm create $VM_ID --cores 2 --memory 4096 --net0 "virtio,bridge=vmbr0" --ipconfig0 "ip=dhcp"
qm disk import $VM_ID flatcar_production_proxmoxve_image.bin local-lvm
# tell the vm to boot from the imported image
qm set $VM_ID --scsi0 local-lvm:vm-$VM_ID-disk-0
qm set $VM_ID --boot order=scsi0
qm set $VM_ID --ide2 local-lvm:cloudinit
qm set $VM_ID --cicustom "user=local:snippets/user-data"
qm start $VM_ID
This PR adds Promox VE install doc for upcoming promoxve OEM release.
It explains how to create a VM using the provided image, and how to configure it using either cloud init or Ignition.