Platform Deployment Overview

PiVirt supports automated deployment across diverse infrastructure targets, from bare-metal servers with IPMI/Redfish to nested virtualization on Proxmox VE, VMware vSphere, and hyperscale cloud providers.

Deployment Methods

Bare Metal

# Using deployer
deployer apply -f deploy/baremetal-cluster.yaml

# Using pvcli
pvcli deploy apply -f deploy/baremetal-cluster.yaml

VMware

deployer apply -f deploy/vmware-cluster.yaml

Cloud

# AWS
deployer apply -f deploy/aws-cluster.yaml

# GCP
deployer apply -f deploy/gcp-cluster.yaml

Deployment Workflow

1. Plan Deployment

deployer plan -f deploy/cluster.yaml

2. Apply Deployment

deployer apply -f deploy/cluster.yaml

3. Monitor Progress

deployer status -n pivirt-cluster-prod
deployer logs -n pivirt-cluster-prod --follow

4. Verify Deployment

pvcli cluster get prod-cluster
pvcli cluster node list

Deployment Templates

Bare Metal Template

apiVersion: deployer.pilab.hu/v1
kind: Deployment
metadata:
  name: "pivirt-cluster-prod"
spec:
  provider: "baremetal"
  topology:
    control_plane:
      count: 3
      profile: "control-plane"
    workers:
      count: 5
      profile: "worker"

  profiles:
    control-plane:
      cpu: 8
      memory: 32Gi
      disk: 200Gi
    worker:
      cpu: 16
      memory: 64Gi
      disk: 500Gi

  cloud_init:
    template: "cluster-node.yaml.tmpl"

Rollback

# List revisions
deployer history -n pivirt-cluster-prod

# Rollback
deployer rollback -n pivirt-cluster-prod --revision 3

Troubleshooting

Deployment Stuck

# Check status
deployer status -n pivirt-cluster-prod

# View logs
deployer logs -n pivirt-cluster-prod --follow

SSH Connection Failed

# Test SSH
ssh -i /etc/deployer/ssh/id_rsa root@10.0.0.110

# Check cloud-init
ssh root@10.0.0.110 "cloud-init status --wait"