From 71ed2df27c8b7a7d08587b06b39b30d0770efb1e Mon Sep 17 00:00:00 2001 From: Travis Milum Date: Mon, 8 Jul 2024 15:10:58 -0700 Subject: [PATCH 1/3] Proxmox network requirements --- docs/book/src/capi/providers/proxmox.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/book/src/capi/providers/proxmox.md b/docs/book/src/capi/providers/proxmox.md index cb46c3ab50..0713dabe49 100644 --- a/docs/book/src/capi/providers/proxmox.md +++ b/docs/book/src/capi/providers/proxmox.md @@ -6,6 +6,16 @@ - Set environment variables for `PROXMOX_URL`, `PROXMOX_USERNAME`, `PROXMOX_TOKEN`, `PROXMOX_NODE` - Set optional environment variables `PROXMOX_ISO_POOL`, `PROXMOX_BRIDGE`, `PROXMOX_STORAGE_POOL` to override the default values +## Networking Requirements + +The image build process expects a few things to be in place before the build process will complete successfully. + +1. DHCP must be available to assign the packer VM an IP + * The packer proxmox integration currently does not support the ability to assign static IPs, thus DHCP is required. + * Access to internet hosts is optional, but the VM will not be able to apply any current updates and will need to be manually rebooted to get a clean cloud-init status. +2. The build VM must be accessible via SSH from the host running `make build-proxmox...` +3. The build VM must have DHCP, DNS, HTTP, HTTPS and NTP services available to successfully update the OS packages. + ## Building Images The build [prerequisites](../capi.md#prerequisites) for using `image-builder` for @@ -62,6 +72,7 @@ Then the user (not token) must be given the following permissions on the path `/ *We suggest creating a new role, since no built-in PVE roles covers just these.* + ### Example Prior to building images you need to ensure you have set the required environment variables: From 99bd5516280638fecc9dbcafaf0e412b03b4d24e Mon Sep 17 00:00:00 2001 From: Travis Milum Date: Mon, 8 Jul 2024 15:17:11 -0700 Subject: [PATCH 2/3] Clarification --- docs/book/src/capi/providers/proxmox.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/book/src/capi/providers/proxmox.md b/docs/book/src/capi/providers/proxmox.md index 0713dabe49..55c340f89d 100644 --- a/docs/book/src/capi/providers/proxmox.md +++ b/docs/book/src/capi/providers/proxmox.md @@ -14,7 +14,7 @@ The image build process expects a few things to be in place before the build pro * The packer proxmox integration currently does not support the ability to assign static IPs, thus DHCP is required. * Access to internet hosts is optional, but the VM will not be able to apply any current updates and will need to be manually rebooted to get a clean cloud-init status. 2. The build VM must be accessible via SSH from the host running `make build-proxmox...` -3. The build VM must have DHCP, DNS, HTTP, HTTPS and NTP services available to successfully update the OS packages. +3. The build VM must have DHCP, DNS, HTTP, HTTPS and NTP services available on the network to successfully update the OS packages. ## Building Images From 592b12878e904b242d7be862d73cb37ad021fc80 Mon Sep 17 00:00:00 2001 From: Travis Milum Date: Mon, 8 Jul 2024 15:18:12 -0700 Subject: [PATCH 3/3] Clarification --- docs/book/src/capi/providers/proxmox.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/book/src/capi/providers/proxmox.md b/docs/book/src/capi/providers/proxmox.md index 55c340f89d..3a7cb6d20a 100644 --- a/docs/book/src/capi/providers/proxmox.md +++ b/docs/book/src/capi/providers/proxmox.md @@ -14,7 +14,7 @@ The image build process expects a few things to be in place before the build pro * The packer proxmox integration currently does not support the ability to assign static IPs, thus DHCP is required. * Access to internet hosts is optional, but the VM will not be able to apply any current updates and will need to be manually rebooted to get a clean cloud-init status. 2. The build VM must be accessible via SSH from the host running `make build-proxmox...` -3. The build VM must have DHCP, DNS, HTTP, HTTPS and NTP services available on the network to successfully update the OS packages. +3. The build VM must have DHCP, DNS, HTTP, HTTPS and NTP accessibility to successfully update the OS packages. ## Building Images