pvc/docs/about.md

64 lines
8.4 KiB
Markdown
Raw Normal View History

2019-03-14 20:23:39 -04:00
# About the Parallel Virtual Cluster suite
2019-07-06 15:20:35 -04:00
## Project Goals and Philosophy
2019-03-16 00:43:11 -04:00
2019-07-06 15:20:35 -04:00
Server management and system administration have changed significantly in the last decade. Computing as a resource is here, and software-defined is the norm. Gone are the days of pet servers, of tweaking configuration files by hand, and of painstakingly installing from ISO images in 52x CD-ROM drives. This is a brave new world.
2019-03-16 00:43:11 -04:00
2019-07-06 15:20:35 -04:00
As part of this trend, the rise of IaaS (Infrastructure as a Service) has created an entirely new way for administrators and, increasingly, developers, to interact with servers. They need to be able to provision virtual machines easily and quickly, to ensure those virtual machines are reliable and consistent, and to avoid downtime wherever possible.
2019-03-16 00:43:11 -04:00
2019-07-06 15:20:35 -04:00
However, the state of the Free Software, virtual management ecosystem in 2019 is quite dissapointing. On the one hand are the giant, IaaS products like OpenStack and CloudStack. These are massive pieces of software, featuring dozens of interlocking parts, designed for massive clusters and public cloud deployments. They're great for a "hyperscale" provider, a large-scale SaaS/IaaS provider, or an enterprise. But they're not designed for small teams or small clusters. On the other hand, tools like Proxmox, oVirt, and even good old fashioned shell scripts are barely scalable, are showing their age, and have become increasily unweildy for advanced usecases - great for one server, not so great for 9 in a highly-available cluster. Not to mention the constant attempts to monitize by throwing features behind Enterprise subscriptions. In short, there is a massive gap between the old-style, pet-based virtualization and the modern, large-scale, IaaS-type virtualization.
2019-03-16 00:43:11 -04:00
2019-07-06 15:20:35 -04:00
PVC aims to bridge this gap. As a Python 3-based, fully-Free Software, scalable, and redundant private "cloud" that isn't afraid to say it's for small clusters, PVC is able to provide the simple, easy-to-use, small cluster you need today, with minimal administrator work, while being able to scale as your system grows, supporting hundreds or thousands of VMs across dozens of nodes. High availability is baked right into the core software, giving you piece of mind about your cluster, and ensuring that your systems keep running no matter what happens. And the interface couldn't be easier - a straightforward Click-based CLI and a Flask-based HTTP API provide access to the cluster for you to manage, either directly or though scripts or WebUIs. And since everything is Free Software, you can always inspect it, customize it to your usecase, add features, and contribute back to the community if you so choose.
2019-03-16 00:43:11 -04:00
2019-07-06 15:20:35 -04:00
PVC provides all the features you'd expect of a "cloud" system - easy management of VMs, including live migration between nodes for maximum uptime; virtual networking support using either vLANs or EVPN-based VXLAN; shared, redundant, object-based storage using Ceph, and a convenient API interface for building your own interfaces. It is able to do this without being excessively complex, and without making sacrifices for legacy ideas.
2019-03-14 20:23:39 -04:00
2019-07-06 15:20:35 -04:00
If you need to run virtual machines, and don't have the time to learn the Stacks or the money to spend on VMWare or Nutanix, PVC might be just what you're looking for.
2019-03-14 20:23:39 -04:00
2019-07-06 15:20:35 -04:00
## Cluster Architecture
2019-03-14 20:23:39 -04:00
2019-07-06 15:20:35 -04:00
A PVC cluster is based around "nodes", which are physical servers on which the various daemons, storage, networks, and virtual machines run. Each node is self-contained; it is able to perform any and all cluster functions if needed, and there are no segmentations of function between different types of physical hosts.
2019-03-14 20:23:39 -04:00
2019-07-06 15:20:35 -04:00
A limited number of nodes, called "coordinators", are statically configured to provide additional services for the cluster. All databases for instance run on the coordinators, but not other nodes. This prevents any issues with scaling database clusters across dozens of hosts, while still retaining maximum redundancy. In a standard configuration, 3 or 5 nodes are designated as coordinators, and additional nodes connect to the coordinators for database access where required. For quorum purposes, there should always be an odd number of coordinators, and exceeding 5 is likely not required even for large clusters.
2019-03-14 20:23:39 -04:00
2019-07-06 15:20:35 -04:00
The primary database for PVC is Zookeeper, which is a highly-available key-value store designed with consistency in mind. Each node connects to the Zookeeper cluster running on the coordinators to send and receive data from the rest of the cluster. The clients also interface with this Zookeeper cluster to configure and obtain state about the various objects in the cluster. This database is the central authority for all nodes.
2019-03-14 20:23:39 -04:00
2019-07-06 15:20:35 -04:00
Nodes are networked together via at least 3 different networks, set during bootstrap. The first is the "upstream" network, which provides upstream access for the nodes, for instance Internet connectivity, sending routes to client networks to upstream routers, etc. This should usually be a private/firewalled network to prevent unauthorized access to the cluster. The second is the "cluster" network, which is a private RFC1918 network that is unrouted and that nodes use to communicate between one another for Zookeeper access, Libvirt migrations, EVPN VXLAN tunnels, etc. The third is the "storage" network, which is used by the Ceph storage cluster for inter-OSD communication, allowing it to be separate from the main cluster network for maximum performance flexibility.
2019-03-14 20:23:39 -04:00
2019-07-06 15:20:35 -04:00
Further information about the general cluster architecture can be found at the [cluster architecture page](/architecture/cluster).
2019-03-14 20:23:39 -04:00
2019-07-06 15:20:35 -04:00
## Node Architecture
2019-03-14 20:23:39 -04:00
2019-07-06 15:20:35 -04:00
Within each node, the PVC daemon is a single Python 3 program which handles all node functionality, including networking, starting cluster services, managing creation/removal of VMs, networks, and storage, and providing utilization statistics and information to the cluster.
2019-03-14 20:23:39 -04:00
2019-07-06 15:20:35 -04:00
The daemon uses an object-oriented approach, with most cluster objects being represented by class objects of a specific type. Each node has a full view of all cluster objects and can interact with them based on events from the cluster as needed.
2019-03-14 20:23:39 -04:00
2019-07-06 15:20:35 -04:00
Further information about the node daemon architecture can be found at the [daemon architecture page](/architecture/daemon).
2019-03-14 20:23:39 -04:00
2019-07-06 15:20:35 -04:00
## Client Architecture
2019-03-14 20:23:39 -04:00
2019-07-06 15:20:35 -04:00
### CLI client
2019-03-14 20:23:39 -04:00
2019-07-06 15:20:35 -04:00
The CLI client is the most basic interface to the PVC cluster. It is a Python 3 Click application which interfaces directly with the Zookeeper cluster and provides a self-documenting CLI interface for PVC.
2019-03-14 20:23:39 -04:00
2019-07-06 15:20:35 -04:00
Further information about the CLI client architecture can be found at the [CLI client architecture page](/architecture/cli).
2019-03-14 20:23:39 -04:00
2019-07-06 15:20:35 -04:00
The CLI client manual can be found at the [CLI manual page](/manuals/cli).
2019-03-14 20:23:39 -04:00
2019-07-06 15:20:35 -04:00
### API client
2019-03-14 20:23:39 -04:00
2019-07-06 15:20:35 -04:00
The HTTP API client is a more advanced interface to the PVC cluster, suitable for creating custom interfaces for PVC and providing better access control than the CLI. It is a Python 3 Flask application which also interfaces directly with the Zookeper cluster, and provides services on port 7370 by default. The API features a basic, key-based authentication mechanism to prevent unauthorized access, though this is optional, and can also provide HTTPS support if required for maximum security over public networks. With the exception of cluster initialization, the API can perform all functions that the CLI client can using a similar syntax and layout. Requests return JSON, and POST requests generally expect HTTP form responses.
2019-03-14 20:23:39 -04:00
2019-07-06 15:20:35 -04:00
Further information about the API client architecture can be found at the [API client architecture page](/architecture/api).
2019-03-14 20:23:39 -04:00
2019-07-06 15:20:35 -04:00
The API client manual can be found at the [API manual page](/manuals/api).
2019-03-14 20:23:39 -04:00
2019-07-06 15:20:35 -04:00
### Direct bindings
2019-03-14 20:23:39 -04:00
2019-07-06 15:20:35 -04:00
Both the CLI and API clients use a common set of functions to perform the actual communication with the cluster, which is packaged separately as the `pvc-client-common` package. These functions can be used directly by 3rd-party Python interfaces for PVC if desired.
2019-03-14 20:23:39 -04:00
2019-07-06 15:20:35 -04:00
## Deployment architecture
2019-03-14 20:23:39 -04:00
2019-07-06 15:20:35 -04:00
The overall management, deployment, bootstrapping, and configuring of nodes is accomplished via a set of Ansible roles, found in the [`pvc-ansible` repository](https://github.com/parallelvirtualcluster/pvc-ansible), and nodes are installed via a custom installer ISO generated by the [`pvc-installer` repository](https://github.com/parallelvirtualcluster/pvc-installer). Once the cluster is set up, nodes can be added, replaced, or updated using this Ansible framework.
2019-03-14 20:23:39 -04:00
2019-07-06 15:20:35 -04:00
Further information about the Ansible deployment architecture can be found at the [Ansible architecture page](/architecture/ansible).