Skip to content

Commit

Permalink
Merge pull request #1506 from Tra5is/proxmox-docs
Browse files Browse the repository at this point in the history
Proxmox network requirements
  • Loading branch information
k8s-ci-robot committed Jul 9, 2024
2 parents 3d200a2 + 592b128 commit 1b99349
Showing 1 changed file with 11 additions and 0 deletions.
11 changes: 11 additions & 0 deletions docs/book/src/capi/providers/proxmox.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 accessibility to successfully update the OS packages.

## Building Images

The build [prerequisites](../capi.md#prerequisites) for using `image-builder` for
Expand Down Expand Up @@ -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:
Expand Down

0 comments on commit 1b99349

Please sign in to comment.