resources.py 48 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537
  1. """
  2. DataTypes used by this provider
  3. """
  4. import inspect
  5. import ipaddress
  6. import logging
  7. import os
  8. try:
  9. from urllib.parse import urlparse
  10. from urllib.parse import urljoin
  11. except ImportError: # python 2
  12. from urlparse import urlparse
  13. from urlparse import urljoin
  14. from keystoneclient.v3.regions import Region
  15. from neutronclient.common.exceptions import PortNotFoundClient
  16. import novaclient.exceptions as novaex
  17. from openstack.exceptions import HttpException
  18. from openstack.exceptions import NotFoundException
  19. from openstack.exceptions import ResourceNotFound
  20. import swiftclient
  21. from swiftclient.service import SwiftService, SwiftUploadObject
  22. from swiftclient.utils import generate_temp_url
  23. import cloudbridge.cloud.base.helpers as cb_helpers
  24. from cloudbridge.cloud.base.resources import BaseAttachmentInfo
  25. from cloudbridge.cloud.base.resources import BaseBucket
  26. from cloudbridge.cloud.base.resources import BaseBucketContainer
  27. from cloudbridge.cloud.base.resources import BaseBucketObject
  28. from cloudbridge.cloud.base.resources import BaseFloatingIP
  29. from cloudbridge.cloud.base.resources import BaseFloatingIPContainer
  30. from cloudbridge.cloud.base.resources import BaseGatewayContainer
  31. from cloudbridge.cloud.base.resources import BaseInstance
  32. from cloudbridge.cloud.base.resources import BaseInternetGateway
  33. from cloudbridge.cloud.base.resources import BaseKeyPair
  34. from cloudbridge.cloud.base.resources import BaseMachineImage
  35. from cloudbridge.cloud.base.resources import BaseNetwork
  36. from cloudbridge.cloud.base.resources import BasePlacementZone
  37. from cloudbridge.cloud.base.resources import BaseRegion
  38. from cloudbridge.cloud.base.resources import BaseRouter
  39. from cloudbridge.cloud.base.resources import BaseSnapshot
  40. from cloudbridge.cloud.base.resources import BaseSubnet
  41. from cloudbridge.cloud.base.resources import BaseVMFirewall
  42. from cloudbridge.cloud.base.resources import BaseVMFirewallRule
  43. from cloudbridge.cloud.base.resources import BaseVMFirewallRuleContainer
  44. from cloudbridge.cloud.base.resources import BaseVMType
  45. from cloudbridge.cloud.base.resources import BaseVolume
  46. from cloudbridge.cloud.base.resources import ClientPagedResultList
  47. from cloudbridge.cloud.interfaces.exceptions import InvalidValueException
  48. from cloudbridge.cloud.interfaces.resources import GatewayState
  49. from cloudbridge.cloud.interfaces.resources import InstanceState
  50. from cloudbridge.cloud.interfaces.resources import MachineImageState
  51. from cloudbridge.cloud.interfaces.resources import NetworkState
  52. from cloudbridge.cloud.interfaces.resources import RouterState
  53. from cloudbridge.cloud.interfaces.resources import SnapshotState
  54. from cloudbridge.cloud.interfaces.resources import SubnetState
  55. from cloudbridge.cloud.interfaces.resources import TrafficDirection
  56. from cloudbridge.cloud.interfaces.resources import VolumeState
  57. from cloudbridge.cloud.providers.openstack import helpers as oshelpers
  58. ONE_GIG = 1048576000 # in bytes
  59. FIVE_GIG = ONE_GIG * 5 # in bytes
  60. log = logging.getLogger(__name__)
  61. class OpenStackMachineImage(BaseMachineImage):
  62. # ref: http://docs.openstack.org/developer/glance/statuses.html
  63. IMAGE_STATE_MAP = {
  64. 'queued': MachineImageState.PENDING,
  65. 'saving': MachineImageState.PENDING,
  66. 'active': MachineImageState.AVAILABLE,
  67. 'killed': MachineImageState.ERROR,
  68. 'deleted': MachineImageState.UNKNOWN,
  69. 'pending_delete': MachineImageState.PENDING,
  70. 'deactivated': MachineImageState.ERROR
  71. }
  72. def __init__(self, provider, os_image):
  73. super(OpenStackMachineImage, self).__init__(provider)
  74. if isinstance(os_image, OpenStackMachineImage):
  75. # pylint:disable=protected-access
  76. self._os_image = os_image._os_image
  77. else:
  78. self._os_image = os_image
  79. @property
  80. def id(self):
  81. """
  82. Get the image identifier.
  83. """
  84. return self._os_image.id
  85. @property
  86. def name(self):
  87. """
  88. Get the image identifier.
  89. """
  90. return self._os_image.id
  91. @property
  92. def label(self):
  93. """
  94. Get the image label.
  95. """
  96. return self._os_image.name
  97. @label.setter
  98. # pylint:disable=arguments-differ
  99. def label(self, value):
  100. """
  101. Set the image label.
  102. """
  103. self.assert_valid_resource_label(value)
  104. self._provider.os_conn.image.update_image(
  105. self._os_image, name=value or "")
  106. @property
  107. def description(self):
  108. """
  109. Get the image description.
  110. """
  111. return None
  112. @property
  113. def min_disk(self):
  114. """
  115. Returns the minimum size of the disk that's required to
  116. boot this image (in GB)
  117. :rtype: ``int``
  118. :return: The minimum disk size needed by this image
  119. """
  120. return self._os_image.min_disk
  121. def delete(self):
  122. """
  123. Delete this image
  124. """
  125. self._os_image.delete(self._provider.os_conn.session)
  126. @property
  127. def state(self):
  128. return OpenStackMachineImage.IMAGE_STATE_MAP.get(
  129. self._os_image.status, MachineImageState.UNKNOWN)
  130. def refresh(self):
  131. """
  132. Refreshes the state of this instance by re-querying the cloud provider
  133. for its latest state.
  134. """
  135. log.debug("Refreshing OpenStack Machine Image")
  136. image = self._provider.compute.images.get(self.id)
  137. if image:
  138. self._os_image = image._os_image # pylint:disable=protected-access
  139. else:
  140. # The image no longer exists and cannot be refreshed.
  141. # set the status to unknown
  142. self._os_image.status = 'unknown'
  143. class OpenStackPlacementZone(BasePlacementZone):
  144. def __init__(self, provider, zone, region):
  145. super(OpenStackPlacementZone, self).__init__(provider)
  146. if isinstance(zone, OpenStackPlacementZone):
  147. # pylint:disable=protected-access
  148. self._os_zone = zone._os_zone
  149. # pylint:disable=protected-access
  150. self._os_region = zone._os_region
  151. else:
  152. self._os_zone = zone
  153. self._os_region = region
  154. @property
  155. def id(self):
  156. """
  157. Get the zone id
  158. :rtype: ``str``
  159. :return: ID for this zone as returned by the cloud middleware.
  160. """
  161. return self._os_zone
  162. @property
  163. def name(self):
  164. """
  165. Get the zone name.
  166. :rtype: ``str``
  167. :return: Name for this zone as returned by the cloud middleware.
  168. """
  169. # return self._os_zone.zoneName
  170. return self._os_zone
  171. @property
  172. def region_name(self):
  173. """
  174. Get the region that this zone belongs to.
  175. :rtype: ``str``
  176. :return: Name of this zone's region as returned by the cloud middleware
  177. """
  178. return self._os_region
  179. class OpenStackVMType(BaseVMType):
  180. def __init__(self, provider, os_flavor):
  181. super(OpenStackVMType, self).__init__(provider)
  182. self._os_flavor = os_flavor
  183. @property
  184. def id(self):
  185. return self._os_flavor.id
  186. @property
  187. def name(self):
  188. return self._os_flavor.name
  189. @property
  190. def family(self):
  191. # TODO: This may not be standardised across OpenStack
  192. # but NeCTAR is using it this way
  193. return self.extra_data.get('flavor_class:name')
  194. @property
  195. def vcpus(self):
  196. return self._os_flavor.vcpus
  197. @property
  198. def ram(self):
  199. return int(self._os_flavor.ram) / 1024
  200. @property
  201. def size_root_disk(self):
  202. return self._os_flavor.disk
  203. @property
  204. def size_ephemeral_disks(self):
  205. return 0 if self._os_flavor.ephemeral == 'N/A' else \
  206. self._os_flavor.ephemeral
  207. @property
  208. def num_ephemeral_disks(self):
  209. return 0 if self._os_flavor.ephemeral == 'N/A' else \
  210. self._os_flavor.ephemeral
  211. @property
  212. def extra_data(self):
  213. extras = self._os_flavor.get_keys()
  214. extras['rxtx_factor'] = self._os_flavor.rxtx_factor
  215. extras['swap'] = self._os_flavor.swap
  216. extras['is_public'] = self._os_flavor.is_public
  217. return extras
  218. class OpenStackInstance(BaseInstance):
  219. # ref: http://docs.openstack.org/developer/nova/v2/2.0_server_concepts.html
  220. # and http://developer.openstack.org/api-ref-compute-v2.html
  221. INSTANCE_STATE_MAP = {
  222. 'ACTIVE': InstanceState.RUNNING,
  223. 'BUILD': InstanceState.PENDING,
  224. 'DELETED': InstanceState.DELETED,
  225. 'ERROR': InstanceState.ERROR,
  226. 'HARD_REBOOT': InstanceState.REBOOTING,
  227. 'PASSWORD': InstanceState.PENDING,
  228. 'PAUSED': InstanceState.STOPPED,
  229. 'REBOOT': InstanceState.REBOOTING,
  230. 'REBUILD': InstanceState.CONFIGURING,
  231. 'RESCUE': InstanceState.CONFIGURING,
  232. 'RESIZE': InstanceState.CONFIGURING,
  233. 'REVERT_RESIZE': InstanceState.CONFIGURING,
  234. 'SOFT_DELETED': InstanceState.STOPPED,
  235. 'STOPPED': InstanceState.STOPPED,
  236. 'SUSPENDED': InstanceState.STOPPED,
  237. 'SHUTOFF': InstanceState.STOPPED,
  238. 'UNKNOWN': InstanceState.UNKNOWN,
  239. 'VERIFY_RESIZE': InstanceState.CONFIGURING
  240. }
  241. def __init__(self, provider, os_instance):
  242. super(OpenStackInstance, self).__init__(provider)
  243. self._os_instance = os_instance
  244. @property
  245. def id(self):
  246. """
  247. Get the instance identifier.
  248. """
  249. return self._os_instance.id
  250. @property
  251. def name(self):
  252. """
  253. Get the instance identifier.
  254. """
  255. return self.id
  256. @property
  257. # pylint:disable=arguments-differ
  258. def label(self):
  259. """
  260. Get the instance label.
  261. """
  262. return self._os_instance.name
  263. @label.setter
  264. # pylint:disable=arguments-differ
  265. def label(self, value):
  266. """
  267. Set the instance label.
  268. """
  269. self.assert_valid_resource_label(value)
  270. self._os_instance.name = value
  271. self._os_instance.update(name=value or "cb-inst")
  272. @property
  273. def public_ips(self):
  274. """
  275. Get all the public IP addresses for this instance.
  276. """
  277. # OpenStack doesn't provide an easy way to figure our whether an IP is
  278. # public or private, since the returned IPs are grouped by an arbitrary
  279. # network label. Therefore, it's necessary to parse the address and
  280. # determine whether it's public or private
  281. return [address
  282. for _, addresses in self._os_instance.networks.items()
  283. for address in addresses
  284. if not ipaddress.ip_address(address).is_private]
  285. @property
  286. def private_ips(self):
  287. """
  288. Get all the private IP addresses for this instance.
  289. """
  290. return [address
  291. for _, addresses in self._os_instance.networks.items()
  292. for address in addresses
  293. if ipaddress.ip_address(address).is_private]
  294. @property
  295. def vm_type_id(self):
  296. """
  297. Get the VM type name.
  298. """
  299. return self._os_instance.flavor.get('id')
  300. @property
  301. def vm_type(self):
  302. """
  303. Get the VM type object.
  304. """
  305. flavor = self._provider.nova.flavors.get(
  306. self._os_instance.flavor.get('id'))
  307. return OpenStackVMType(self._provider, flavor)
  308. def reboot(self):
  309. """
  310. Reboot this instance (using the cloud middleware API).
  311. """
  312. self._os_instance.reboot()
  313. def delete(self):
  314. """
  315. Permanently delete this instance.
  316. """
  317. # delete the port we created when launching
  318. # Assumption: it's the first interface in the list
  319. iface_list = self._os_instance.interface_list()
  320. if iface_list:
  321. self._provider.neutron.delete_port(iface_list[0].port_id)
  322. self._os_instance.delete()
  323. @property
  324. def image_id(self):
  325. """
  326. Get the image ID for this instance.
  327. """
  328. # In OpenStack, the Machine Image of a running instance may
  329. # be deleted, so make sure the image exists before attempting to
  330. # retrieve its id
  331. return (self._os_instance.image.get("id")
  332. if self._os_instance.image else "")
  333. @property
  334. def zone_id(self):
  335. """
  336. Get the placement zone where this instance is running.
  337. """
  338. return getattr(self._os_instance, 'OS-EXT-AZ:availability_zone', None)
  339. @property
  340. def subnet_id(self):
  341. """
  342. Extract (one) subnet id associated with this instance.
  343. In OpenStack, instances are associated with ports instead of
  344. instances so we need to dig through several connections to retrieve
  345. the subnet_id. Further, there can potentially be several ports
  346. connected to to different subnets. This implementation retrieves one
  347. subnet, the one corresponding to port associated with the first
  348. private IP associated with the instance.
  349. """
  350. # MAC address can be used to identify a port so extract the MAC
  351. # address corresponding to the (first) private IP associated with the
  352. # instance.
  353. for net in self._os_instance.to_dict().get('addresses').keys():
  354. for iface in self._os_instance.to_dict().get('addresses')[net]:
  355. if iface.get('OS-EXT-IPS:type') == 'fixed':
  356. port = iface.get('OS-EXT-IPS-MAC:mac_addr')
  357. addr = iface.get('addr')
  358. break
  359. # Now get a handle to a port with the given MAC address and get the
  360. # subnet to which the private IP is connected as the desired id.
  361. for prt in self._provider.neutron.list_ports().get('ports'):
  362. if prt.get('mac_address') == port:
  363. for ip in prt.get('fixed_ips'):
  364. if ip.get('ip_address') == addr:
  365. return ip.get('subnet_id')
  366. @property
  367. def vm_firewalls(self):
  368. return [
  369. self._provider.security.vm_firewalls.get(group.id)
  370. for group in self._os_instance.list_security_group()
  371. ]
  372. @property
  373. def vm_firewall_ids(self):
  374. """
  375. Get the VM firewall IDs associated with this instance.
  376. """
  377. return [fw.id for fw in self.vm_firewalls]
  378. @property
  379. def key_pair_id(self):
  380. """
  381. Get the id of the key pair associated with this instance.
  382. """
  383. return self._os_instance.key_name
  384. def create_image(self, label):
  385. """
  386. Create a new image based on this instance.
  387. """
  388. log.debug("Creating OpenStack Image with the label %s", label)
  389. self.assert_valid_resource_label(label)
  390. name = self._generate_name_from_label(label, 'cb-img')
  391. image_id = self._os_instance.create_image(name)
  392. img = OpenStackMachineImage(
  393. self._provider, self._provider.compute.images.get(image_id))
  394. img.label = label
  395. return img
  396. def _get_fip(self, floating_ip):
  397. """Get a floating IP object based on the supplied ID."""
  398. return OpenStackFloatingIP(
  399. self._provider,
  400. self._provider.os_conn.network.get_ip(floating_ip))
  401. def add_floating_ip(self, floating_ip):
  402. """
  403. Add a floating IP address to this instance.
  404. """
  405. log.debug("Adding floating IP adress: %s", floating_ip)
  406. fip = (floating_ip if isinstance(floating_ip, OpenStackFloatingIP)
  407. else self._get_fip(floating_ip))
  408. self._provider.os_conn.compute.add_floating_ip_to_server(
  409. self.id, fip.public_ip)
  410. def remove_floating_ip(self, floating_ip):
  411. """
  412. Remove a floating IP address from this instance.
  413. """
  414. log.debug("Removing floating IP adress: %s", floating_ip)
  415. fip = (floating_ip if isinstance(floating_ip, OpenStackFloatingIP)
  416. else self._get_fip(floating_ip))
  417. self._provider.os_conn.compute.remove_floating_ip_from_server(
  418. self.id, fip.public_ip)
  419. def add_vm_firewall(self, firewall):
  420. """
  421. Add a VM firewall to this instance
  422. """
  423. log.debug("Adding firewall: %s", firewall)
  424. self._os_instance.add_security_group(firewall.id)
  425. def remove_vm_firewall(self, firewall):
  426. """
  427. Remove a VM firewall from this instance
  428. """
  429. log.debug("Removing firewall: %s", firewall)
  430. self._os_instance.remove_security_group(firewall.id)
  431. @property
  432. def state(self):
  433. return OpenStackInstance.INSTANCE_STATE_MAP.get(
  434. self._os_instance.status, InstanceState.UNKNOWN)
  435. def refresh(self):
  436. """
  437. Refreshes the state of this instance by re-querying the cloud provider
  438. for its latest state.
  439. """
  440. instance = self._provider.compute.instances.get(
  441. self.id)
  442. if instance:
  443. # pylint:disable=protected-access
  444. self._os_instance = instance._os_instance
  445. else:
  446. # The instance no longer exists and cannot be refreshed.
  447. # set the status to unknown
  448. self._os_instance.status = 'unknown'
  449. class OpenStackRegion(BaseRegion):
  450. def __init__(self, provider, os_region):
  451. super(OpenStackRegion, self).__init__(provider)
  452. self._os_region = os_region
  453. @property
  454. def id(self):
  455. return (self._os_region.id if type(self._os_region) == Region else
  456. self._os_region)
  457. @property
  458. def name(self):
  459. return self.id
  460. @property
  461. def zones(self):
  462. # ``detailed`` param must be set to ``False`` because the (default)
  463. # ``True`` value requires Admin privileges
  464. if self.name == self._provider.region_name: # optimisation
  465. zones = self._provider.nova.availability_zones.list(detailed=False)
  466. else:
  467. try:
  468. # pylint:disable=protected-access
  469. region_nova = self._provider._connect_nova_region(self.name)
  470. zones = region_nova.availability_zones.list(detailed=False)
  471. except novaex.EndpointNotFound:
  472. # This region may not have a compute endpoint. If so just
  473. # return an empty list
  474. zones = []
  475. return [OpenStackPlacementZone(self._provider, z.zoneName, self.name)
  476. for z in zones]
  477. class OpenStackVolume(BaseVolume):
  478. # Ref: http://developer.openstack.org/api-ref-blockstorage-v2.html
  479. VOLUME_STATE_MAP = {
  480. 'creating': VolumeState.CREATING,
  481. 'available': VolumeState.AVAILABLE,
  482. 'attaching': VolumeState.CONFIGURING,
  483. 'in-use': VolumeState.IN_USE,
  484. 'deleting': VolumeState.CONFIGURING,
  485. 'error': VolumeState.ERROR,
  486. 'error_deleting': VolumeState.ERROR,
  487. 'backing-up': VolumeState.CONFIGURING,
  488. 'restoring-backup': VolumeState.CONFIGURING,
  489. 'error_restoring': VolumeState.ERROR,
  490. 'error_extending': VolumeState.ERROR
  491. }
  492. def __init__(self, provider, volume):
  493. super(OpenStackVolume, self).__init__(provider)
  494. self._volume = volume
  495. @property
  496. def id(self):
  497. return self._volume.id
  498. @property
  499. def name(self):
  500. return self.id
  501. @property
  502. # pylint:disable=arguments-differ
  503. def label(self):
  504. """
  505. Get the volume label.
  506. """
  507. return self._volume.name
  508. @label.setter
  509. # pylint:disable=arguments-differ
  510. def label(self, value):
  511. """
  512. Set the volume label.
  513. """
  514. self.assert_valid_resource_label(value)
  515. self._volume.name = value
  516. self._volume.update(name=value or "")
  517. @property
  518. def description(self):
  519. return self._volume.description
  520. @description.setter
  521. def description(self, value):
  522. self._volume.description = value
  523. self._volume.update(description=value)
  524. @property
  525. def size(self):
  526. return self._volume.size
  527. @property
  528. def create_time(self):
  529. return self._volume.created_at
  530. @property
  531. def zone_id(self):
  532. return self._volume.availability_zone
  533. @property
  534. def source(self):
  535. if self._volume.snapshot_id:
  536. return self._provider.storage.snapshots.get(
  537. self._volume.snapshot_id)
  538. return None
  539. @property
  540. def attachments(self):
  541. if self._volume.attachments:
  542. return BaseAttachmentInfo(
  543. self,
  544. self._volume.attachments[0].get('server_id'),
  545. self._volume.attachments[0].get('device'))
  546. else:
  547. return None
  548. def attach(self, instance, device):
  549. """
  550. Attach this volume to an instance.
  551. """
  552. log.debug("Attaching %s to %s instance", device, instance)
  553. instance_id = instance.id if isinstance(
  554. instance,
  555. OpenStackInstance) else instance
  556. self._volume.attach(instance_id, device)
  557. def detach(self, force=False):
  558. """
  559. Detach this volume from an instance.
  560. """
  561. self._volume.detach()
  562. def create_snapshot(self, label, description=None):
  563. """
  564. Create a snapshot of this Volume.
  565. """
  566. log.debug("Creating snapchat of volume: %s with the "
  567. "description: %s", label, description)
  568. return self._provider.storage.snapshots.create(
  569. label, self, description=description)
  570. def delete(self):
  571. """
  572. Delete this volume.
  573. """
  574. self._volume.delete()
  575. @property
  576. def state(self):
  577. return OpenStackVolume.VOLUME_STATE_MAP.get(
  578. self._volume.status, VolumeState.UNKNOWN)
  579. def refresh(self):
  580. """
  581. Refreshes the state of this volume by re-querying the cloud provider
  582. for its latest state.
  583. """
  584. vol = self._provider.storage.volumes.get(
  585. self.id)
  586. if vol:
  587. self._volume = vol._volume # pylint:disable=protected-access
  588. else:
  589. # The volume no longer exists and cannot be refreshed.
  590. # set the status to unknown
  591. self._volume.status = 'unknown'
  592. class OpenStackSnapshot(BaseSnapshot):
  593. # Ref: http://developer.openstack.org/api-ref-blockstorage-v2.html
  594. SNAPSHOT_STATE_MAP = {
  595. 'creating': SnapshotState.PENDING,
  596. 'available': SnapshotState.AVAILABLE,
  597. 'deleting': SnapshotState.CONFIGURING,
  598. 'error': SnapshotState.ERROR,
  599. 'error_deleting': SnapshotState.ERROR
  600. }
  601. def __init__(self, provider, snapshot):
  602. super(OpenStackSnapshot, self).__init__(provider)
  603. self._snapshot = snapshot
  604. @property
  605. def id(self):
  606. return self._snapshot.id
  607. @property
  608. def name(self):
  609. return self.id
  610. @property
  611. # pylint:disable=arguments-differ
  612. def label(self):
  613. """
  614. Get the snapshot label.
  615. """
  616. return self._snapshot.name
  617. @label.setter
  618. # pylint:disable=arguments-differ
  619. def label(self, value):
  620. """
  621. Set the snapshot label.
  622. """
  623. self.assert_valid_resource_label(value)
  624. self._snapshot.name = value
  625. self._snapshot.update(name=value or "")
  626. @property
  627. def description(self):
  628. return self._snapshot.description
  629. @description.setter
  630. def description(self, value):
  631. self._snapshot.description = value
  632. self._snapshot.update(description=value)
  633. @property
  634. def size(self):
  635. return self._snapshot.size
  636. @property
  637. def volume_id(self):
  638. return self._snapshot.volume_id
  639. @property
  640. def create_time(self):
  641. return self._snapshot.created_at
  642. @property
  643. def state(self):
  644. return OpenStackSnapshot.SNAPSHOT_STATE_MAP.get(
  645. self._snapshot.status, SnapshotState.UNKNOWN)
  646. def refresh(self):
  647. """
  648. Refreshes the state of this snapshot by re-querying the cloud provider
  649. for its latest state.
  650. """
  651. snap = self._provider.storage.snapshots.get(
  652. self.id)
  653. if snap:
  654. self._snapshot = snap._snapshot # pylint:disable=protected-access
  655. else:
  656. # The snapshot no longer exists and cannot be refreshed.
  657. # set the status to unknown
  658. self._snapshot.status = 'unknown'
  659. def delete(self):
  660. """
  661. Delete this snapshot.
  662. """
  663. self._snapshot.delete()
  664. def create_volume(self, placement, size=None, volume_type=None, iops=None):
  665. """
  666. Create a new Volume from this Snapshot.
  667. """
  668. vol_label = "from-snap-{0}".format(self.id or self.label)
  669. name = self._generate_name_from_label(vol_label, 'cb-vol')
  670. size = size if size else self._snapshot.size
  671. os_vol = self._provider.cinder.volumes.create(
  672. size, name=name, availability_zone=placement,
  673. snapshot_id=self._snapshot.id)
  674. cb_vol = OpenStackVolume(self._provider, os_vol)
  675. cb_vol.label = vol_label
  676. return cb_vol
  677. class OpenStackGatewayContainer(BaseGatewayContainer):
  678. """For OpenStack, an internet gateway is a just an 'external' network."""
  679. def __init__(self, provider, network):
  680. super(OpenStackGatewayContainer, self).__init__(provider, network)
  681. def _check_fip_connectivity(self, external_net):
  682. # Due to current limitations in OpenStack:
  683. # https://bugs.launchpad.net/neutron/+bug/1743480, it's not
  684. # possible to differentiate between floating ip networks and provider
  685. # external networks. Therefore, we systematically step through
  686. # all available networks and perform an assignment test to infer valid
  687. # floating ip nets.
  688. dummy_router = self._provider.networking.routers.create(
  689. label='cb-conn-test-router', network=self._network)
  690. with cb_helpers.cleanup_action(lambda: dummy_router.delete()):
  691. try:
  692. dummy_router.attach_gateway(external_net)
  693. return True
  694. except Exception:
  695. return False
  696. def get_or_create_inet_gateway(self):
  697. """For OS, inet gtw is any net that has `external` property set."""
  698. external_nets = (n for n in self._provider.networking.networks
  699. if n.external)
  700. for net in external_nets:
  701. if self._check_fip_connectivity(net):
  702. return OpenStackInternetGateway(self._provider, net)
  703. return None
  704. def delete(self, gateway):
  705. log.debug("Deleting OpenStack Gateway: %s", gateway)
  706. gateway.delete()
  707. def list(self, limit=None, marker=None):
  708. log.debug("OpenStack listing of all current internet gateways")
  709. igl = [OpenStackInternetGateway(self._provider, n)
  710. for n in self._provider.networking.networks
  711. if n.external and self._check_fip_connectivity(n)]
  712. return ClientPagedResultList(self._provider, igl, limit=limit,
  713. marker=marker)
  714. class OpenStackNetwork(BaseNetwork):
  715. # Ref: https://github.com/openstack/neutron/blob/master/neutron/plugins/
  716. # common/constants.py
  717. _NETWORK_STATE_MAP = {
  718. 'PENDING_CREATE': NetworkState.PENDING,
  719. 'PENDING_UPDATE': NetworkState.PENDING,
  720. 'PENDING_DELETE': NetworkState.PENDING,
  721. 'CREATED': NetworkState.PENDING,
  722. 'INACTIVE': NetworkState.PENDING,
  723. 'DOWN': NetworkState.DOWN,
  724. 'ERROR': NetworkState.ERROR,
  725. 'ACTIVE': NetworkState.AVAILABLE
  726. }
  727. def __init__(self, provider, network):
  728. super(OpenStackNetwork, self).__init__(provider)
  729. self._network = network
  730. self._gateway_service = OpenStackGatewayContainer(provider, self)
  731. @property
  732. def id(self):
  733. return self._network.get('id', None)
  734. @property
  735. def name(self):
  736. return self.id
  737. @property
  738. def label(self):
  739. return self._network.get('name', None)
  740. @label.setter
  741. def label(self, value): # pylint:disable=arguments-differ
  742. """
  743. Set the network label.
  744. """
  745. self.assert_valid_resource_label(value)
  746. self._provider.neutron.update_network(
  747. self.id, {'network': {'name': value or ""}})
  748. self.refresh()
  749. @property
  750. def external(self):
  751. return self._network.get('router:external', False)
  752. @property
  753. def state(self):
  754. self.refresh()
  755. return OpenStackNetwork._NETWORK_STATE_MAP.get(
  756. self._network.get('status', None),
  757. NetworkState.UNKNOWN)
  758. @property
  759. def cidr_block(self):
  760. # OpenStack does not define a CIDR block for networks
  761. return ''
  762. def delete(self):
  763. if not self.external and self.id in str(
  764. self._provider.neutron.list_networks()):
  765. # If there are ports associated with the network, it won't delete
  766. ports = self._provider.neutron.list_ports(
  767. network_id=self.id).get('ports', [])
  768. for port in ports:
  769. try:
  770. self._provider.neutron.delete_port(port.get('id'))
  771. except PortNotFoundClient:
  772. # Ports could have already been deleted if instances
  773. # are terminated etc. so exceptions can be safely ignored
  774. pass
  775. self._provider.neutron.delete_network(self.id)
  776. @property
  777. def subnets(self):
  778. subnets = (self._provider.neutron.list_subnets(network_id=self.id)
  779. .get('subnets', []))
  780. return [OpenStackSubnet(self._provider, subnet) for subnet in subnets]
  781. def refresh(self):
  782. """Refresh the state of this network by re-querying the provider."""
  783. network = self._provider.networking.networks.get(self.id)
  784. if network:
  785. # pylint:disable=protected-access
  786. self._network = network._network
  787. else:
  788. # subnet no longer exists
  789. self._network.state = NetworkState.UNKNOWN
  790. @property
  791. def gateways(self):
  792. return self._gateway_service
  793. class OpenStackSubnet(BaseSubnet):
  794. def __init__(self, provider, subnet):
  795. super(OpenStackSubnet, self).__init__(provider)
  796. self._subnet = subnet
  797. self._state = None
  798. @property
  799. def id(self):
  800. return self._subnet.get('id', None)
  801. @property
  802. def name(self):
  803. return self.id
  804. @property
  805. def label(self):
  806. return self._subnet.get('name', None)
  807. @label.setter
  808. def label(self, value): # pylint:disable=arguments-differ
  809. """
  810. Set the subnet label.
  811. """
  812. self.assert_valid_resource_label(value)
  813. self._provider.neutron.update_subnet(
  814. self.id, {'subnet': {'name': value or ""}})
  815. self._subnet['name'] = value
  816. @property
  817. def cidr_block(self):
  818. return self._subnet.get('cidr', None)
  819. @property
  820. def network_id(self):
  821. return self._subnet.get('network_id', None)
  822. @property
  823. def zone(self):
  824. """
  825. OpenStack does not have a notion of placement zone for subnets.
  826. Default to None.
  827. """
  828. return None
  829. def delete(self):
  830. if self.id in str(self._provider.neutron.list_subnets()):
  831. self._provider.neutron.delete_subnet(self.id)
  832. @property
  833. def state(self):
  834. return SubnetState.UNKNOWN if self._state == SubnetState.UNKNOWN \
  835. else SubnetState.AVAILABLE
  836. def refresh(self):
  837. subnet = self._provider.networking.subnets.get(self.id)
  838. if subnet:
  839. # pylint:disable=protected-access
  840. self._subnet = subnet._subnet
  841. self._state = SubnetState.AVAILABLE
  842. else:
  843. # subnet no longer exists
  844. self._state = SubnetState.UNKNOWN
  845. class OpenStackFloatingIPContainer(BaseFloatingIPContainer):
  846. def __init__(self, provider, gateway):
  847. super(OpenStackFloatingIPContainer, self).__init__(provider, gateway)
  848. def get(self, fip_id):
  849. try:
  850. return OpenStackFloatingIP(
  851. self._provider, self._provider.os_conn.network.get_ip(fip_id))
  852. except (ResourceNotFound, NotFoundException):
  853. log.debug("Floating IP %s not found.", fip_id)
  854. return None
  855. def list(self, limit=None, marker=None):
  856. fips = [OpenStackFloatingIP(self._provider, fip)
  857. for fip in self._provider.os_conn.network.ips(
  858. floating_network_id=self.gateway.id
  859. )]
  860. return ClientPagedResultList(self._provider, fips,
  861. limit=limit, marker=marker)
  862. def create(self):
  863. return OpenStackFloatingIP(
  864. self._provider, self._provider.os_conn.network.create_ip(
  865. floating_network_id=self.gateway.id))
  866. class OpenStackFloatingIP(BaseFloatingIP):
  867. def __init__(self, provider, floating_ip):
  868. super(OpenStackFloatingIP, self).__init__(provider)
  869. self._ip = floating_ip
  870. @property
  871. def id(self):
  872. return self._ip.id
  873. @property
  874. def public_ip(self):
  875. return self._ip.floating_ip_address
  876. @property
  877. def private_ip(self):
  878. return self._ip.fixed_ip_address
  879. @property
  880. def in_use(self):
  881. return bool(self._ip.port_id)
  882. def delete(self):
  883. self._ip.delete(self._provider.os_conn.session)
  884. def refresh(self):
  885. net = self._provider.networking.networks.get(
  886. self._ip.floating_network_id)
  887. gw = net.gateways.get_or_create_inet_gateway()
  888. fip = gw.floating_ips.get(self.id)
  889. # pylint:disable=protected-access
  890. self._ip = fip._ip
  891. class OpenStackRouter(BaseRouter):
  892. def __init__(self, provider, router):
  893. super(OpenStackRouter, self).__init__(provider)
  894. self._router = router
  895. @property
  896. def id(self):
  897. return self._router.get('id', None)
  898. @property
  899. def name(self):
  900. return self.id
  901. @property
  902. def label(self):
  903. return self._router.get('name', None)
  904. @label.setter
  905. def label(self, value): # pylint:disable=arguments-differ
  906. """
  907. Set the router label.
  908. """
  909. self.assert_valid_resource_label(value)
  910. self._provider.neutron.update_router(
  911. self.id, {'router': {'name': value or ""}})
  912. self.refresh()
  913. def refresh(self):
  914. self._router = self._provider.neutron.show_router(self.id)['router']
  915. @property
  916. def state(self):
  917. if self._router.get('external_gateway_info'):
  918. return RouterState.ATTACHED
  919. return RouterState.DETACHED
  920. @property
  921. def network_id(self):
  922. if self.state == RouterState.ATTACHED:
  923. return self._router.get('external_gateway_info', {}).get(
  924. 'network_id', None)
  925. return None
  926. def delete(self):
  927. self._provider.neutron.delete_router(self.id)
  928. def attach_subnet(self, subnet):
  929. router_interface = {'subnet_id': subnet.id}
  930. ret = self._provider.neutron.add_interface_router(
  931. self.id, router_interface)
  932. if subnet.id in ret.get('subnet_ids', ""):
  933. return True
  934. return False
  935. def detach_subnet(self, subnet):
  936. router_interface = {'subnet_id': subnet.id}
  937. ret = self._provider.neutron.remove_interface_router(
  938. self.id, router_interface)
  939. if subnet.id in ret.get('subnet_ids', ""):
  940. return True
  941. return False
  942. def attach_gateway(self, gateway):
  943. self._provider.neutron.add_gateway_router(
  944. self.id, {'network_id': gateway.id})
  945. def detach_gateway(self, gateway):
  946. self._provider.neutron.remove_gateway_router(
  947. self.id).get('router', self._router)
  948. class OpenStackInternetGateway(BaseInternetGateway):
  949. GATEWAY_STATE_MAP = {
  950. NetworkState.AVAILABLE: GatewayState.AVAILABLE,
  951. NetworkState.DOWN: GatewayState.ERROR,
  952. NetworkState.ERROR: GatewayState.ERROR,
  953. NetworkState.PENDING: GatewayState.CONFIGURING,
  954. NetworkState.UNKNOWN: GatewayState.UNKNOWN
  955. }
  956. def __init__(self, provider, gateway_net):
  957. super(OpenStackInternetGateway, self).__init__(provider)
  958. if isinstance(gateway_net, OpenStackNetwork):
  959. # pylint:disable=protected-access
  960. gateway_net = gateway_net._network
  961. self._gateway_net = gateway_net
  962. self._fips_container = OpenStackFloatingIPContainer(provider, self)
  963. @property
  964. def id(self):
  965. return self._gateway_net.get('id', None)
  966. @property
  967. def name(self):
  968. return self._gateway_net.get('name', None)
  969. @property
  970. def network_id(self):
  971. return self._gateway_net.get('id')
  972. def refresh(self):
  973. """Refresh the state of this network by re-querying the provider."""
  974. network = self._provider.networking.networks.get(self.id)
  975. if network:
  976. # pylint:disable=protected-access
  977. self._gateway_net = network._network
  978. else:
  979. # subnet no longer exists
  980. self._gateway_net.state = NetworkState.UNKNOWN
  981. @property
  982. def state(self):
  983. return self.GATEWAY_STATE_MAP.get(
  984. self._gateway_net.state, GatewayState.UNKNOWN)
  985. def delete(self):
  986. """Do nothing on openstack"""
  987. pass
  988. @property
  989. def floating_ips(self):
  990. return self._fips_container
  991. class OpenStackKeyPair(BaseKeyPair):
  992. def __init__(self, provider, key_pair):
  993. super(OpenStackKeyPair, self).__init__(provider, key_pair)
  994. class OpenStackVMFirewall(BaseVMFirewall):
  995. def __init__(self, provider, vm_firewall):
  996. super(OpenStackVMFirewall, self).__init__(provider, vm_firewall)
  997. self._rule_svc = OpenStackVMFirewallRuleContainer(provider, self)
  998. @property
  999. def network_id(self):
  1000. """
  1001. OpenStack does not associate a SG with a network so default to None.
  1002. :return: Always return ``None``.
  1003. """
  1004. return None
  1005. @property
  1006. def name(self):
  1007. """
  1008. Return the name of this VM firewall.
  1009. """
  1010. return self.id
  1011. @property
  1012. def label(self):
  1013. return self._vm_firewall.name
  1014. @label.setter
  1015. # pylint:disable=arguments-differ
  1016. def label(self, value):
  1017. self.assert_valid_resource_label(value)
  1018. self._provider.os_conn.network.update_security_group(
  1019. self.id, name=value or "")
  1020. self.refresh()
  1021. @property
  1022. def rules(self):
  1023. return self._rule_svc
  1024. def delete(self):
  1025. return self._vm_firewall.delete(self._provider.os_conn.session)
  1026. def refresh(self):
  1027. self._vm_firewall = self._provider.os_conn.network.get_security_group(
  1028. self.id)
  1029. def to_json(self):
  1030. attr = inspect.getmembers(self, lambda a: not(inspect.isroutine(a)))
  1031. js = {k: v for(k, v) in attr if not k.startswith('_')}
  1032. json_rules = [r.to_json() for r in self.rules]
  1033. js['rules'] = json_rules
  1034. return js
  1035. class OpenStackVMFirewallRuleContainer(BaseVMFirewallRuleContainer):
  1036. def __init__(self, provider, firewall):
  1037. super(OpenStackVMFirewallRuleContainer, self).__init__(
  1038. provider, firewall)
  1039. def list(self, limit=None, marker=None):
  1040. # pylint:disable=protected-access
  1041. rules = [OpenStackVMFirewallRule(self.firewall, r)
  1042. for r in self.firewall._vm_firewall.security_group_rules]
  1043. return ClientPagedResultList(self._provider, rules,
  1044. limit=limit, marker=marker)
  1045. def create(self, direction, protocol=None, from_port=None,
  1046. to_port=None, cidr=None, src_dest_fw=None):
  1047. src_dest_fw_id = (src_dest_fw.id if isinstance(src_dest_fw,
  1048. OpenStackVMFirewall)
  1049. else src_dest_fw)
  1050. try:
  1051. if direction == TrafficDirection.INBOUND:
  1052. os_direction = 'ingress'
  1053. elif direction == TrafficDirection.OUTBOUND:
  1054. os_direction = 'egress'
  1055. else:
  1056. raise InvalidValueException("direction", direction)
  1057. # pylint:disable=protected-access
  1058. rule = self._provider.os_conn.network.create_security_group_rule(
  1059. security_group_id=self.firewall.id,
  1060. direction=os_direction,
  1061. port_range_max=to_port,
  1062. port_range_min=from_port,
  1063. protocol=protocol,
  1064. remote_ip_prefix=cidr,
  1065. remote_group_id=src_dest_fw_id)
  1066. self.firewall.refresh()
  1067. return OpenStackVMFirewallRule(self.firewall, rule.to_dict())
  1068. except HttpException as e:
  1069. self.firewall.refresh()
  1070. # 409=Conflict, raised for duplicate rule
  1071. if e.status_code == 409:
  1072. existing = self.find(direction=direction, protocol=protocol,
  1073. from_port=from_port, to_port=to_port,
  1074. cidr=cidr, src_dest_fw_id=src_dest_fw_id)
  1075. return existing[0]
  1076. else:
  1077. raise e
  1078. class OpenStackVMFirewallRule(BaseVMFirewallRule):
  1079. def __init__(self, parent_fw, rule):
  1080. super(OpenStackVMFirewallRule, self).__init__(parent_fw, rule)
  1081. @property
  1082. def id(self):
  1083. return self._rule.get('id')
  1084. @property
  1085. def direction(self):
  1086. direction = self._rule.get('direction')
  1087. if direction == 'ingress':
  1088. return TrafficDirection.INBOUND
  1089. elif direction == 'egress':
  1090. return TrafficDirection.OUTBOUND
  1091. else:
  1092. return None
  1093. @property
  1094. def protocol(self):
  1095. return self._rule.get('protocol')
  1096. @property
  1097. def from_port(self):
  1098. return self._rule.get('port_range_min')
  1099. @property
  1100. def to_port(self):
  1101. return self._rule.get('port_range_max')
  1102. @property
  1103. def cidr(self):
  1104. return self._rule.get('remote_ip_prefix')
  1105. @property
  1106. def src_dest_fw_id(self):
  1107. fw = self.src_dest_fw
  1108. if fw:
  1109. return fw.id
  1110. return None
  1111. @property
  1112. def src_dest_fw(self):
  1113. fw_id = self._rule.get('remote_group_id')
  1114. if fw_id:
  1115. return self._provider.security.vm_firewalls.get(fw_id)
  1116. return None
  1117. def delete(self):
  1118. self._provider.os_conn.network.delete_security_group_rule(self.id)
  1119. self.firewall.refresh()
  1120. class OpenStackBucketObject(BaseBucketObject):
  1121. def __init__(self, provider, cbcontainer, obj):
  1122. super(OpenStackBucketObject, self).__init__(provider)
  1123. self.cbcontainer = cbcontainer
  1124. self._obj = obj
  1125. @property
  1126. def id(self):
  1127. return self._obj.get("name")
  1128. @property
  1129. def name(self):
  1130. """Get this object's name."""
  1131. return self.id
  1132. @property
  1133. def size(self):
  1134. return self._obj.get("bytes")
  1135. @property
  1136. def last_modified(self):
  1137. return self._obj.get("last_modified")
  1138. def iter_content(self):
  1139. """Returns this object's content as an iterable."""
  1140. _, content = self._provider.swift.get_object(
  1141. self.cbcontainer.name, self.name, resp_chunk_size=65536)
  1142. return content
  1143. def upload(self, data):
  1144. """
  1145. Set the contents of this object to the data read from the source
  1146. string.
  1147. .. warning:: Will fail if the data is larger than 5 Gig.
  1148. """
  1149. self._provider.swift.put_object(self.cbcontainer.name, self.name,
  1150. data)
  1151. def upload_from_file(self, path):
  1152. """
  1153. Stores the contents of the file pointed by the ``path`` variable.
  1154. If the file is bigger than 5 Gig, it will be broken into segments.
  1155. :type path: ``str``
  1156. :param path: Absolute path to the file to be uploaded to Swift.
  1157. :rtype: ``bool``
  1158. :return: ``True`` if successful, ``False`` if not.
  1159. .. note::
  1160. * The size of the segments chosen (or any of the other upload
  1161. options) is not under user control.
  1162. * If called this method will remap the
  1163. ``swiftclient.service.get_conn`` factory method to
  1164. ``self._provider._connect_swift``
  1165. .. seealso:: https://github.com/CloudVE/cloudbridge/issues/35#issuecomment-297629661 # noqa
  1166. """
  1167. upload_options = {}
  1168. if 'segment_size' not in upload_options:
  1169. if os.path.getsize(path) >= FIVE_GIG:
  1170. upload_options['segment_size'] = FIVE_GIG
  1171. # remap the swift service's connection factory method
  1172. # pylint:disable=protected-access
  1173. swiftclient.service.get_conn = self._provider._connect_swift
  1174. result = True
  1175. with SwiftService() as swift:
  1176. upload_object = SwiftUploadObject(path, object_name=self.name)
  1177. for up_res in swift.upload(self.cbcontainer.name,
  1178. [upload_object, ],
  1179. options=upload_options):
  1180. result = result and up_res['success']
  1181. return result
  1182. def delete(self):
  1183. """
  1184. Delete this object.
  1185. :rtype: ``bool``
  1186. :return: True if successful
  1187. .. note:: If called this method will remap the
  1188. ``swiftclient.service.get_conn`` factory method to
  1189. ``self._provider._connect_swift``
  1190. """
  1191. # remap the swift service's connection factory method
  1192. # pylint:disable=protected-access
  1193. swiftclient.service.get_conn = self._provider._connect_swift
  1194. result = True
  1195. with SwiftService() as swift:
  1196. for del_res in swift.delete(self.cbcontainer.name, [self.name, ]):
  1197. result = result and del_res['success']
  1198. return result
  1199. def generate_url(self, expires_in):
  1200. # Set a temp url key on the object (http://bit.ly/2NBiXGD)
  1201. temp_url_key = "cloudbridge-tmp-url-key"
  1202. self._provider.swift.post_account(
  1203. headers={"x-account-meta-temp-url-key": temp_url_key})
  1204. base_url = urlparse(self._provider.swift.get_service_auth()[0])
  1205. access_point = "{0}://{1}".format(base_url.scheme, base_url.netloc)
  1206. url_path = "/".join([base_url.path, self.cbcontainer.name, self.name])
  1207. return urljoin(access_point, generate_temp_url(url_path, expires_in,
  1208. temp_url_key, 'GET'))
  1209. def refresh(self):
  1210. self._obj = self.cbcontainer.objects.get(self.id)._obj
  1211. class OpenStackBucket(BaseBucket):
  1212. def __init__(self, provider, bucket):
  1213. super(OpenStackBucket, self).__init__(provider)
  1214. self._bucket = bucket
  1215. self._object_container = OpenStackBucketContainer(provider, self)
  1216. @property
  1217. def id(self):
  1218. return self._bucket.get("name")
  1219. @property
  1220. def name(self):
  1221. return self.id
  1222. @property
  1223. def objects(self):
  1224. return self._object_container
  1225. def delete(self, delete_contents=False):
  1226. self._provider.swift.delete_container(self.name)
  1227. class OpenStackBucketContainer(BaseBucketContainer):
  1228. def __init__(self, provider, bucket):
  1229. super(OpenStackBucketContainer, self).__init__(provider, bucket)
  1230. def get(self, name):
  1231. """
  1232. Retrieve a given object from this bucket.
  1233. """
  1234. _, object_list = self._provider.swift.get_container(
  1235. self.bucket.name, prefix=name)
  1236. if object_list:
  1237. # Swift always returns a reference for the container first,
  1238. # followed by a list containing references to objects.
  1239. # Looping through list of objects
  1240. for ob in object_list[1]:
  1241. if ob.get('name') == name:
  1242. return OpenStackBucketObject(self._provider,
  1243. self.bucket,
  1244. ob)
  1245. return None
  1246. def list(self, limit=None, marker=None, prefix=None):
  1247. """
  1248. List all objects within this bucket.
  1249. :rtype: BucketObject
  1250. :return: List of all available BucketObjects within this bucket.
  1251. """
  1252. _, object_list = self._provider.swift.get_container(
  1253. self.bucket.name,
  1254. limit=oshelpers.os_result_limit(self._provider, limit),
  1255. marker=marker, prefix=prefix)
  1256. cb_objects = [OpenStackBucketObject(
  1257. self._provider, self.bucket, obj) for obj in object_list]
  1258. return oshelpers.to_server_paged_list(
  1259. self._provider,
  1260. cb_objects,
  1261. limit)
  1262. def find(self, **kwargs):
  1263. obj_list = self
  1264. filters = ['name']
  1265. matches = cb_helpers.generic_find(filters, kwargs, obj_list)
  1266. return ClientPagedResultList(self._provider, list(matches))
  1267. def create(self, object_name):
  1268. self._provider.swift.put_object(self.bucket.name, object_name, None)
  1269. return self.get(object_name)