Skip to content
PiVirt

Host Deployment Runbook

PiVirt deployment operations encompass single-node development setup, multi-node control plane bootstrap, automated node joins, and zero-downtime rolling upgrades.

Cluster Bootstrap

Section titled “Cluster Bootstrap”

Single Node

Section titled “Single Node”
Terminal window
# Initialize cluster
pvcli cluster init --name dev-cluster


# Verify
pvcli cluster get dev-cluster

Multi-Node

Section titled “Multi-Node”
Terminal window
# Initialize control plane
pvcli cluster init --name prod-cluster --control-plane 3


# Generate join token
pvcli cluster token create --ttl 24h


# Join worker nodes
pvcli cluster join --token <token> --node-ip 10.0.1.20

Node Management

Section titled “Node Management”

Add Nodes

Section titled “Add Nodes”
Terminal window
# Add worker nodes
pvcli cluster node add --role worker --count 3


# Add specific node
pvcli cluster node add --name worker-04 --ip 10.0.1.24

Remove Nodes

Section titled “Remove Nodes”
Terminal window
# Drain node first
pvcli cluster node drain worker-03


# Remove node
pvcli cluster node remove worker-03

Maintenance

Section titled “Maintenance”
Terminal window
# Cordon node (no new VMs)
pvcli cluster node cordon worker-01


# Drain node (evict VMs)
pvcli cluster node drain worker-01


# Uncordon after maintenance
pvcli cluster node uncordon worker-01

Rolling Updates

Section titled “Rolling Updates”

Update PiVirt Components

Section titled “Update PiVirt Components”
Terminal window
# Check current version
pvcli cluster get prod-cluster -o json | jq '.version'


# Update to new version
pvcli cluster upgrade --version v0.0.90 --strategy rolling


# Monitor progress
pvcli cluster upgrade status

Update Strategy

Section titled “Update Strategy”
apiVersion: pivirt.pilab.hu/v1
kind: ClusterUpgrade
metadata:
  name: upgrade-v0.0.90
spec:
  version: "v0.0.90"
  strategy:
    type: "rolling"
    max_surge: 1
    max_unavailable: 0
    partition: 0

Backup & Restore

Section titled “Backup & Restore”

Backup Cluster State

Section titled “Backup Cluster State”
Terminal window
# Backup etcd
pvcli cluster backup create --name backup-2024-01-15


# List backups
pvcli cluster backup list

Restore from Backup

Section titled “Restore from Backup”
Terminal window
# Restore cluster
pvcli cluster backup restore --name backup-2024-01-15

Troubleshooting

Section titled “Troubleshooting”

Cluster Health

Section titled “Cluster Health”
Terminal window
# Check cluster status
pvcli cluster get prod-cluster -o yaml


# Check node status
pvcli cluster node list


# Check component health
pvcli cluster health

Common Issues

Section titled “Common Issues”
Issue Resolution
Node not joining Check network connectivity, firewall rules
etcd quorum lost Restore from backup, check node health
PiTrust certificate errors Verify CA chain, check PiTrust CA server / operator
Section titled “Related”
Open: Community & Dev•Professional: Production Clustering•Enterprise: Mission-Critical & HA
© 2026 Progressive Innovation LAB. All rights reserved.Distributed virtualization platform licensed across Open, Professional, and Enterprise tiers.