1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324
|
# 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.
import typing as ty
from openstack.container_infrastructure_management.v1 import (
cluster as _cluster,
)
from openstack.container_infrastructure_management.v1 import (
cluster_certificate as _cluster_cert,
)
from openstack.container_infrastructure_management.v1 import (
cluster_template as _cluster_template,
)
from openstack.container_infrastructure_management.v1 import (
service as _service,
)
from openstack import proxy
from openstack import resource
class Proxy(proxy.Proxy):
_resource_registry = {
"cluster": _cluster.Cluster,
"cluster_template": _cluster_template.ClusterTemplate,
"service": _service.Service,
}
# ========== Clusters ==========
def create_cluster(self, **attrs):
"""Create a new cluster from attributes
:param dict attrs: Keyword arguments which will be used to create a
:class:`~openstack.container_infrastructure_management.v1.cluster.Cluster`,
comprised of the properties on the Cluster class.
:returns: The results of cluster creation
:rtype:
:class:`~openstack.container_infrastructure_management.v1.cluster.Cluster`
"""
return self._create(_cluster.Cluster, **attrs)
def delete_cluster(self, cluster, ignore_missing=True):
"""Delete a cluster
:param cluster: The value can be either the ID of a cluster or a
:class:`~openstack.container_infrastructure_management.v1.cluster.Cluster`
instance.
:param bool ignore_missing: When set to ``False``
:class:`~openstack.exceptions.NotFoundException` will be raised
when the cluster does not exist. When set to ``True``, no exception
will be set when attempting to delete a nonexistent cluster.
:returns: ``None``
"""
self._delete(_cluster.Cluster, cluster, ignore_missing=ignore_missing)
def find_cluster(self, name_or_id, ignore_missing=True):
"""Find a single cluster
:param name_or_id: The name or ID of a cluster.
:param bool ignore_missing: When set to ``False``
:class:`~openstack.exceptions.NotFoundException` will be
raised when the resource does not exist.
When set to ``True``, None will be returned when
attempting to find a nonexistent resource.
:returns: One
:class:`~openstack.container_infrastructure_management.v1.cluster.Cluster`
or None
"""
return self._find(
_cluster.Cluster,
name_or_id,
ignore_missing=ignore_missing,
)
def get_cluster(self, cluster):
"""Get a single cluster
:param cluster: The value can be the ID of a cluster or a
:class:`~openstack.container_infrastructure_management.v1.cluster.Cluster`
instance.
:returns: One
:class:`~openstack.container_infrastructure_management.v1.cluster.Cluster`
:raises: :class:`~openstack.exceptions.NotFoundException`
when no resource can be found.
"""
return self._get(_cluster.Cluster, cluster)
def clusters(self, **query):
"""Return a generator of clusters
:param kwargs query: Optional query parameters to be sent to limit
the resources being returned.
:returns: A generator of cluster objects
:rtype:
:class:`~openstack.container_infrastructure_management.v1.cluster.Cluster`
"""
return self._list(_cluster.Cluster, **query)
def update_cluster(self, cluster, **attrs):
"""Update a cluster
:param cluster: Either the id of a cluster or a
:class:`~openstack.container_infrastructure_management.v1.cluster.Cluster`
instance.
:param attrs: The attributes to update on the cluster represented
by ``cluster``.
:returns: The updated cluster
:rtype:
:class:`~openstack.container_infrastructure_management.v1.cluster.Cluster`
"""
return self._update(_cluster.Cluster, cluster, **attrs)
# ============== Cluster Templates ==============
def create_cluster_template(self, **attrs):
"""Create a new cluster_template from attributes
:param dict attrs: Keyword arguments which will be used to create a
:class:`~openstack.container_infrastructure_management.v1.cluster_template.ClusterTemplate`,
comprised of the properties on the ClusterTemplate class.
:returns: The results of cluster_template creation
:rtype:
:class:`~openstack.container_infrastructure_management.v1.cluster_template.ClusterTemplate`
"""
return self._create(_cluster_template.ClusterTemplate, **attrs)
def delete_cluster_template(self, cluster_template, ignore_missing=True):
"""Delete a cluster_template
:param cluster_template: The value can be either the ID of a
cluster_template or a
:class:`~openstack.container_infrastructure_management.v1.cluster_template.ClusterTemplate`
instance.
:param bool ignore_missing: When set to ``False``
:class:`~openstack.exceptions.NotFoundException` will be raised
when the cluster_template does not exist. When set to ``True``, no
exception will be set when attempting to delete a nonexistent
cluster_template.
:returns: ``None``
"""
self._delete(
_cluster_template.ClusterTemplate,
cluster_template,
ignore_missing=ignore_missing,
)
def find_cluster_template(self, name_or_id, ignore_missing=True):
"""Find a single cluster_template
:param name_or_id: The name or ID of a cluster_template.
:param bool ignore_missing: When set to ``False``
:class:`~openstack.exceptions.NotFoundException` will be
raised when the resource does not exist.
When set to ``True``, None will be returned when
attempting to find a nonexistent resource.
:returns: One
:class:`~openstack.container_infrastructure_management.v1.cluster_template.ClusterTemplate`
or None
"""
return self._find(
_cluster_template.ClusterTemplate,
name_or_id,
ignore_missing=ignore_missing,
)
def get_cluster_template(self, cluster_template):
"""Get a single cluster_template
:param cluster_template: The value can be the ID of a cluster_template
or a
:class:`~openstack.container_infrastructure_management.v1.cluster_template.ClusterTemplate`
instance.
:returns: One
:class:`~openstack.container_infrastructure_management.v1.cluster_template.ClusterTemplate`
:raises: :class:`~openstack.exceptions.NotFoundException`
when no resource can be found.
"""
return self._get(_cluster_template.ClusterTemplate, cluster_template)
def cluster_templates(self, **query):
"""Return a generator of cluster_templates
:param kwargs query: Optional query parameters to be sent to limit
the resources being returned.
:returns: A generator of cluster_template objects
:rtype:
:class:`~openstack.container_infrastructure_management.v1.cluster_template.ClusterTemplate`
"""
return self._list(_cluster_template.ClusterTemplate, **query)
def update_cluster_template(self, cluster_template, **attrs):
"""Update a cluster_template
:param cluster_template: Either the id of a cluster_template or a
:class:`~openstack.container_infrastructure_management.v1.cluster_template.ClusterTemplate`
instance.
:param attrs: The attributes to update on the cluster_template
represented by ``cluster_template``.
:returns: The updated cluster_template
:rtype:
:class:`~openstack.container_infrastructure_management.v1.cluster_template.ClusterTemplate`
"""
return self._update(
_cluster_template.ClusterTemplate, cluster_template, **attrs
)
# ============== Cluster Certificates ==============
def create_cluster_certificate(self, **attrs):
"""Create a new cluster_certificate from CSR
:param dict attrs: Keyword arguments which will be used to create a
:class:`~openstack.container_infrastructure_management.v1.cluster_certificate.ClusterCertificate`,
comprised of the properties on the ClusterCertificate class.
:returns: The results of cluster_certificate creation
:rtype:
:class:`~openstack.container_infrastructure_management.v1.cluster_certificate.ClusterCertificate`
"""
return self._create(_cluster_cert.ClusterCertificate, **attrs)
def get_cluster_certificate(self, cluster_certificate):
"""Get a single cluster_certificate
:param cluster_certificate: The value can be the ID of a
cluster_certificate or a
:class:`~openstack.container_infrastructure_management.v1.cluster_certificate.ClusterCertificate`
instance.
:returns: One
:class:`~openstack.container_infrastructure_management.v1.cluster_certificate.ClusterCertificate`
:raises: :class:`~openstack.exceptions.NotFoundException`
when no resource can be found.
"""
return self._get(_cluster_cert.ClusterCertificate, cluster_certificate)
# ============== Services ==============
def services(self):
"""Return a generator of services
:returns: A generator of service objects
:rtype:
:class:`~openstack.container_infrastructure_management.v1.service.Service`
"""
return self._list(_service.Service)
# ========== Utilities ==========
def wait_for_status(
self,
res: resource.ResourceT,
status: str,
failures: ty.Optional[list[str]] = None,
interval: ty.Union[int, float, None] = 2,
wait: ty.Optional[int] = None,
attribute: str = 'status',
callback: ty.Optional[ty.Callable[[int], None]] = None,
) -> resource.ResourceT:
"""Wait for the resource to be in a particular status.
:param session: The session to use for making this request.
:param resource: The resource to wait on to reach the status. The
resource must have a status attribute specified via ``attribute``.
:param status: Desired status of the resource.
:param failures: Statuses that would indicate the transition
failed such as 'ERROR'. Defaults to ['ERROR'].
:param interval: Number of seconds to wait between checks.
:param wait: Maximum number of seconds to wait for transition.
Set to ``None`` to wait forever.
:param attribute: Name of the resource attribute that contains the
status.
:param callback: A callback function. This will be called with a single
value, progress. This is API specific but is generally a percentage
value from 0-100.
:return: The updated resource.
:raises: :class:`~openstack.exceptions.ResourceTimeout` if the
transition to status failed to occur in ``wait`` seconds.
:raises: :class:`~openstack.exceptions.ResourceFailure` if the resource
transitioned to one of the states in ``failures``.
:raises: :class:`~AttributeError` if the resource does not have a
``status`` attribute
"""
return resource.wait_for_status(
self, res, status, failures, interval, wait, attribute, callback
)
def wait_for_delete(
self,
res: resource.ResourceT,
interval: int = 2,
wait: int = 120,
callback: ty.Optional[ty.Callable[[int], None]] = None,
) -> resource.ResourceT:
"""Wait for a resource to be deleted.
:param res: The resource to wait on to be deleted.
:param interval: Number of seconds to wait before to consecutive
checks.
:param wait: Maximum number of seconds to wait before the change.
:param callback: A callback function. This will be called with a single
value, progress, which is a percentage value from 0-100.
:returns: The resource is returned on success.
:raises: :class:`~openstack.exceptions.ResourceTimeout` if transition
to delete failed to occur in the specified seconds.
"""
return resource.wait_for_delete(self, res, interval, wait, callback)
|