2012-02-04 17:40:31 -06:00
|
|
|
# Copyright 2012 United States Government as represented by the
|
2011-10-31 11:31:05 -07:00
|
|
|
# Administrator of the National Aeronautics and Space Administration.
|
|
|
|
# All Rights Reserved.
|
|
|
|
#
|
2012-02-04 17:40:31 -06:00
|
|
|
# Copyright 2012 Nebula, Inc.
|
2011-10-31 11:31:05 -07:00
|
|
|
#
|
|
|
|
# Licensed under the Apache License, Version 2.0 (the "License"); you may
|
|
|
|
# not use this file except in compliance with the License. You may obtain
|
|
|
|
# a copy of the License at
|
|
|
|
#
|
|
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
#
|
|
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
|
|
# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
|
|
# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
|
|
|
# License for the specific language governing permissions and limitations
|
|
|
|
# under the License.
|
|
|
|
|
|
|
|
from __future__ import absolute_import
|
|
|
|
|
2014-09-11 19:10:41 +02:00
|
|
|
import collections
|
2013-02-19 18:38:45 +11:00
|
|
|
import itertools
|
2014-09-11 19:10:41 +02:00
|
|
|
import json
|
2011-10-31 11:31:05 -07:00
|
|
|
import logging
|
2014-12-08 15:13:51 +02:00
|
|
|
import os
|
2011-10-31 11:31:05 -07:00
|
|
|
|
2014-09-11 19:10:41 +02:00
|
|
|
|
2014-01-03 17:31:49 +01:00
|
|
|
from django.conf import settings
|
2015-05-22 10:54:42 +08:00
|
|
|
from django.core.files.uploadedfile import InMemoryUploadedFile
|
|
|
|
from django.core.files.uploadedfile import SimpleUploadedFile
|
|
|
|
from django.core.files.uploadedfile import TemporaryUploadedFile
|
|
|
|
|
2014-12-08 15:13:51 +02:00
|
|
|
|
2012-07-31 13:28:48 -07:00
|
|
|
import glanceclient as glance_client
|
2014-07-29 16:57:39 +02:00
|
|
|
from six.moves import _thread as thread
|
2012-03-11 18:37:18 -07:00
|
|
|
|
2013-11-14 15:01:24 -07:00
|
|
|
from horizon.utils import functions as utils
|
2014-08-04 15:07:04 +09:00
|
|
|
from horizon.utils.memoized import memoized # noqa
|
2013-08-02 13:23:46 +04:00
|
|
|
from openstack_dashboard.api import base
|
2011-10-31 11:31:05 -07:00
|
|
|
|
|
|
|
|
|
|
|
LOG = logging.getLogger(__name__)
|
Base Glance Metadata Definitions Admin UI
Provide a base admin UI for viewing, importing, and associating the
metadata definitions that can be used with various resource types
such as flavors, images, and host aggregates.
In Juno, Glance provided a metadata definitions catalog[1][2] where
users can register the available metadata definitions that can be used
on different types of resources (images, artifacts, volumes, flavors,
aggregates, etc). This includes key / value pairs such as
properties, extra specs, etc. Horizon landed several patches that
read these properties. You can view the functionality in the
"update metadata" action on Flavors, Images, and Host Aggregates.
This specific patch is to bring in the Admin UI for the basic coarse
grained actions on the definitions in the catalog. This includes creating
(importing) a namespace, viewing the overview details about
it, deleting the namespace, and associating the namespace for use with
specific resource types.
Future blueprints will be registered for:
- CRUD on individual metadata definitions within the namespace
For example, editing the default value of an individual property.
[1] Approved Glance Juno Spec:
https://github.com/openstack/glance-specs/blob/master/specs/juno/metadata-schema-catalog.rst
[2] Glance PTL Juno Feature Overview:
https://www.youtube.com/watch?v=3ptriiw1wK8&t=14m27s
Co-Authored-By: Travis Tripp <travis.tripp@hp.com>
Co-Authored-By: Santiago Baldassin<santiago.b.baldassin@intel.com>
Co-Authored-By: Bartosz Fic <bartosz.fic@intel.com>
Co-Authored-By: Pawel Koniszewski <pawel.koniszewski@intel.com>
Co-Authored-By: Michal Dulko <michal.dulko@intel.com>
DocImpact: Concept awareness
Change-Id: Ie34007f73af7e0941631a52f03841068e509a72c
Implements: blueprint glance-metadata-definitions-base-admin-ui
2014-09-12 13:54:01 +02:00
|
|
|
VERSIONS = base.APIVersionManager("image", preferred_version=2)
|
2011-10-31 11:31:05 -07:00
|
|
|
|
2015-11-17 10:19:59 -06:00
|
|
|
try:
|
|
|
|
from glanceclient.v2 import client as glance_client_v2
|
|
|
|
VERSIONS.load_supported_version(2, {"client": glance_client_v2,
|
|
|
|
"version": 2})
|
|
|
|
except ImportError:
|
|
|
|
pass
|
|
|
|
|
|
|
|
try:
|
|
|
|
from glanceclient.v1 import client as glance_client_v1
|
|
|
|
VERSIONS.load_supported_version(1, {"client": glance_client_v1,
|
|
|
|
"version": 1})
|
|
|
|
except ImportError:
|
|
|
|
pass
|
|
|
|
|
2011-10-31 11:31:05 -07:00
|
|
|
|
2014-08-04 15:07:04 +09:00
|
|
|
@memoized
|
2014-01-29 08:30:19 -06:00
|
|
|
def glanceclient(request, version='1'):
|
2014-03-14 08:20:19 -06:00
|
|
|
url = base.url_for(request, 'image')
|
2012-07-17 12:35:49 +02:00
|
|
|
insecure = getattr(settings, 'OPENSTACK_SSL_NO_VERIFY', False)
|
2013-08-28 13:21:19 +02:00
|
|
|
cacert = getattr(settings, 'OPENSTACK_SSL_CACERT', None)
|
2014-01-29 08:30:19 -06:00
|
|
|
return glance_client.Client(version, url, token=request.user.token.id,
|
2013-08-28 13:21:19 +02:00
|
|
|
insecure=insecure, cacert=cacert)
|
2011-10-31 11:31:05 -07:00
|
|
|
|
|
|
|
|
|
|
|
def image_delete(request, image_id):
|
2012-04-12 17:13:56 -07:00
|
|
|
return glanceclient(request).images.delete(image_id)
|
2011-10-31 11:31:05 -07:00
|
|
|
|
|
|
|
|
|
|
|
def image_get(request, image_id):
|
2013-11-01 14:02:41 -04:00
|
|
|
"""Returns an Image object populated with metadata for image
|
Fixes LP Bug#862664 - Improper calls to get_image
The glance.client.Client.get_image() call returns a
tuple of (metadata, image_iterator). Unfortunately,
Horizon's glance API calls get_image() when it means
to call get_image_meta(). Because the call to get_image()
simply ignores the image iterator returned from get_image(),
when the image iterator is garbage-collected, this causes
the connection to Glance to be closed, however by that time
the socket bound to the iterator has been switched out by
eventlet. The result is lots of these in the Glance API log:
2011-09-28 17:46:12 DEBUG [glance.store.filesystem] Found image at /opt/stack/glance/images/3. Returning in ChunkedFile.
2011-09-28 17:46:12 DEBUG [eventlet.wsgi.server] Traceback (most recent call last):
File "/usr/lib/pymodules/python2.7/eventlet/wsgi.py", line 351, in handle_one_response
write(''.join(towrite))
File "/usr/lib/pymodules/python2.7/eventlet/wsgi.py", line 301, in write
_writelines(towrite)
File "/usr/lib/python2.7/socket.py", line 334, in writelines
self.flush()
File "/usr/lib/python2.7/socket.py", line 303, in flush
self._sock.sendall(view[write_offset:write_offset+buffer_size])
File "/usr/lib/pymodules/python2.7/eventlet/greenio.py", line 283, in sendall
tail = self.send(data, flags)
File "/usr/lib/pymodules/python2.7/eventlet/greenio.py", line 269, in send
total_sent += fd.send(data[total_sent:], flags)
error: [Errno 104] Connection reset by peer
This patch fixes the improper calls to get_image() by replacing them
with appropriate calls to get_image_meta().
Change-Id: I741a207ba0e222820492aeb48bab9464d17539ab
2011-12-06 12:27:19 -05:00
|
|
|
with supplied identifier.
|
|
|
|
"""
|
2013-12-16 13:05:37 -05:00
|
|
|
image = glanceclient(request).images.get(image_id)
|
|
|
|
if not hasattr(image, 'name'):
|
|
|
|
image.name = None
|
|
|
|
return image
|
2011-10-31 11:31:05 -07:00
|
|
|
|
|
|
|
|
2014-10-24 20:14:46 +04:00
|
|
|
def is_image_public(im):
|
|
|
|
is_public_v1 = getattr(im, 'is_public', None)
|
|
|
|
if is_public_v1 is not None:
|
|
|
|
return is_public_v1
|
|
|
|
else:
|
|
|
|
return im.visibility == 'public'
|
|
|
|
|
|
|
|
|
2014-04-28 16:42:43 -07:00
|
|
|
def image_list_detailed(request, marker=None, sort_dir='desc',
|
2014-10-24 20:14:46 +04:00
|
|
|
sort_key='created_at', filters=None, paginate=False,
|
|
|
|
reversed_order=False):
|
|
|
|
"""Thin layer above glanceclient, for handling pagination issues.
|
|
|
|
|
|
|
|
It provides iterating both forward and backward on top of ascetic
|
|
|
|
OpenStack pagination API - which natively supports only iterating forward
|
|
|
|
through the entries. Thus in order to retrieve list of objects at previous
|
|
|
|
page, a request with the reverse entries order had to be made to Glance,
|
|
|
|
using the first object id on current page as the marker - restoring
|
|
|
|
the original items ordering before sending them back to the UI.
|
|
|
|
|
|
|
|
.. param:: request
|
|
|
|
|
|
|
|
The request object coming from browser to be passed further into
|
|
|
|
Glance service.
|
|
|
|
|
|
|
|
.. param:: marker
|
|
|
|
|
|
|
|
The id of an object which defines a starting point of a query sent to
|
|
|
|
Glance service.
|
|
|
|
|
|
|
|
.. param:: sort_dir
|
|
|
|
|
|
|
|
The direction by which the resulting image list throughout all pages
|
|
|
|
(if pagination is enabled) will be sorted. Could be either 'asc'
|
|
|
|
(ascending) or 'desc' (descending), defaults to 'desc'.
|
|
|
|
|
|
|
|
.. param:: sort_key
|
|
|
|
|
|
|
|
The name of key by by which the resulting image list throughout all
|
|
|
|
pages (if pagination is enabled) will be sorted. Defaults to
|
|
|
|
'created_at'.
|
|
|
|
|
|
|
|
.. param:: filters
|
|
|
|
|
|
|
|
A dictionary of filters passed as is to Glance service.
|
|
|
|
|
|
|
|
.. param:: paginate
|
|
|
|
|
|
|
|
Whether the pagination is enabled. If it is, then the number of
|
|
|
|
entries on a single page of images table is limited to the specific
|
|
|
|
number stored in browser cookies.
|
|
|
|
|
|
|
|
.. param:: reversed_order
|
|
|
|
|
|
|
|
Set this flag to True when it's necessary to get a reversed list of
|
|
|
|
images from Glance (used for navigating the images list back in UI).
|
|
|
|
"""
|
2012-05-22 20:00:43 -07:00
|
|
|
limit = getattr(settings, 'API_RESULT_LIMIT', 1000)
|
2013-11-14 15:01:24 -07:00
|
|
|
page_size = utils.get_page_size(request)
|
2013-02-19 18:38:45 +11:00
|
|
|
|
|
|
|
if paginate:
|
|
|
|
request_size = page_size + 1
|
|
|
|
else:
|
|
|
|
request_size = limit
|
|
|
|
|
2012-07-23 13:24:55 +03:00
|
|
|
kwargs = {'filters': filters or {}}
|
|
|
|
if marker:
|
|
|
|
kwargs['marker'] = marker
|
2014-04-28 16:42:43 -07:00
|
|
|
kwargs['sort_key'] = sort_key
|
2013-02-19 18:38:45 +11:00
|
|
|
|
2014-10-24 20:14:46 +04:00
|
|
|
if not reversed_order:
|
|
|
|
kwargs['sort_dir'] = sort_dir
|
|
|
|
else:
|
|
|
|
kwargs['sort_dir'] = 'desc' if sort_dir == 'asc' else 'asc'
|
|
|
|
|
2013-02-19 18:38:45 +11:00
|
|
|
images_iter = glanceclient(request).images.list(page_size=request_size,
|
2012-07-23 13:24:55 +03:00
|
|
|
limit=limit,
|
2013-02-19 18:38:45 +11:00
|
|
|
**kwargs)
|
2014-04-28 16:42:43 -07:00
|
|
|
has_prev_data = False
|
2013-02-19 18:38:45 +11:00
|
|
|
has_more_data = False
|
|
|
|
if paginate:
|
|
|
|
images = list(itertools.islice(images_iter, request_size))
|
2014-04-28 16:42:43 -07:00
|
|
|
# first and middle page condition
|
2013-02-19 18:38:45 +11:00
|
|
|
if len(images) > page_size:
|
|
|
|
images.pop(-1)
|
|
|
|
has_more_data = True
|
2014-04-28 16:42:43 -07:00
|
|
|
# middle page condition
|
|
|
|
if marker is not None:
|
|
|
|
has_prev_data = True
|
|
|
|
# first page condition when reached via prev back
|
2014-10-24 20:14:46 +04:00
|
|
|
elif reversed_order and marker is not None:
|
2014-04-28 16:42:43 -07:00
|
|
|
has_more_data = True
|
|
|
|
# last page condition
|
|
|
|
elif marker is not None:
|
|
|
|
has_prev_data = True
|
2014-10-24 20:14:46 +04:00
|
|
|
|
|
|
|
# restore the original ordering here
|
|
|
|
if reversed_order:
|
|
|
|
images = sorted(images, key=lambda image:
|
|
|
|
(getattr(image, sort_key) or '').lower(),
|
|
|
|
reverse=(sort_dir == 'desc'))
|
2012-05-22 20:00:43 -07:00
|
|
|
else:
|
2013-02-19 18:38:45 +11:00
|
|
|
images = list(images_iter)
|
2014-10-24 20:14:46 +04:00
|
|
|
|
|
|
|
return images, has_more_data, has_prev_data
|
2011-10-31 11:31:05 -07:00
|
|
|
|
|
|
|
|
2012-04-12 17:13:56 -07:00
|
|
|
def image_update(request, image_id, **kwargs):
|
2014-12-08 15:13:51 +02:00
|
|
|
image_data = kwargs.get('data', None)
|
|
|
|
try:
|
2015-06-14 14:02:27 +03:00
|
|
|
return glanceclient(request).images.update(image_id, **kwargs)
|
2014-12-08 15:13:51 +02:00
|
|
|
finally:
|
|
|
|
if image_data:
|
|
|
|
try:
|
|
|
|
os.remove(image_data.file.name)
|
|
|
|
except Exception as e:
|
2015-05-22 10:54:42 +08:00
|
|
|
filename = str(image_data.file)
|
|
|
|
if hasattr(image_data.file, 'name'):
|
|
|
|
filename = image_data.file.name
|
2014-12-08 15:13:51 +02:00
|
|
|
msg = (('Failed to remove temporary image file '
|
|
|
|
'%(file)s (%(e)s)') %
|
2015-05-22 10:54:42 +08:00
|
|
|
dict(file=filename, e=str(e)))
|
2015-12-29 12:39:36 +08:00
|
|
|
LOG.warning(msg)
|
2011-10-31 11:31:05 -07:00
|
|
|
|
|
|
|
|
2012-06-04 20:54:19 -07:00
|
|
|
def image_create(request, **kwargs):
|
2015-04-02 10:37:28 +02:00
|
|
|
"""Create image.
|
|
|
|
|
2015-08-18 17:13:29 -06:00
|
|
|
:param kwargs:
|
|
|
|
* copy_from: URL from which Glance server should immediately copy
|
|
|
|
the data and store it in its configured image store.
|
|
|
|
* data: Form data posted from client.
|
|
|
|
* location: URL where the data for this image already resides.
|
2015-04-02 10:37:28 +02:00
|
|
|
|
2015-08-18 17:13:29 -06:00
|
|
|
In the case of 'copy_from' and 'location', the Glance server
|
2015-04-02 10:37:28 +02:00
|
|
|
will give us a immediate response from create and handle the data
|
|
|
|
asynchronously.
|
|
|
|
|
|
|
|
In the case of 'data' the process of uploading the data may take
|
2015-12-23 17:07:38 +08:00
|
|
|
some time and is handed off to a separate thread.
|
2015-04-02 10:37:28 +02:00
|
|
|
"""
|
2014-05-22 18:27:42 -07:00
|
|
|
data = kwargs.pop('data', None)
|
2012-06-04 20:54:19 -07:00
|
|
|
|
|
|
|
image = glanceclient(request).images.create(**kwargs)
|
|
|
|
|
2014-05-22 18:27:42 -07:00
|
|
|
if data:
|
2015-05-22 10:54:42 +08:00
|
|
|
if isinstance(data, TemporaryUploadedFile):
|
|
|
|
# Hack to fool Django, so we can keep file open in the new thread.
|
|
|
|
data.file.close_called = True
|
|
|
|
if isinstance(data, InMemoryUploadedFile):
|
|
|
|
# Clone a new file for InMemeoryUploadedFile.
|
|
|
|
# Because the old one will be closed by Django.
|
|
|
|
data = SimpleUploadedFile(data.name,
|
|
|
|
data.read(),
|
|
|
|
data.content_type)
|
2014-05-22 18:27:42 -07:00
|
|
|
thread.start_new_thread(image_update,
|
|
|
|
(request, image.id),
|
|
|
|
{'data': data,
|
|
|
|
'purge_props': False})
|
2012-06-04 20:54:19 -07:00
|
|
|
|
|
|
|
return image
|
2014-01-29 08:30:19 -06:00
|
|
|
|
|
|
|
|
2014-09-11 19:10:41 +02:00
|
|
|
def image_update_properties(request, image_id, remove_props=None, **kwargs):
|
2014-01-29 08:30:19 -06:00
|
|
|
"""Add or update a custom property of an image."""
|
2014-09-11 19:10:41 +02:00
|
|
|
return glanceclient(request, '2').images.update(image_id,
|
|
|
|
remove_props,
|
|
|
|
**kwargs)
|
2014-01-29 08:30:19 -06:00
|
|
|
|
|
|
|
|
|
|
|
def image_delete_properties(request, image_id, keys):
|
|
|
|
"""Delete custom properties for an image."""
|
|
|
|
return glanceclient(request, '2').images.update(image_id, keys)
|
2014-09-11 19:10:41 +02:00
|
|
|
|
|
|
|
|
|
|
|
class BaseGlanceMetadefAPIResourceWrapper(base.APIResourceWrapper):
|
|
|
|
|
|
|
|
@property
|
|
|
|
def description(self):
|
|
|
|
return (getattr(self._apiresource, 'description', None) or
|
|
|
|
getattr(self._apiresource, 'display_name', None))
|
|
|
|
|
|
|
|
def as_json(self, indent=4):
|
|
|
|
result = collections.OrderedDict()
|
|
|
|
for attr in self._attrs:
|
|
|
|
if hasattr(self, attr):
|
|
|
|
result[attr] = getattr(self, attr)
|
|
|
|
return json.dumps(result, indent=indent)
|
|
|
|
|
2015-01-29 13:28:48 -07:00
|
|
|
def to_dict(self):
|
|
|
|
return self._apiresource
|
|
|
|
|
2014-09-11 19:10:41 +02:00
|
|
|
|
|
|
|
class Namespace(BaseGlanceMetadefAPIResourceWrapper):
|
|
|
|
|
|
|
|
_attrs = ['namespace', 'display_name', 'description',
|
|
|
|
'resource_type_associations', 'visibility', 'protected',
|
|
|
|
'created_at', 'updated_at', 'properties', 'objects']
|
|
|
|
|
|
|
|
@property
|
Base Glance Metadata Definitions Admin UI
Provide a base admin UI for viewing, importing, and associating the
metadata definitions that can be used with various resource types
such as flavors, images, and host aggregates.
In Juno, Glance provided a metadata definitions catalog[1][2] where
users can register the available metadata definitions that can be used
on different types of resources (images, artifacts, volumes, flavors,
aggregates, etc). This includes key / value pairs such as
properties, extra specs, etc. Horizon landed several patches that
read these properties. You can view the functionality in the
"update metadata" action on Flavors, Images, and Host Aggregates.
This specific patch is to bring in the Admin UI for the basic coarse
grained actions on the definitions in the catalog. This includes creating
(importing) a namespace, viewing the overview details about
it, deleting the namespace, and associating the namespace for use with
specific resource types.
Future blueprints will be registered for:
- CRUD on individual metadata definitions within the namespace
For example, editing the default value of an individual property.
[1] Approved Glance Juno Spec:
https://github.com/openstack/glance-specs/blob/master/specs/juno/metadata-schema-catalog.rst
[2] Glance PTL Juno Feature Overview:
https://www.youtube.com/watch?v=3ptriiw1wK8&t=14m27s
Co-Authored-By: Travis Tripp <travis.tripp@hp.com>
Co-Authored-By: Santiago Baldassin<santiago.b.baldassin@intel.com>
Co-Authored-By: Bartosz Fic <bartosz.fic@intel.com>
Co-Authored-By: Pawel Koniszewski <pawel.koniszewski@intel.com>
Co-Authored-By: Michal Dulko <michal.dulko@intel.com>
DocImpact: Concept awareness
Change-Id: Ie34007f73af7e0941631a52f03841068e509a72c
Implements: blueprint glance-metadata-definitions-base-admin-ui
2014-09-12 13:54:01 +02:00
|
|
|
def resource_type_names(self):
|
2014-09-11 19:10:41 +02:00
|
|
|
result = [resource_type['name'] for resource_type in
|
2014-09-30 22:41:11 +09:00
|
|
|
getattr(self._apiresource, 'resource_type_associations')]
|
Base Glance Metadata Definitions Admin UI
Provide a base admin UI for viewing, importing, and associating the
metadata definitions that can be used with various resource types
such as flavors, images, and host aggregates.
In Juno, Glance provided a metadata definitions catalog[1][2] where
users can register the available metadata definitions that can be used
on different types of resources (images, artifacts, volumes, flavors,
aggregates, etc). This includes key / value pairs such as
properties, extra specs, etc. Horizon landed several patches that
read these properties. You can view the functionality in the
"update metadata" action on Flavors, Images, and Host Aggregates.
This specific patch is to bring in the Admin UI for the basic coarse
grained actions on the definitions in the catalog. This includes creating
(importing) a namespace, viewing the overview details about
it, deleting the namespace, and associating the namespace for use with
specific resource types.
Future blueprints will be registered for:
- CRUD on individual metadata definitions within the namespace
For example, editing the default value of an individual property.
[1] Approved Glance Juno Spec:
https://github.com/openstack/glance-specs/blob/master/specs/juno/metadata-schema-catalog.rst
[2] Glance PTL Juno Feature Overview:
https://www.youtube.com/watch?v=3ptriiw1wK8&t=14m27s
Co-Authored-By: Travis Tripp <travis.tripp@hp.com>
Co-Authored-By: Santiago Baldassin<santiago.b.baldassin@intel.com>
Co-Authored-By: Bartosz Fic <bartosz.fic@intel.com>
Co-Authored-By: Pawel Koniszewski <pawel.koniszewski@intel.com>
Co-Authored-By: Michal Dulko <michal.dulko@intel.com>
DocImpact: Concept awareness
Change-Id: Ie34007f73af7e0941631a52f03841068e509a72c
Implements: blueprint glance-metadata-definitions-base-admin-ui
2014-09-12 13:54:01 +02:00
|
|
|
|
|
|
|
return sorted(result)
|
2014-09-11 19:10:41 +02:00
|
|
|
|
|
|
|
@property
|
|
|
|
def public(self):
|
|
|
|
if getattr(self._apiresource, 'visibility') == 'public':
|
|
|
|
return True
|
|
|
|
else:
|
|
|
|
return False
|
|
|
|
|
|
|
|
|
2016-01-25 16:20:07 -06:00
|
|
|
def filter_properties_target(namespaces_iter,
|
|
|
|
resource_types,
|
|
|
|
properties_target):
|
|
|
|
"""Filter metadata namespaces based on the given resource types and
|
|
|
|
properties target.
|
|
|
|
|
|
|
|
:param namespaces_iter: Metadata namespaces iterable.
|
|
|
|
:param resource_types: List of resource type names.
|
|
|
|
:param properties_target: Name of the properties target.
|
|
|
|
"""
|
|
|
|
def filter_namespace(namespace):
|
|
|
|
for asn in namespace.get('resource_type_associations'):
|
|
|
|
if (asn.get('name') in resource_types and
|
|
|
|
asn.get('properties_target') == properties_target):
|
|
|
|
return True
|
|
|
|
return False
|
|
|
|
return filter(filter_namespace, namespaces_iter)
|
|
|
|
|
|
|
|
|
2015-04-01 19:33:22 +02:00
|
|
|
@memoized
|
2014-09-11 19:10:41 +02:00
|
|
|
def metadefs_namespace_get(request, namespace, resource_type=None, wrap=False):
|
|
|
|
namespace = glanceclient(request, '2').\
|
|
|
|
metadefs_namespace.get(namespace, resource_type=resource_type)
|
|
|
|
# There were problems with using the wrapper class in
|
2015-03-18 11:37:49 -07:00
|
|
|
# nested json serialization. So sometimes, it is not desirable
|
2014-09-11 19:10:41 +02:00
|
|
|
# to wrap.
|
|
|
|
if wrap:
|
|
|
|
return Namespace(namespace)
|
|
|
|
else:
|
|
|
|
return namespace
|
|
|
|
|
|
|
|
|
|
|
|
def metadefs_namespace_list(request,
|
2015-09-21 13:22:59 +03:00
|
|
|
filters=None,
|
Base Glance Metadata Definitions Admin UI
Provide a base admin UI for viewing, importing, and associating the
metadata definitions that can be used with various resource types
such as flavors, images, and host aggregates.
In Juno, Glance provided a metadata definitions catalog[1][2] where
users can register the available metadata definitions that can be used
on different types of resources (images, artifacts, volumes, flavors,
aggregates, etc). This includes key / value pairs such as
properties, extra specs, etc. Horizon landed several patches that
read these properties. You can view the functionality in the
"update metadata" action on Flavors, Images, and Host Aggregates.
This specific patch is to bring in the Admin UI for the basic coarse
grained actions on the definitions in the catalog. This includes creating
(importing) a namespace, viewing the overview details about
it, deleting the namespace, and associating the namespace for use with
specific resource types.
Future blueprints will be registered for:
- CRUD on individual metadata definitions within the namespace
For example, editing the default value of an individual property.
[1] Approved Glance Juno Spec:
https://github.com/openstack/glance-specs/blob/master/specs/juno/metadata-schema-catalog.rst
[2] Glance PTL Juno Feature Overview:
https://www.youtube.com/watch?v=3ptriiw1wK8&t=14m27s
Co-Authored-By: Travis Tripp <travis.tripp@hp.com>
Co-Authored-By: Santiago Baldassin<santiago.b.baldassin@intel.com>
Co-Authored-By: Bartosz Fic <bartosz.fic@intel.com>
Co-Authored-By: Pawel Koniszewski <pawel.koniszewski@intel.com>
Co-Authored-By: Michal Dulko <michal.dulko@intel.com>
DocImpact: Concept awareness
Change-Id: Ie34007f73af7e0941631a52f03841068e509a72c
Implements: blueprint glance-metadata-definitions-base-admin-ui
2014-09-12 13:54:01 +02:00
|
|
|
sort_dir='asc',
|
|
|
|
sort_key='namespace',
|
2014-09-11 19:10:41 +02:00
|
|
|
marker=None,
|
|
|
|
paginate=False):
|
Base Glance Metadata Definitions Admin UI
Provide a base admin UI for viewing, importing, and associating the
metadata definitions that can be used with various resource types
such as flavors, images, and host aggregates.
In Juno, Glance provided a metadata definitions catalog[1][2] where
users can register the available metadata definitions that can be used
on different types of resources (images, artifacts, volumes, flavors,
aggregates, etc). This includes key / value pairs such as
properties, extra specs, etc. Horizon landed several patches that
read these properties. You can view the functionality in the
"update metadata" action on Flavors, Images, and Host Aggregates.
This specific patch is to bring in the Admin UI for the basic coarse
grained actions on the definitions in the catalog. This includes creating
(importing) a namespace, viewing the overview details about
it, deleting the namespace, and associating the namespace for use with
specific resource types.
Future blueprints will be registered for:
- CRUD on individual metadata definitions within the namespace
For example, editing the default value of an individual property.
[1] Approved Glance Juno Spec:
https://github.com/openstack/glance-specs/blob/master/specs/juno/metadata-schema-catalog.rst
[2] Glance PTL Juno Feature Overview:
https://www.youtube.com/watch?v=3ptriiw1wK8&t=14m27s
Co-Authored-By: Travis Tripp <travis.tripp@hp.com>
Co-Authored-By: Santiago Baldassin<santiago.b.baldassin@intel.com>
Co-Authored-By: Bartosz Fic <bartosz.fic@intel.com>
Co-Authored-By: Pawel Koniszewski <pawel.koniszewski@intel.com>
Co-Authored-By: Michal Dulko <michal.dulko@intel.com>
DocImpact: Concept awareness
Change-Id: Ie34007f73af7e0941631a52f03841068e509a72c
Implements: blueprint glance-metadata-definitions-base-admin-ui
2014-09-12 13:54:01 +02:00
|
|
|
"""Retrieve a listing of Namespaces
|
2015-08-18 17:13:29 -06:00
|
|
|
|
Base Glance Metadata Definitions Admin UI
Provide a base admin UI for viewing, importing, and associating the
metadata definitions that can be used with various resource types
such as flavors, images, and host aggregates.
In Juno, Glance provided a metadata definitions catalog[1][2] where
users can register the available metadata definitions that can be used
on different types of resources (images, artifacts, volumes, flavors,
aggregates, etc). This includes key / value pairs such as
properties, extra specs, etc. Horizon landed several patches that
read these properties. You can view the functionality in the
"update metadata" action on Flavors, Images, and Host Aggregates.
This specific patch is to bring in the Admin UI for the basic coarse
grained actions on the definitions in the catalog. This includes creating
(importing) a namespace, viewing the overview details about
it, deleting the namespace, and associating the namespace for use with
specific resource types.
Future blueprints will be registered for:
- CRUD on individual metadata definitions within the namespace
For example, editing the default value of an individual property.
[1] Approved Glance Juno Spec:
https://github.com/openstack/glance-specs/blob/master/specs/juno/metadata-schema-catalog.rst
[2] Glance PTL Juno Feature Overview:
https://www.youtube.com/watch?v=3ptriiw1wK8&t=14m27s
Co-Authored-By: Travis Tripp <travis.tripp@hp.com>
Co-Authored-By: Santiago Baldassin<santiago.b.baldassin@intel.com>
Co-Authored-By: Bartosz Fic <bartosz.fic@intel.com>
Co-Authored-By: Pawel Koniszewski <pawel.koniszewski@intel.com>
Co-Authored-By: Michal Dulko <michal.dulko@intel.com>
DocImpact: Concept awareness
Change-Id: Ie34007f73af7e0941631a52f03841068e509a72c
Implements: blueprint glance-metadata-definitions-base-admin-ui
2014-09-12 13:54:01 +02:00
|
|
|
:param paginate: If true will perform pagination based on settings.
|
|
|
|
:param marker: Specifies the namespace of the last-seen namespace.
|
|
|
|
The typical pattern of limit and marker is to make an
|
|
|
|
initial limited request and then to use the last
|
|
|
|
namespace from the response as the marker parameter
|
|
|
|
in a subsequent limited request. With paginate, limit
|
|
|
|
is automatically set.
|
|
|
|
:param sort_dir: The sort direction ('asc' or 'desc').
|
|
|
|
:param sort_key: The field to sort on (for example, 'created_at'). Default
|
|
|
|
is namespace. The way base namespaces are loaded into glance
|
|
|
|
typically at first deployment is done in a single transaction
|
|
|
|
giving them a potentially unpredictable sort result when using
|
|
|
|
create_at.
|
2015-01-29 13:28:48 -07:00
|
|
|
:param filters: specifies addition fields to filter on such as
|
|
|
|
resource_types.
|
Base Glance Metadata Definitions Admin UI
Provide a base admin UI for viewing, importing, and associating the
metadata definitions that can be used with various resource types
such as flavors, images, and host aggregates.
In Juno, Glance provided a metadata definitions catalog[1][2] where
users can register the available metadata definitions that can be used
on different types of resources (images, artifacts, volumes, flavors,
aggregates, etc). This includes key / value pairs such as
properties, extra specs, etc. Horizon landed several patches that
read these properties. You can view the functionality in the
"update metadata" action on Flavors, Images, and Host Aggregates.
This specific patch is to bring in the Admin UI for the basic coarse
grained actions on the definitions in the catalog. This includes creating
(importing) a namespace, viewing the overview details about
it, deleting the namespace, and associating the namespace for use with
specific resource types.
Future blueprints will be registered for:
- CRUD on individual metadata definitions within the namespace
For example, editing the default value of an individual property.
[1] Approved Glance Juno Spec:
https://github.com/openstack/glance-specs/blob/master/specs/juno/metadata-schema-catalog.rst
[2] Glance PTL Juno Feature Overview:
https://www.youtube.com/watch?v=3ptriiw1wK8&t=14m27s
Co-Authored-By: Travis Tripp <travis.tripp@hp.com>
Co-Authored-By: Santiago Baldassin<santiago.b.baldassin@intel.com>
Co-Authored-By: Bartosz Fic <bartosz.fic@intel.com>
Co-Authored-By: Pawel Koniszewski <pawel.koniszewski@intel.com>
Co-Authored-By: Michal Dulko <michal.dulko@intel.com>
DocImpact: Concept awareness
Change-Id: Ie34007f73af7e0941631a52f03841068e509a72c
Implements: blueprint glance-metadata-definitions-base-admin-ui
2014-09-12 13:54:01 +02:00
|
|
|
:returns A tuple of three values:
|
2015-08-18 17:13:29 -06:00
|
|
|
1) Current page results
|
|
|
|
2) A boolean of whether or not there are previous page(s).
|
|
|
|
3) A boolean of whether or not there are more page(s).
|
|
|
|
|
Base Glance Metadata Definitions Admin UI
Provide a base admin UI for viewing, importing, and associating the
metadata definitions that can be used with various resource types
such as flavors, images, and host aggregates.
In Juno, Glance provided a metadata definitions catalog[1][2] where
users can register the available metadata definitions that can be used
on different types of resources (images, artifacts, volumes, flavors,
aggregates, etc). This includes key / value pairs such as
properties, extra specs, etc. Horizon landed several patches that
read these properties. You can view the functionality in the
"update metadata" action on Flavors, Images, and Host Aggregates.
This specific patch is to bring in the Admin UI for the basic coarse
grained actions on the definitions in the catalog. This includes creating
(importing) a namespace, viewing the overview details about
it, deleting the namespace, and associating the namespace for use with
specific resource types.
Future blueprints will be registered for:
- CRUD on individual metadata definitions within the namespace
For example, editing the default value of an individual property.
[1] Approved Glance Juno Spec:
https://github.com/openstack/glance-specs/blob/master/specs/juno/metadata-schema-catalog.rst
[2] Glance PTL Juno Feature Overview:
https://www.youtube.com/watch?v=3ptriiw1wK8&t=14m27s
Co-Authored-By: Travis Tripp <travis.tripp@hp.com>
Co-Authored-By: Santiago Baldassin<santiago.b.baldassin@intel.com>
Co-Authored-By: Bartosz Fic <bartosz.fic@intel.com>
Co-Authored-By: Pawel Koniszewski <pawel.koniszewski@intel.com>
Co-Authored-By: Michal Dulko <michal.dulko@intel.com>
DocImpact: Concept awareness
Change-Id: Ie34007f73af7e0941631a52f03841068e509a72c
Implements: blueprint glance-metadata-definitions-base-admin-ui
2014-09-12 13:54:01 +02:00
|
|
|
"""
|
2015-11-17 10:19:59 -06:00
|
|
|
# Listing namespaces requires the v2 API. If not supported we return an
|
|
|
|
# empty array so callers don't need to worry about version checking.
|
|
|
|
if get_version() < 2:
|
|
|
|
return [], False, False
|
|
|
|
|
2015-09-21 13:22:59 +03:00
|
|
|
if filters is None:
|
|
|
|
filters = {}
|
2014-09-11 19:10:41 +02:00
|
|
|
limit = getattr(settings, 'API_RESULT_LIMIT', 1000)
|
|
|
|
page_size = utils.get_page_size(request)
|
|
|
|
|
|
|
|
if paginate:
|
|
|
|
request_size = page_size + 1
|
|
|
|
else:
|
|
|
|
request_size = limit
|
|
|
|
|
|
|
|
kwargs = {'filters': filters}
|
|
|
|
if marker:
|
|
|
|
kwargs['marker'] = marker
|
|
|
|
kwargs['sort_dir'] = sort_dir
|
|
|
|
kwargs['sort_key'] = sort_key
|
|
|
|
|
|
|
|
namespaces_iter = glanceclient(request, '2').metadefs_namespace.list(
|
|
|
|
page_size=request_size, limit=limit, **kwargs)
|
|
|
|
|
2016-01-25 16:20:07 -06:00
|
|
|
# Filter the namespaces based on the provided properties_target since this
|
|
|
|
# is not supported by the metadata namespaces API.
|
|
|
|
resource_types = filters.get('resource_types')
|
|
|
|
properties_target = filters.get('properties_target')
|
|
|
|
if resource_types and properties_target:
|
|
|
|
namespaces_iter = filter_properties_target(namespaces_iter,
|
|
|
|
resource_types,
|
|
|
|
properties_target)
|
|
|
|
|
2014-09-11 19:10:41 +02:00
|
|
|
has_prev_data = False
|
|
|
|
has_more_data = False
|
|
|
|
if paginate:
|
|
|
|
namespaces = list(itertools.islice(namespaces_iter, request_size))
|
|
|
|
# first and middle page condition
|
|
|
|
if len(namespaces) > page_size:
|
|
|
|
namespaces.pop(-1)
|
|
|
|
has_more_data = True
|
|
|
|
# middle page condition
|
|
|
|
if marker is not None:
|
|
|
|
has_prev_data = True
|
|
|
|
# first page condition when reached via prev back
|
Base Glance Metadata Definitions Admin UI
Provide a base admin UI for viewing, importing, and associating the
metadata definitions that can be used with various resource types
such as flavors, images, and host aggregates.
In Juno, Glance provided a metadata definitions catalog[1][2] where
users can register the available metadata definitions that can be used
on different types of resources (images, artifacts, volumes, flavors,
aggregates, etc). This includes key / value pairs such as
properties, extra specs, etc. Horizon landed several patches that
read these properties. You can view the functionality in the
"update metadata" action on Flavors, Images, and Host Aggregates.
This specific patch is to bring in the Admin UI for the basic coarse
grained actions on the definitions in the catalog. This includes creating
(importing) a namespace, viewing the overview details about
it, deleting the namespace, and associating the namespace for use with
specific resource types.
Future blueprints will be registered for:
- CRUD on individual metadata definitions within the namespace
For example, editing the default value of an individual property.
[1] Approved Glance Juno Spec:
https://github.com/openstack/glance-specs/blob/master/specs/juno/metadata-schema-catalog.rst
[2] Glance PTL Juno Feature Overview:
https://www.youtube.com/watch?v=3ptriiw1wK8&t=14m27s
Co-Authored-By: Travis Tripp <travis.tripp@hp.com>
Co-Authored-By: Santiago Baldassin<santiago.b.baldassin@intel.com>
Co-Authored-By: Bartosz Fic <bartosz.fic@intel.com>
Co-Authored-By: Pawel Koniszewski <pawel.koniszewski@intel.com>
Co-Authored-By: Michal Dulko <michal.dulko@intel.com>
DocImpact: Concept awareness
Change-Id: Ie34007f73af7e0941631a52f03841068e509a72c
Implements: blueprint glance-metadata-definitions-base-admin-ui
2014-09-12 13:54:01 +02:00
|
|
|
elif sort_dir == 'desc' and marker is not None:
|
2014-09-11 19:10:41 +02:00
|
|
|
has_more_data = True
|
|
|
|
# last page condition
|
|
|
|
elif marker is not None:
|
|
|
|
has_prev_data = True
|
|
|
|
else:
|
|
|
|
namespaces = list(namespaces_iter)
|
|
|
|
|
|
|
|
namespaces = [Namespace(namespace) for namespace in namespaces]
|
|
|
|
return namespaces, has_more_data, has_prev_data
|
Base Glance Metadata Definitions Admin UI
Provide a base admin UI for viewing, importing, and associating the
metadata definitions that can be used with various resource types
such as flavors, images, and host aggregates.
In Juno, Glance provided a metadata definitions catalog[1][2] where
users can register the available metadata definitions that can be used
on different types of resources (images, artifacts, volumes, flavors,
aggregates, etc). This includes key / value pairs such as
properties, extra specs, etc. Horizon landed several patches that
read these properties. You can view the functionality in the
"update metadata" action on Flavors, Images, and Host Aggregates.
This specific patch is to bring in the Admin UI for the basic coarse
grained actions on the definitions in the catalog. This includes creating
(importing) a namespace, viewing the overview details about
it, deleting the namespace, and associating the namespace for use with
specific resource types.
Future blueprints will be registered for:
- CRUD on individual metadata definitions within the namespace
For example, editing the default value of an individual property.
[1] Approved Glance Juno Spec:
https://github.com/openstack/glance-specs/blob/master/specs/juno/metadata-schema-catalog.rst
[2] Glance PTL Juno Feature Overview:
https://www.youtube.com/watch?v=3ptriiw1wK8&t=14m27s
Co-Authored-By: Travis Tripp <travis.tripp@hp.com>
Co-Authored-By: Santiago Baldassin<santiago.b.baldassin@intel.com>
Co-Authored-By: Bartosz Fic <bartosz.fic@intel.com>
Co-Authored-By: Pawel Koniszewski <pawel.koniszewski@intel.com>
Co-Authored-By: Michal Dulko <michal.dulko@intel.com>
DocImpact: Concept awareness
Change-Id: Ie34007f73af7e0941631a52f03841068e509a72c
Implements: blueprint glance-metadata-definitions-base-admin-ui
2014-09-12 13:54:01 +02:00
|
|
|
|
|
|
|
|
2015-12-15 12:13:17 +08:00
|
|
|
def metadefs_namespace_full_list(request, resource_type, filters=None,
|
2015-04-01 19:33:22 +02:00
|
|
|
*args, **kwargs):
|
2015-12-15 12:13:17 +08:00
|
|
|
filters = filters or {}
|
2015-04-01 19:33:22 +02:00
|
|
|
filters['resource_types'] = [resource_type]
|
|
|
|
namespaces, has_more_data, has_prev_data = metadefs_namespace_list(
|
|
|
|
request, filters, *args, **kwargs
|
|
|
|
)
|
|
|
|
return [
|
|
|
|
metadefs_namespace_get(request, x.namespace, resource_type)
|
|
|
|
for x in namespaces
|
|
|
|
], has_more_data, has_prev_data
|
|
|
|
|
|
|
|
|
Base Glance Metadata Definitions Admin UI
Provide a base admin UI for viewing, importing, and associating the
metadata definitions that can be used with various resource types
such as flavors, images, and host aggregates.
In Juno, Glance provided a metadata definitions catalog[1][2] where
users can register the available metadata definitions that can be used
on different types of resources (images, artifacts, volumes, flavors,
aggregates, etc). This includes key / value pairs such as
properties, extra specs, etc. Horizon landed several patches that
read these properties. You can view the functionality in the
"update metadata" action on Flavors, Images, and Host Aggregates.
This specific patch is to bring in the Admin UI for the basic coarse
grained actions on the definitions in the catalog. This includes creating
(importing) a namespace, viewing the overview details about
it, deleting the namespace, and associating the namespace for use with
specific resource types.
Future blueprints will be registered for:
- CRUD on individual metadata definitions within the namespace
For example, editing the default value of an individual property.
[1] Approved Glance Juno Spec:
https://github.com/openstack/glance-specs/blob/master/specs/juno/metadata-schema-catalog.rst
[2] Glance PTL Juno Feature Overview:
https://www.youtube.com/watch?v=3ptriiw1wK8&t=14m27s
Co-Authored-By: Travis Tripp <travis.tripp@hp.com>
Co-Authored-By: Santiago Baldassin<santiago.b.baldassin@intel.com>
Co-Authored-By: Bartosz Fic <bartosz.fic@intel.com>
Co-Authored-By: Pawel Koniszewski <pawel.koniszewski@intel.com>
Co-Authored-By: Michal Dulko <michal.dulko@intel.com>
DocImpact: Concept awareness
Change-Id: Ie34007f73af7e0941631a52f03841068e509a72c
Implements: blueprint glance-metadata-definitions-base-admin-ui
2014-09-12 13:54:01 +02:00
|
|
|
def metadefs_namespace_create(request, namespace):
|
|
|
|
return glanceclient(request, '2').metadefs_namespace.create(**namespace)
|
|
|
|
|
|
|
|
|
|
|
|
def metadefs_namespace_update(request, namespace_name, **properties):
|
|
|
|
return glanceclient(request, '2').metadefs_namespace.update(
|
|
|
|
namespace_name,
|
|
|
|
**properties)
|
|
|
|
|
|
|
|
|
|
|
|
def metadefs_namespace_delete(request, namespace_name):
|
|
|
|
return glanceclient(request, '2').metadefs_namespace.delete(namespace_name)
|
|
|
|
|
|
|
|
|
|
|
|
def metadefs_resource_types_list(request):
|
2015-08-21 10:16:03 -07:00
|
|
|
# Listing Resource Types requires the v2 API. If not supported we return
|
|
|
|
# an empty array so callers don't need to worry about version checking.
|
|
|
|
if get_version() < 2:
|
|
|
|
return []
|
|
|
|
else:
|
|
|
|
return glanceclient(request, '2').metadefs_resource_type.list()
|
Base Glance Metadata Definitions Admin UI
Provide a base admin UI for viewing, importing, and associating the
metadata definitions that can be used with various resource types
such as flavors, images, and host aggregates.
In Juno, Glance provided a metadata definitions catalog[1][2] where
users can register the available metadata definitions that can be used
on different types of resources (images, artifacts, volumes, flavors,
aggregates, etc). This includes key / value pairs such as
properties, extra specs, etc. Horizon landed several patches that
read these properties. You can view the functionality in the
"update metadata" action on Flavors, Images, and Host Aggregates.
This specific patch is to bring in the Admin UI for the basic coarse
grained actions on the definitions in the catalog. This includes creating
(importing) a namespace, viewing the overview details about
it, deleting the namespace, and associating the namespace for use with
specific resource types.
Future blueprints will be registered for:
- CRUD on individual metadata definitions within the namespace
For example, editing the default value of an individual property.
[1] Approved Glance Juno Spec:
https://github.com/openstack/glance-specs/blob/master/specs/juno/metadata-schema-catalog.rst
[2] Glance PTL Juno Feature Overview:
https://www.youtube.com/watch?v=3ptriiw1wK8&t=14m27s
Co-Authored-By: Travis Tripp <travis.tripp@hp.com>
Co-Authored-By: Santiago Baldassin<santiago.b.baldassin@intel.com>
Co-Authored-By: Bartosz Fic <bartosz.fic@intel.com>
Co-Authored-By: Pawel Koniszewski <pawel.koniszewski@intel.com>
Co-Authored-By: Michal Dulko <michal.dulko@intel.com>
DocImpact: Concept awareness
Change-Id: Ie34007f73af7e0941631a52f03841068e509a72c
Implements: blueprint glance-metadata-definitions-base-admin-ui
2014-09-12 13:54:01 +02:00
|
|
|
|
|
|
|
|
|
|
|
def metadefs_namespace_resource_types(request, namespace_name):
|
|
|
|
resource_types = glanceclient(request, '2').metadefs_resource_type.get(
|
|
|
|
namespace_name)
|
|
|
|
|
|
|
|
# metadefs_resource_type.get() returns generator, converting it to list
|
|
|
|
return list(resource_types)
|
|
|
|
|
|
|
|
|
|
|
|
def metadefs_namespace_add_resource_type(request,
|
|
|
|
namespace_name,
|
|
|
|
resource_type):
|
|
|
|
return glanceclient(request, '2').metadefs_resource_type.associate(
|
|
|
|
namespace_name, **resource_type)
|
|
|
|
|
|
|
|
|
|
|
|
def metadefs_namespace_remove_resource_type(request,
|
|
|
|
namespace_name,
|
|
|
|
resource_type_name):
|
|
|
|
glanceclient(request, '2').metadefs_resource_type.deassociate(
|
|
|
|
namespace_name, resource_type_name)
|
2015-10-29 11:42:03 -07:00
|
|
|
|
|
|
|
|
|
|
|
def get_version():
|
|
|
|
return VERSIONS.active
|