Skip to content

Commit

Permalink
README: update to mention Debian 12/bookworm.
Browse files Browse the repository at this point in the history
  • Loading branch information
Julian Foad committed Sep 30, 2024
1 parent 459001c commit efc624e
Showing 1 changed file with 7 additions and 5 deletions.
12 changes: 7 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ lae.proxmox
Installs and configures Proxmox Virtual Environment 6.x/7.x/8.x on Debian servers.

This role allows you to deploy and manage single-node PVE installations and PVE
clusters (3+ nodes) on Debian Buster (10) and Bullseye (11). You are able to
clusters (3+ nodes) on Debian Buster (10) and Bullseye (11) and Bookworm (12). You are able to
configure the following with the assistance of this role:

- PVE RBAC definitions (roles, groups, users, and access control lists)
Expand Down Expand Up @@ -379,10 +379,12 @@ serially during a maintenance period.) It will also enable the IPMI watchdog.

## Role Variables

*About default values: Some of the default values are selected at run time and so can differ from the example listed here.*

```
[variable]: [default] #[description/purpose]
pve_group: proxmox # host group that contains the Proxmox hosts to be clustered together
pve_repository_line: "deb http://download.proxmox.com/debian/pve bullseye pve-no-subscription" # apt-repository configuration - change to enterprise if needed (although TODO further configuration may be needed)
pve_repository_line: "deb http://download.proxmox.com/debian/pve bookworm pve-no-subscription" # apt-repository configuration - change to enterprise if needed (although TODO further configuration may be needed)
pve_remove_subscription_warning: true # patches the subscription warning messages in proxmox if you are using the community edition
pve_extra_packages: [] # Any extra packages you may want to install, e.g. ngrep
pve_run_system_upgrades: false # Let role perform system upgrades
Expand All @@ -409,7 +411,7 @@ pve_zfs_enabled: no # Specifies whether or not to install and configure ZFS pack
# pve_zfs_zed_email: "" # Should be set to an email to receive ZFS notifications
pve_zfs_create_volumes: [] # List of ZFS Volumes to create (to use as PVE Storages). See section on Storage Management.
pve_ceph_enabled: false # Specifies wheter or not to install and configure Ceph packages. See below for an example configuration.
pve_ceph_repository_line: "deb http://download.proxmox.com/debian/ceph-pacific bullseye main" # apt-repository configuration. Will be automatically set for 6.x and 7.x (Further information: https://pve.proxmox.com/wiki/Package_Repositories)
pve_ceph_repository_line: "deb http://download.proxmox.com/debian/ceph-pacific bookworm main" # apt-repository configuration. Will be automatically set for 6.x and 7.x (Further information: https://pve.proxmox.com/wiki/Package_Repositories)
pve_ceph_network: "{{ (ansible_default_ipv4.network +'/'+ ansible_default_ipv4.netmask) | ansible.utils.ipaddr('net') }}" # Ceph public network
# pve_ceph_cluster_network: "" # Optional, if the ceph cluster network is different from the public network (see https://pve.proxmox.com/pve-docs/chapter-pveceph.html#pve_ceph_install_wizard)
pve_ceph_nodes: "{{ pve_group }}" # Host group containing all Ceph nodes
Expand Down Expand Up @@ -905,8 +907,8 @@ It can be later removed by unsetting this role variable.
When developing new features or fixing something in this role, you can test out
your changes by using Vagrant (only libvirt is supported currently). The
playbook can be found in `tests/vagrant` (so be sure to modify group variables
as needed). Be sure to test any changes on both Debian 10 and 11 (update the
Vagrantfile locally to use `debian/buster64`) before submitting a PR.
as needed). Be sure to test any changes on all supported versions of Debian (update the
Vagrantfile locally to use `debian/bookworm64`, `debian/bullseye64`, or `debian/buster64`) before submitting a PR.

You can also specify an apt caching proxy (e.g. `apt-cacher-ng`, and it must
run on port 3142) with the `APT_CACHE_HOST` environment variable to speed up
Expand Down

0 comments on commit efc624e

Please sign in to comment.