Statistics
| Branch: | Tag: | Revision:

root / api / servers.py @ 9e98ba3c

History | View | Annotate | Download (18.7 kB)

1
# Copyright 2011 GRNET S.A. All rights reserved.
2
# 
3
# Redistribution and use in source and binary forms, with or
4
# without modification, are permitted provided that the following
5
# conditions are met:
6
# 
7
#   1. Redistributions of source code must retain the above
8
#      copyright notice, this list of conditions and the following
9
#      disclaimer.
10
# 
11
#   2. Redistributions in binary form must reproduce the above
12
#      copyright notice, this list of conditions and the following
13
#      disclaimer in the documentation and/or other materials
14
#      provided with the distribution.
15
# 
16
# THIS SOFTWARE IS PROVIDED BY GRNET S.A. ``AS IS'' AND ANY EXPRESS
17
# OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
18
# WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
19
# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL GRNET S.A OR
20
# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
21
# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
22
# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
23
# USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
24
# AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25
# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
26
# ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
27
# POSSIBILITY OF SUCH DAMAGE.
28
# 
29
# The views and conclusions contained in the software and
30
# documentation are those of the authors and should not be
31
# interpreted as representing official policies, either expressed
32
# or implied, of GRNET S.A.
33

    
34
from base64 import b64decode
35

    
36
from django.conf import settings
37
from django.conf.urls.defaults import patterns
38
from django.http import HttpResponse
39
from django.template.loader import render_to_string
40
from django.utils import simplejson as json
41

    
42
from synnefo.api import faults, util
43
from synnefo.api.actions import server_actions
44
from synnefo.api.common import method_not_allowed
45
from synnefo.db.models import VirtualMachine, VirtualMachineMetadata
46
from synnefo.logic.backend import create_instance, delete_instance
47
from synnefo.logic.utils import get_rsapi_state
48
from synnefo.util.rapi import GanetiApiError
49
from synnefo.util.log import getLogger
50

    
51

    
52
log = getLogger('synnefo.api')
53

    
54
urlpatterns = patterns('synnefo.api.servers',
55
    (r'^(?:/|.json|.xml)?$', 'demux'),
56
    (r'^/detail(?:.json|.xml)?$', 'list_servers', {'detail': True}),
57
    (r'^/(\d+)(?:.json|.xml)?$', 'server_demux'),
58
    (r'^/(\d+)/action(?:.json|.xml)?$', 'server_action'),
59
    (r'^/(\d+)/ips(?:.json|.xml)?$', 'list_addresses'),
60
    (r'^/(\d+)/ips/(.+?)(?:.json|.xml)?$', 'list_addresses_by_network'),
61
    (r'^/(\d+)/meta(?:.json|.xml)?$', 'metadata_demux'),
62
    (r'^/(\d+)/meta/(.+?)(?:.json|.xml)?$', 'metadata_item_demux'),
63
    (r'^/(\d+)/stats(?:.json|.xml)?$', 'server_stats'),
64
)
65

    
66

    
67
def demux(request):
68
    if request.method == 'GET':
69
        return list_servers(request)
70
    elif request.method == 'POST':
71
        return create_server(request)
72
    else:
73
        return method_not_allowed(request)
74

    
75

    
76
def server_demux(request, server_id):
77
    if request.method == 'GET':
78
        return get_server_details(request, server_id)
79
    elif request.method == 'PUT':
80
        return update_server_name(request, server_id)
81
    elif request.method == 'DELETE':
82
        return delete_server(request, server_id)
83
    else:
84
        return method_not_allowed(request)
85

    
86

    
87
def metadata_demux(request, server_id):
88
    if request.method == 'GET':
89
        return list_metadata(request, server_id)
90
    elif request.method == 'POST':
91
        return update_metadata(request, server_id)
92
    else:
93
        return method_not_allowed(request)
94

    
95

    
96
def metadata_item_demux(request, server_id, key):
97
    if request.method == 'GET':
98
        return get_metadata_item(request, server_id, key)
99
    elif request.method == 'PUT':
100
        return create_metadata_item(request, server_id, key)
101
    elif request.method == 'DELETE':
102
        return delete_metadata_item(request, server_id, key)
103
    else:
104
        return method_not_allowed(request)
105

    
106

    
107
def nic_to_dict(nic):
108
    network = nic.network
109
    network_id = str(network.id) if not network.public else 'public'
110
    d = {'id': network_id, 'name': network.name, 'mac': nic.mac}
111
    if nic.firewall_profile:
112
        d['firewallProfile'] = nic.firewall_profile
113
    if nic.ipv4 or nic.ipv6:
114
        d['values'] = []
115
        if nic.ipv4:
116
            d['values'].append({'version': 4, 'addr': nic.ipv4})
117
        if nic.ipv6:
118
            d['values'].append({'version': 6, 'addr': nic.ipv6})
119
    return d
120

    
121

    
122
def vm_to_dict(vm, detail=False):
123
    d = dict(id=vm.id, name=vm.name)
124
    if detail:
125
        d['status'] = get_rsapi_state(vm)
126
        d['progress'] = 100 if get_rsapi_state(vm) == 'ACTIVE' \
127
                        else vm.buildpercentage
128
        d['hostId'] = vm.hostid
129
        d['updated'] = util.isoformat(vm.updated)
130
        d['created'] = util.isoformat(vm.created)
131
        d['flavorRef'] = vm.flavor.id
132
        d['imageRef'] = vm.sourceimage.id
133
        
134
        metadata = dict((m.meta_key, m.meta_value) for m in vm.metadata.all())
135
        if metadata:
136
            d['metadata'] = {'values': metadata}
137

    
138
        addresses = [nic_to_dict(nic) for nic in vm.nics.all()]
139
        if addresses:
140
            d['addresses'] = {'values': addresses}
141
    return d
142

    
143

    
144
def render_server(request, server, status=200):
145
    if request.serialization == 'xml':
146
        data = render_to_string('server.xml', {
147
            'server': server,
148
            'is_root': True})
149
    else:
150
        data = json.dumps({'server': server})
151
    return HttpResponse(data, status=status)
152

    
153

    
154
@util.api_method('GET')
155
def list_servers(request, detail=False):
156
    # Normal Response Codes: 200, 203
157
    # Error Response Codes: computeFault (400, 500),
158
    #                       serviceUnavailable (503),
159
    #                       unauthorized (401),
160
    #                       badRequest (400),
161
    #                       overLimit (413)
162
    
163
    log.debug('list_servers detail=%s', detail)
164
    user_vms = VirtualMachine.objects.filter(owner=request.user)
165
    since = util.isoparse(request.GET.get('changes-since'))
166
    
167
    if since:
168
        user_vms = user_vms.filter(updated__gte=since)
169
        if not user_vms:
170
            return HttpResponse(status=304)
171
    else:
172
        user_vms = user_vms.filter(deleted=False)
173
    
174
    servers = [vm_to_dict(server, detail) for server in user_vms]
175

    
176
    if request.serialization == 'xml':
177
        data = render_to_string('list_servers.xml', {
178
            'servers': servers,
179
            'detail': detail})
180
    else:
181
        data = json.dumps({'servers': {'values': servers}})
182

    
183
    return HttpResponse(data, status=200)
184

    
185

    
186
@util.api_method('POST')
187
def create_server(request):
188
    # Normal Response Code: 202
189
    # Error Response Codes: computeFault (400, 500),
190
    #                       serviceUnavailable (503),
191
    #                       unauthorized (401),
192
    #                       badMediaType(415),
193
    #                       itemNotFound (404),
194
    #                       badRequest (400),
195
    #                       serverCapacityUnavailable (503),
196
    #                       overLimit (413)
197

    
198
    req = util.get_request_dict(request)
199
    log.debug('create_server %s', req)
200
    owner = request.user
201
    
202
    try:
203
        server = req['server']
204
        name = server['name']
205
        metadata = server.get('metadata', {})
206
        assert isinstance(metadata, dict)
207
        image_id = server['imageRef']
208
        flavor_id = server['flavorRef']
209
        personality = server.get('personality', [])
210
        assert isinstance(personality, list)
211
    except (KeyError, AssertionError):
212
        raise faults.BadRequest("Malformed request")
213
    
214
    if len(personality) > settings.MAX_PERSONALITY:
215
        raise faults.OverLimit("Maximum number of personalities exceeded")
216
    
217
    for p in personality:
218
        try:
219
            assert isinstance(p, dict)
220
            assert set(p.keys()) == set(['path', 'contents'])
221
            contents = p['contents']
222
            if len(contents) > settings.MAX_PERSONALITY_SIZE:
223
                # No need to decode if contents already exceed limit
224
                raise faults.OverLimit("Maximum size of personality exceeded")
225
            if len(b64decode(contents)) > settings.MAX_PERSONALITY_SIZE:
226
                raise faults.OverLimit("Maximum size of personality exceeded")
227
        except AssertionError:
228
            raise faults.BadRequest("Malformed personality in request")
229
    
230
    image = util.get_image(image_id, owner)
231
    flavor = util.get_flavor(flavor_id)
232
    password = util.random_password()
233
    
234
    count = VirtualMachine.objects.filter(owner=owner, deleted=False).count()
235
    if count >= settings.MAX_VMS_PER_USER:
236
        raise faults.OverLimit("Server count limit exceeded for your account.")
237
    
238
    # We must save the VM instance now, so that it gets a valid vm.backend_id.
239
    vm = VirtualMachine.objects.create(
240
        name=name,
241
        owner=owner,
242
        sourceimage=image,
243
        flavor=flavor)
244
    
245
    try:
246
        create_instance(vm, flavor, image, password, personality)
247
    except GanetiApiError:
248
        vm.delete()
249
        raise
250

    
251
    for key, val in metadata.items():
252
        VirtualMachineMetadata.objects.create(
253
            meta_key=key,
254
            meta_value=val,
255
            vm=vm)
256
    
257
    log.info('User %d created vm with %s cpus, %s ram and %s storage',
258
                    owner.id, flavor.cpu, flavor.ram, flavor.disk)
259
    
260
    server = vm_to_dict(vm, detail=True)
261
    server['status'] = 'BUILD'
262
    server['adminPass'] = password
263
    return render_server(request, server, status=202)
264

    
265

    
266
@util.api_method('GET')
267
def get_server_details(request, server_id):
268
    # Normal Response Codes: 200, 203
269
    # Error Response Codes: computeFault (400, 500),
270
    #                       serviceUnavailable (503),
271
    #                       unauthorized (401),
272
    #                       badRequest (400),
273
    #                       itemNotFound (404),
274
    #                       overLimit (413)
275
    
276
    log.debug('get_server_details %s', server_id)
277
    vm = util.get_vm(server_id, request.user)
278
    server = vm_to_dict(vm, detail=True)
279
    return render_server(request, server)
280

    
281

    
282
@util.api_method('PUT')
283
def update_server_name(request, server_id):
284
    # Normal Response Code: 204
285
    # Error Response Codes: computeFault (400, 500),
286
    #                       serviceUnavailable (503),
287
    #                       unauthorized (401),
288
    #                       badRequest (400),
289
    #                       badMediaType(415),
290
    #                       itemNotFound (404),
291
    #                       buildInProgress (409),
292
    #                       overLimit (413)
293

    
294
    req = util.get_request_dict(request)
295
    log.debug('update_server_name %s %s', server_id, req)
296
    
297
    try:
298
        name = req['server']['name']
299
    except (TypeError, KeyError):
300
        raise faults.BadRequest("Malformed request")
301

    
302
    vm = util.get_vm(server_id, request.user)
303
    vm.name = name
304
    vm.save()
305

    
306
    return HttpResponse(status=204)
307

    
308

    
309
@util.api_method('DELETE')
310
def delete_server(request, server_id):
311
    # Normal Response Codes: 204
312
    # Error Response Codes: computeFault (400, 500),
313
    #                       serviceUnavailable (503),
314
    #                       unauthorized (401),
315
    #                       itemNotFound (404),
316
    #                       unauthorized (401),
317
    #                       buildInProgress (409),
318
    #                       overLimit (413)
319
    
320
    log.debug('delete_server %s', server_id)
321
    vm = util.get_vm(server_id, request.user)
322
    delete_instance(vm)
323
    return HttpResponse(status=204)
324

    
325

    
326
@util.api_method('POST')
327
def server_action(request, server_id):
328
    req = util.get_request_dict(request)
329
    log.debug('server_action %s %s', server_id, req)
330
    vm = util.get_vm(server_id, request.user)
331
    if len(req) != 1:
332
        raise faults.BadRequest("Malformed request")
333

    
334
    key = req.keys()[0]
335
    val = req[key]
336

    
337
    try:
338
        assert isinstance(val, dict)
339
        return server_actions[key](request, vm, req[key])
340
    except KeyError:
341
        raise faults.BadRequest("Unknown action")
342
    except AssertionError:
343
        raise faults.BadRequest("Invalid argument")
344

    
345

    
346
@util.api_method('GET')
347
def list_addresses(request, server_id):
348
    # Normal Response Codes: 200, 203
349
    # Error Response Codes: computeFault (400, 500),
350
    #                       serviceUnavailable (503),
351
    #                       unauthorized (401),
352
    #                       badRequest (400),
353
    #                       overLimit (413)
354
    
355
    log.debug('list_addresses %s', server_id)
356
    vm = util.get_vm(server_id, request.user)
357
    addresses = [nic_to_dict(nic) for nic in vm.nics.all()]
358
    
359
    if request.serialization == 'xml':
360
        data = render_to_string('list_addresses.xml', {'addresses': addresses})
361
    else:
362
        data = json.dumps({'addresses': {'values': addresses}})
363

    
364
    return HttpResponse(data, status=200)
365

    
366

    
367
@util.api_method('GET')
368
def list_addresses_by_network(request, server_id, network_id):
369
    # Normal Response Codes: 200, 203
370
    # Error Response Codes: computeFault (400, 500),
371
    #                       serviceUnavailable (503),
372
    #                       unauthorized (401),
373
    #                       badRequest (400),
374
    #                       itemNotFound (404),
375
    #                       overLimit (413)
376
    
377
    log.debug('list_addresses_by_network %s %s', server_id, network_id)
378
    owner = request.user
379
    machine = util.get_vm(server_id, owner)
380
    network = util.get_network(network_id, owner)
381
    nic = util.get_nic(machine, network)
382
    address = nic_to_dict(nic)
383
    
384
    if request.serialization == 'xml':
385
        data = render_to_string('address.xml', {'address': address})
386
    else:
387
        data = json.dumps({'network': address})
388

    
389
    return HttpResponse(data, status=200)
390

    
391

    
392
@util.api_method('GET')
393
def list_metadata(request, server_id):
394
    # Normal Response Codes: 200, 203
395
    # Error Response Codes: computeFault (400, 500),
396
    #                       serviceUnavailable (503),
397
    #                       unauthorized (401),
398
    #                       badRequest (400),
399
    #                       overLimit (413)
400
    
401
    log.debug('list_server_metadata %s', server_id)
402
    vm = util.get_vm(server_id, request.user)
403
    metadata = dict((m.meta_key, m.meta_value) for m in vm.metadata.all())
404
    return util.render_metadata(request, metadata, use_values=True, status=200)
405

    
406

    
407
@util.api_method('POST')
408
def update_metadata(request, server_id):
409
    # Normal Response Code: 201
410
    # Error Response Codes: computeFault (400, 500),
411
    #                       serviceUnavailable (503),
412
    #                       unauthorized (401),
413
    #                       badRequest (400),
414
    #                       buildInProgress (409),
415
    #                       badMediaType(415),
416
    #                       overLimit (413)
417
    
418
    req = util.get_request_dict(request)
419
    log.debug('update_server_metadata %s %s', server_id, req)
420
    vm = util.get_vm(server_id, request.user)
421
    try:
422
        metadata = req['metadata']
423
        assert isinstance(metadata, dict)
424
    except (KeyError, AssertionError):
425
        raise faults.BadRequest("Malformed request")
426
    
427
    for key, val in metadata.items():
428
        meta, created = vm.metadata.get_or_create(meta_key=key)
429
        meta.meta_value = val
430
        meta.save()
431
    
432
    vm.save()
433
    vm_meta = dict((m.meta_key, m.meta_value) for m in vm.metadata.all())
434
    return util.render_metadata(request, vm_meta, status=201)
435

    
436

    
437
@util.api_method('GET')
438
def get_metadata_item(request, server_id, key):
439
    # Normal Response Codes: 200, 203
440
    # Error Response Codes: computeFault (400, 500),
441
    #                       serviceUnavailable (503),
442
    #                       unauthorized (401),
443
    #                       itemNotFound (404),
444
    #                       badRequest (400),
445
    #                       overLimit (413)
446
    
447
    log.debug('get_server_metadata_item %s %s', server_id, key)
448
    vm = util.get_vm(server_id, request.user)
449
    meta = util.get_vm_meta(vm, key)
450
    return util.render_meta(request, meta, status=200)
451

    
452

    
453
@util.api_method('PUT')
454
def create_metadata_item(request, server_id, key):
455
    # Normal Response Code: 201
456
    # Error Response Codes: computeFault (400, 500),
457
    #                       serviceUnavailable (503),
458
    #                       unauthorized (401),
459
    #                       itemNotFound (404),
460
    #                       badRequest (400),
461
    #                       buildInProgress (409),
462
    #                       badMediaType(415),
463
    #                       overLimit (413)
464
    
465
    req = util.get_request_dict(request)
466
    log.debug('create_server_metadata_item %s %s %s', server_id, key, req)
467
    vm = util.get_vm(server_id, request.user)
468
    try:
469
        metadict = req['meta']
470
        assert isinstance(metadict, dict)
471
        assert len(metadict) == 1
472
        assert key in metadict
473
    except (KeyError, AssertionError):
474
        raise faults.BadRequest("Malformed request")
475
    
476
    meta, created = VirtualMachineMetadata.objects.get_or_create(
477
        meta_key=key,
478
        vm=vm)
479
    
480
    meta.meta_value = metadict[key]
481
    meta.save()
482
    vm.save()
483
    return util.render_meta(request, meta, status=201)
484

    
485

    
486
@util.api_method('DELETE')
487
def delete_metadata_item(request, server_id, key):
488
    # Normal Response Code: 204
489
    # Error Response Codes: computeFault (400, 500),
490
    #                       serviceUnavailable (503),
491
    #                       unauthorized (401),
492
    #                       itemNotFound (404),
493
    #                       badRequest (400),
494
    #                       buildInProgress (409),
495
    #                       badMediaType(415),
496
    #                       overLimit (413),
497
    
498
    log.debug('delete_server_metadata_item %s %s', server_id, key)
499
    vm = util.get_vm(server_id, request.user)
500
    meta = util.get_vm_meta(vm, key)
501
    meta.delete()
502
    vm.save()
503
    return HttpResponse(status=204)
504

    
505

    
506
@util.api_method('GET')
507
def server_stats(request, server_id):
508
    # Normal Response Codes: 200
509
    # Error Response Codes: computeFault (400, 500),
510
    #                       serviceUnavailable (503),
511
    #                       unauthorized (401),
512
    #                       badRequest (400),
513
    #                       itemNotFound (404),
514
    #                       overLimit (413)
515
    
516
    log.debug('server_stats %s', server_id)
517
    vm = util.get_vm(server_id, request.user)
518
    #secret = util.encrypt(vm.backend_id)
519
    secret = vm.backend_id      # XXX disable backend id encryption
520
    
521
    stats = {
522
        'serverRef': vm.id,
523
        'refresh': settings.STATS_REFRESH_PERIOD,
524
        'cpuBar': settings.CPU_BAR_GRAPH_URL % secret,
525
        'cpuTimeSeries': settings.CPU_TIMESERIES_GRAPH_URL % secret,
526
        'netBar': settings.NET_BAR_GRAPH_URL % secret,
527
        'netTimeSeries': settings.NET_TIMESERIES_GRAPH_URL % secret}
528
    
529
    if request.serialization == 'xml':
530
        data = render_to_string('server_stats.xml', stats)
531
    else:
532
        data = json.dumps({'stats': stats})
533

    
534
    return HttpResponse(data, status=200)