alt-orchestra/talos
2
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: update proxmox.md

Browse Source 
Update proxmox guide to show example of using qemu-guest-agent.

Signed-off-by: USBAkimbo <71508071+USBAkimbo@users.noreply.github.com>
Signed-off-by: Noel Georgi <git@frezbo.dev>
This commit is contained in:
USBAkimbo 2024-04-27 04:09:11 +01:00 committed by Noel Georgi
parent 851b91a0e2
commit 26519ceed0
No known key found for this signature in database
GPG Key ID: 21A9F444075C9E36
1 changed files with 38 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
website/content/v1.7/talos-guides/install/virtualized-platforms/proxmox.md
View File

@ -36,7 +36,7 @@ You can download `metal-amd64.iso` via
```bash
mkdir -p _out/
curl https://github.com/siderolabs/talos/releases/download/<version>/metal-<arch>.iso -L -o _out/metal-<arch>.iso
curl https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-<arch>.iso -L -o _out/metal-<arch>.iso
```
For example version `{{< release >}}` for `linux` platform:
@ -46,6 +46,32 @@ mkdir -p _out/
curl https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-amd64.iso -L -o _out/metal-amd64.iso
```
### QEMU guest agent support (iso)
- If you need the QEMU guest agent so you can do guest VM shutdowns of your Talos VMs, then you will need a custom ISO
- To get this, navigate to https://factory.talos.dev/
- Scroll down and select your Talos version (`{{< release >}}` for example)
- Then tick the box for `siderolabs/qemu-guest-agent` and submit
- This will provide you with a link to the bare metal ISO
- The lines we're interested in are as follows
```text
Metal ISO
amd64 ISO
https://factory.talos.dev/image/ce4c980550dd2ab1b17bbf2b08801c7eb59418eafe8f279833297925d67c7515/{{< release >}}/metal-amd64.iso
arm64 ISO
https://factory.talos.dev/image/ce4c980550dd2ab1b17bbf2b08801c7eb59418eafe8f279833297925d67c7515/{{< release >}}/metal-arm64.iso
Installer Image
For the initial Talos install or upgrade use the following installer image:
factory.talos.dev/installer/ce4c980550dd2ab1b17bbf2b08801c7eb59418eafe8f279833297925d67c7515:{{< release >}}
```
- Download the above ISO (this will most likely be `amd64` for you)
- Take note of the `factory.talos.dev/installer` URL as you'll need it later
## Upload ISO
From the Proxmox UI, select the "local" storage and enter the "Content" section.
@ -172,6 +198,17 @@ This will create several files in the `_out` directory: `controlplane.yaml`, `wo
>
> Update `controlplane.yaml` and `worker.yaml` config files to point to the correct disk location.
### QEMU guest agent support
For QEMU guest agent support, you can generate the config with the custom install image:
```bash
talosctl gen config talos-proxmox-cluster https://$CONTROL_PLANE_IP:6443 --output-dir _out --installer-image factory.talos.dev/installer/ce4c980550dd2ab1b17bbf2b08801c7eb59418eafe8f279833297925d67c7515:{{< release >}}
```
- In Proxmox, go to your VM --> Options and ensure that `QEMU Guest Agent` is `Enabled`
- The QEMU agent is now configured
## Create Control Plane Node
Using the `controlplane.yaml` generated above, you can now apply this config using talosctl.