os-vm-expire

Manage VM expiration and deletion

These details have not been verified by PyPI

Project links

Homepage

Project description

Manage VM expiration and auto-deletion in an Openstack cloud.

This project is an unofficial Openstack project, but follows Openstack projects architecture, with a Horizon plugin and associated services.

Free software: Apache license
Documentation: http://os-vm-expire.readthedocs.io/
Bugs: https://github.com/genouest/os-vm-expire/issues
Horizon plugin: https://github.com/genouest/os-vm-expire-horizon-plugin
OSC plugin (openstack client): https://github.com/genouest/os-vm-expire-osc-plugin

The Openstack VmExpiration Management service adds an expiration to VMs. After expiration, VM is deleted. User can extend the VM lifetime via API or Horizon. Expiration extend is not limited, user can always extend a VM, but it will be extended only for a configured duration. User cannot extend it more than configured duration. Example:

date A: VM is created, VM will expire at A + N days

some days before expiration user is notified

user extend VM to today + M days (M is configuration based, user cannot specify it)

if user tries to extend VM again, it will be extend again to today + M days

Requirements

Nova notifications need to be enabled to get VM start and end messages.

Software has been tested on Pike and Otaca, and in single and multi domain configuration. It should work from Newton.

Features

On VM creation, add an expiration date
On near-expiration date, send an email to user
Horizon plugin to view VM expiration and extend expiration time
On expiration date, delete the VM and send an email to user
CLI commands to extend a VM or remove expiration from a VM (admin only)

Configuration

Configuration files are expected in directory /etc/os-vm-expire/ :

osvmexpire.conf
policy.json
osvmexpire-api-paste.ini (for wsgi server)

Main configuration file can be specified via environment variable OSVMEXPIRE_CONFIG.

Components

Start API server

For dev (port 8000)

export OSVMEXPIRE_PORT=9411 # optional
osvmexpire-wsgi-api

For prod

uwsgi --master --die-on-term --emperor /etc/os-vm-expire/vassals --logto /var/log/os-vm-expire/osvmexpire-api.log --stats localhost:9314

Start worker

Manage nova notifications on instance creation and deletion to create/delete expiration objects.

osvmexpire-worker --config-file /etc/os-vm-expire/osvmexpire.conf

Start cleaner

Checks expiration time of VMs and sends notifications before expiration to let use extend the VM if necessary. Once expiration is reached (and if user could be notified of expiration), deletes the VM.

osvmexpire-cleaner --config-file /etc/os-vm-expire/osvmexpire.conf

CLI usage

Those command-line tools need access to configuration file, so are dedicated to administer the tool, not for end user.

osvmexpire-manage vm list
osvmexpire-manage vm extend -h
osvmexpire-manage vm remove -h

Credits

Code is mostly inspired (code base coming from) the Barbican Openstack project, code was more or less updated to manage different objects. This project takes the same license and kept original file headers.

This project was developed by the GenOuest core facility, IRISA, France.

Project details

These details have not been verified by PyPI

Project links

Homepage

Release history Release notifications | RSS feed

0.9.12

Feb 18, 2019

0.9.11

Jan 29, 2019

0.9.10

Jul 6, 2018

0.9.9

May 11, 2018

0.9.8

Feb 12, 2018

This version

0.9.7

Jan 9, 2018

0.9.6

Dec 29, 2017

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

os-vm-expire-0.9.7.tar.gz (90.9 kB view details)

Uploaded Jan 9, 2018 Source

Built Distributions

os_vm_expire-0.9.7-py3-none-any.whl (83.5 kB view details)

Uploaded Jan 9, 2018 Python 3

os_vm_expire-0.9.7-py2-none-any.whl (83.5 kB view details)

Uploaded Jan 9, 2018 Python 2

File details

Details for the file os-vm-expire-0.9.7.tar.gz.

File metadata

Download URL: os-vm-expire-0.9.7.tar.gz
Upload date: Jan 9, 2018
Size: 90.9 kB
Tags: Source
Uploaded using Trusted Publishing? No

File hashes

Hashes for os-vm-expire-0.9.7.tar.gz
Algorithm	Hash digest
SHA256	`9bdd9d59329ffcab8b3433d6984164d09c84a2a1e9c2cc019c20b441e070f5f9`
MD5	`2da9ae250b3c6239745014d437325026`
BLAKE2b-256	`b2459c5426b98d7d6ed022287661106e875631f84f191f2a0c1009287ab746bd`

See more details on using hashes here.

File details

Details for the file os_vm_expire-0.9.7-py3-none-any.whl.

File metadata

Download URL: os_vm_expire-0.9.7-py3-none-any.whl
Upload date: Jan 9, 2018
Size: 83.5 kB
Tags: Python 3
Uploaded using Trusted Publishing? No

File hashes

Hashes for os_vm_expire-0.9.7-py3-none-any.whl
Algorithm	Hash digest
SHA256	`687abd921c6103d512a5ee26f491c79c8a43dc32567b29f798d1aa4ce2e03365`
MD5	`79527e6d1ef41ee598d74e4788e9a641`
BLAKE2b-256	`c3cc399e8319f35495170545ff50d8e4ed8808f01ac2805763222a63afbf5cf0`

See more details on using hashes here.

File details

Details for the file os_vm_expire-0.9.7-py2-none-any.whl.

File metadata

Download URL: os_vm_expire-0.9.7-py2-none-any.whl
Upload date: Jan 9, 2018
Size: 83.5 kB
Tags: Python 2
Uploaded using Trusted Publishing? No

File hashes

Hashes for os_vm_expire-0.9.7-py2-none-any.whl
Algorithm	Hash digest
SHA256	`313344aa8ecc0adde2291ad1295026c1d5a64c4f92c4dde940ad07d46d64a107`
MD5	`e25fb563ca1c6d5b4e8eb55d227ffba6`
BLAKE2b-256	`8c651112c43c8451d1f6f61cf8f381a694d2e25fd3f9f2bcea5271041fe1c1b0`