Skip to content

Commit

Permalink
docs: update proxmox.md
Browse files Browse the repository at this point in the history
Update proxmox guide to show example of using qemu-guest-agent.

Signed-off-by: USBAkimbo <[email protected]>
Signed-off-by: Noel Georgi <[email protected]>
  • Loading branch information
USBAkimbo authored and frezbo committed May 13, 2024
1 parent 851b91a commit 26519ce
Showing 1 changed file with 38 additions and 1 deletion.
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand All @@ -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.
Expand Down Expand Up @@ -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.
Expand Down

0 comments on commit 26519ce

Please sign in to comment.