Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cloudsigma/cgroupspy
Python library for managing cgroups
https://github.com/cloudsigma/cgroupspy
Last synced: 3 months ago
JSON representation
Python library for managing cgroups
- Host: GitHub
- URL: https://github.com/cloudsigma/cgroupspy
- Owner: cloudsigma
- License: bsd-3-clause
- Created: 2014-10-27T13:45:24.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2022-04-04T17:10:35.000Z (about 2 years ago)
- Last Synced: 2024-03-01T14:46:42.531Z (4 months ago)
- Language: Python
- Size: 63.5 KB
- Stars: 61
- Watchers: 12
- Forks: 25
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Lists
- my-awesome-stars - cloudsigma/cgroupspy - Python library for managing cgroups (Python)
README
[](https://travis-ci.org/cloudsigma/cgroupspy)
cgroupspy
=========
Python library for managing cgroups
The library provides a pythonic way to manage and represent cgroups. It provides interfaces that convert
python objects to cgroups compatible strings and vise versa.
Trees
-----
cgroupspy has a couple of ways to represent the cgroups filesystem
* As a tree - this is the most basic and generic way to represent them. You basically construct it from all
the directories in the cgroups root.
* A grouped tree - that has access to all cgroup partitions with the same name, on the same level. For example -
'machine' partition in memory, cpuset, cpus, etc cgroups. All these attributes are
accessed via machine.cpus, machine.cpuset, etc.
* A VMTree - a subclass of grouped tree with utilities for simple management of libvirt guests
Example usage
-------------
```python
#Import the trees module, which contains a tree representation of cgroups
>>> from cgroupspy import trees
# This is the most basic type of cgroup tree. It models the filesystem.
>>> t = trees.Tree()
# It has a root which is of type Node
>>> t.root
# And the root has children
>>> print(t.root.children)
[, , , , , , , , , , , , ]
# You can for example get the cpuset
>>> cset = t.get_node_by_path('/cpuset/')
>>> cset
# The controller used for this cgroup is a CpuSetController
>>> cset.controller
# Which can for example show you the cpu pinning
>>> cset.controller.cpus
set([0, 1])
# You can create a cgroup
>>> test = cset.create_cgroup('test')
# See its cpu restrictions
>>> test.controller.cpus
set([0, 1])
# And change them
>>> test.controller.cpus = [1]
# The tasks in this cgroup are now restricted to cpu 1
>>> test.controller.cpus
set([1])
```
Another example with the VMTree - for managing libvirt guests
```python
>>> from cgroupspy.trees import VMTree
>>> vmt = VMTree()
>>> print(vmt.vms)
{u'1ce10f47-fb4e-4b6a-8ee6-ba34940cdda7.libvirt-qemu': ,
u'3d5013b9-93ed-4ef1-b518-a2cea43f69ad.libvirt-qemu': ,
}
>>> vm = vmt.get_vm_node("1ce10f47-fb4e-4b6a-8ee6-ba34940cdda7")
>>> print(vm.cpu.shares)
1024
>>> print(vm.cpuset.cpus)
{0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15}
>>> print(vm.memory.limit_in_bytes)
25603080192
>>> print(vm.children)
[,
,
]
>>> print(vm.path)
/machine/grey/1ce10f47-fb4e-4b6a-8ee6-ba34940cdda7.libvirt-qemu
>>> vcpu1 = vm.children[0]
>>> print(vcpu1.cpuset.cpus)
{1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15}
>>> vcpu1.cpuset.cpus = {1,2,3}
>>> print(vcpu1.cpuset.cpus)
{1, 2, 3}
```
License
-------
new BSD licence