A3 Primitives

Primitives are the software components of the CloudCIX IaaS platform that manage the hardware on which the infrastructure is built.

There are three critical properties of all primitives. These properties are required to ensure the platform produces reliable and consistent results.

• Primitives are (usually) Idempotent

There is (usually) no difference in outcome between calling a primitive once and calling it multiple times.

For example, if a VM has 4GB of RAM and a primitive call is to increase that to 8GB. If you call the primitive twice, then the resulting RAM should remain at 8GB. Thus, a primitive to increase RAM by an amount does not exist but a primitive to change RAM to a certain amount exists.

Some primitives, such as snapshot_kvm build, create a new snapshot instance every time the primitive is called.

• Non self interference

A primitive will not change that which has already been instanciated by another instance of the same primitive being called.

For example, if a primitive adds a new interface to a VM, it does not delete or modify an existing interface to that VM.

• Non interference with other primitives

A primitive will not change that which was created by another primitive.

If different primitives use the same underlying technology then there must be a mechanism to separate their domains. For example if two different primitives use nftables (perhaps one creating a firewall and the other a VPN tunnel) then each should not interfere with configuration applied by the other.

Currently CloudCIX supports 35 primitives:

• PodNet Primitives

  1. firewall_main (build, read)

  2. net_main (build, quiesce, restart, read)

  3. vpns2s_main (build, read)

  4. bridge_main (build, read)

  5. default_firewall_ns (build, read, scrub)

  6. project_firewall_ns (build, read, scrub)

  7. nat_firewall_ns (build, read, scrub)

  8. geo_a_firewall_ns (build, read, scrub)

  9. geo_b_firewall_ns (build, read, scrub)

  10. vpns2s_firewall_ns (build, read, scrub)

  11. vpndyn_firewall_ns (build, read, scrub)

  12. ns (build, read, scrub)

  13. network_ns (build, read, scrub)

  14. bridgeif_ns (build, read, scrub)

  15. vlanif_ns (build, read, scrub)

  16. vpnif_ns (build, read, scrub)

  17. route_ns (build, read, scrub)

  18. vpns2s_ns (build, read, scrub)

  19. vpndyn_ns (build, read, scrub)

• Compute LXD Primitives

  20. lxd (build, quiesce, restart, read, scrub)

  21. bridge_lxd (build, read, scrub)

  22. storage_lxd (build, update, read, scrub)

  23. cpu_lxd (update)

  24. ram_lxd (update)

  25. backup_lxd (build, read, scrub)

  26. snapshot_lxd (build, update, read, scrub)

  27. gpu_lxd (build, read, scrub)

  28. rbd (build, update, read, scrub)

  29. rbd_lxd (build, read, scrub)

• Compute HyperV Primitives

  30. hyperv (build, quiesce, restart, read, scrub)

  31. storage_hyperv (build, update, read, scrub)

  32. cpu_hyperv (update)

  33. ram_hyperv (update)

  34. backup_hyperv (build, read, scrub)

  35. snapshot_hyperv (build, update, read, scrub)

The config_filepath is an optional parameter, if it is not provided it will default to the current path where the primitives project is installed.

Drivers and Primitives

Driver	Primitvies
1 virtual_router	ns bridgeif_ns vlanif_ns network_ns route_ns route_main default_firewallns
2 firewall	project_firewall_ns
3 geofilter	geo_a_firewall_ns geo_b_firewall_ns
4 vpns2s	vpnif_ns vpns2s_firewall_ns vpns2s_ns
5 vpndyn	vpnif_ns vpndyn_firewall_ns vpndyn_ns
6 lxc	network_ns nat_firewall_ns bridge_lxd lxd cpu_lxd ram_lxd
7 vm_hyperv	network_ns nat_firewall_ns hyperv cpu_hyperv ram_hyperv
8 storage_lxc	storage_lxd
9 storage_hyperv	storage_hyperv
10 snapshot_lxc	snapshot_lxd
11 snapshot_hyperv	snapshot_hyperv
12 backup_lxc	backup_lxd
13 backup_hyperv	backup_hyperv
14 ceph	rbd rbd_lxd
15 gpu	gpu_lxd
16 virtual_router_phantom
17 vm_phantom