Kcli Provider Development

kcli Provider Development

Provider Architecture

Providers are located in kvirt/providers/ as subdirectories. Each provider implements the interface defined in kvirt/providers/sampleprovider.py (class Kbase).

Required Implementation Steps

1. Create Provider Directory

kvirt/providers/yourprovider/
├── __init__.py      # Contains your Kyourprovider class
└── (optional helpers)

2. Implement the Provider Class

Your class must:

• Set self.conn attribute in __init__ (set to None if backend unreachable)
• Set self.debug from the debug parameter
• Return standardized response dicts from methods

Return Value Pattern:

# Success
return {'result': 'success'}

# Failure
return {'result': 'failure', 'reason': "VM %s not found" % name}

3. Core Methods to Implement

VM Lifecycle (required):

• create() - Create VM with all parameters (cpus, memory, disks, nets, etc.)
• start(name) - Start VM
• stop(name, soft=False) - Stop VM
• restart(name) - Restart VM (default calls start)
• delete(name, snapshots=False, keep_disks=False) - Delete VM
• list() - Return list of [name, state, ip, source, plan, profile]
• info(name, output, fields, values, vm, debug) - Return VM details dict
• exists(name) - Check if VM exists
• status(name) - Return VM status
• ip(name) - Return IP string
• clone(old, new, full=False, start=False) - Clone VM
• export(name, image=None) - Export VM as image
• console(name, tunnel, tunnelhost, tunnelport, tunneluser, web) - Graphical console
• serialconsole(name, web) - Serial console

Storage:

• create_pool(name, poolpath, pooltype, user, thinpool)
• delete_pool(name, full)
• list_pools() - Return list of pool names
• get_pool_path(pool) - Get pool path
• add_disk(name, size, pool, thin, image, shareable, existing, interface, novm, overrides)
• delete_disk(name, diskname, pool, novm)
• create_disk(name, size, pool, thin, image) - Create standalone disk
• list_disks() - Return dict {'diskname': {'pool': poolname, 'path': name}}
• disk_exists(pool, name) - Check if disk exists
• detach_disks(name) - Detach all disks from VM

Networking:

• create_network(name, cidr, dhcp, nat, domain, plan, overrides)
• delete_network(name, cidr, force)
• update_network(name, dhcp, nat, domain, plan, overrides)
• list_networks() - Return dict of networks
• info_network(name) - Get network info
• net_exists(name) - Check if network exists
• network_ports(name) - List ports on network
• add_nic(name, network, model)
• delete_nic(name, interface)
• update_nic(name, index, network) - Update NIC

Subnets (cloud providers):

• create_subnet(name, cidr, dhcp, nat, domain, plan, overrides)
• delete_subnet(name, force)
• update_subnet(name, overrides)
• list_subnets() - Return subnet dict
• info_subnet(name) - Get subnet info

Images:

• volumes(iso=False, extended=False) - List available images
• add_image(url, pool, short, cmds, name, size, convert)
• delete_image(image, pool)

Snapshots:

• create_snapshot(name, base) - Create snapshot
• delete_snapshot(name, base) - Delete snapshot
• list_snapshots(base) - List snapshots (returns list)
• revert_snapshot(name, base) - Revert to snapshot

Update Operations:

• update_metadata(name, metatype, metavalue, append)
• update_memory(name, memory)
• update_cpus(name, numcpus)
• update_start(name, start) - Set autostart
• update_information(name, information) - Update info metadata
• update_iso(name, iso) - Change attached ISO
• update_flavor(name, flavor) - Change VM flavor

Buckets (object storage):

• create_bucket(bucket, public) - Create storage bucket
• delete_bucket(bucket) - Delete bucket
• list_buckets() - List all buckets
• list_bucketfiles(bucket) - List files in bucket
• upload_to_bucket(bucket, path, overrides, temp_url, public)
• download_from_bucket(bucket, path)
• delete_from_bucket(bucket, path)

Security Groups (cloud providers):

• create_security_group(name, overrides)
• delete_security_group(name)
• update_security_group(name, overrides)
• list_security_groups(network) - List security groups

DNS:

• reserve_dns(name, nets, domain, ip, alias, force, primary, instanceid)
• list_dns_zones() - List DNS zones
• dnsinfo(name) - Return (dnsclient, domain) for VM

Other:

• close() - Clean up connection
• info_host() - Return host info dict
• vm_ports(name) - List ports on VM
• list_flavors() - Return [[name, numcpus, memory], ...] if platform supports flavors