Proxmox/pve-docs
5
0
Fork 0
mirror of git://git.proxmox.com/git/pve-docs.git synced 2025-01-08 21:17:52 +03:00
Code Releases Activity

resource-pools: add section in docs

Browse Source 
Adds a second-level heading for resource pools and adds creation of pool
to example.

Signed-off-by: Dylan Whyte <d.whyte@proxmox.com>
This commit is contained in:
Dylan Whyte 2021-01-29 08:54:40 +01:00 committed by Thomas Lamprecht
parent c961e4cc49
commit 23b447be71
2 changed files with 26 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

BIN
images/screenshot/gui-datacenter-pool-window.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 8.4 KiB

40
pveum.adoc
View File

@ -100,6 +100,20 @@ To use an API token, set the HTTP header 'Authorization' to the displayed value
of the form `PVEAPIToken=USER@REALM!TOKENID=UUID` when making API requests, or
refer to your API client documentation.
[[pveum_resource_pools]]
Resource Pools
--------------
[thumbnail="screenshot/gui-datacenter-pool-window.png"]
A resource pool is a set of virtual machines, containers, and storage
devices. It is useful for permission handling in cases where certain users
should have controlled access to a specific set of resources, as it allows for a
single permission to be applied to a set of elements, rather than having to
manage this on a per resource basis. Resource pools are often used in tandem
with groups so that the members of a group have permissions on a set of machines
and storage.
[[pveum_authentication_realms]]
Authentication Realms
---------------------
@ -707,20 +721,13 @@ Verify the permissions of the user and token:
pveum user permissions joe@pve
pveum user token permissions joe@pve monitoring
Pools
~~~~~
Resource Pools
~~~~~~~~~~~~~~
An enterprise is usually structured into several smaller departments,
and it is common that you want to assign resources to them and
delegate management tasks. A pool is simply a set of virtual machines
and data stores. You can create pools on the GUI. After that you can
add resources to the pool (VMs, Storage).
You can also assign permissions to the pool. Those permissions are
inherited to all pool members.
Lets assume you have a software development department, so we first
create a group
An enterprise is usually structured into several smaller departments, and it is
common that you want to assign resources and delegate management tasks to each
of these. Let's assume that you want to set up a pool for a software development
department. First, create a group
[source,bash]
pveum groupadd developers -comment "Our software developers"
@ -732,7 +739,12 @@ Now we create a new user which is a member of that group
NOTE: The -password parameter will prompt you for a password
I assume we already created a pool called ``dev-pool'' on the GUI. So we can now assign permission to that pool:
Then we create a resource pool for our development department to use
[source,bash]
pveum pooladd dev-pool --comment "IT development pool"
Finally, we can assign permissions to that pool
[source,bash]
pveum aclmod /pool/dev-pool/ -group developers -role PVEAdmin