fe0365757a
- Added generated index files and report directories to .gitignore to prevent unnecessary tracking of transient files. - Updated README links to reflect new documentation paths for better navigation. - Improved documentation organization by ensuring all links point to the correct locations, enhancing user experience and accessibility.
2.8 KiB
2.8 KiB
VM Deployment Checklist
Pre-Deployment Checklist
1. Configuration Validation
- Run validation script
./scripts/validate-and-optimize-vms.sh - Fix any errors reported
- Review warnings (may be acceptable)
2. Quota Verification
- Check tenant quota (if applicable)
./scripts/pre-deployment-quota-check.sh <vm-file> - Verify Proxmox resources
./scripts/check-proxmox-quota-ssh.sh - Ensure sufficient resources available
3. Image Verification
- Verify image exists on Proxmox storage
- Confirm image name matches specification
- Check image is accessible on target node
4. Network Configuration
- Verify network bridge exists
- Check IP address availability
- Confirm DNS configuration
5. Storage Verification
- Verify storage pool exists
- Check storage pool has sufficient space
- Confirm storage pool supports VM disks
Deployment Steps
Step 1: Validate
./scripts/validate-and-optimize-vms.sh examples/production/phoenix/dns-primary.yaml
Step 2: Check Quota
./scripts/pre-deployment-quota-check.sh examples/production/phoenix/dns-primary.yaml
Step 3: Deploy
kubectl apply -f examples/production/phoenix/dns-primary.yaml
Step 4: Monitor
kubectl get proxmoxvm -w
kubectl describe proxmoxvm phoenix-dns-primary
Step 5: Verify
# Check VM status
kubectl get proxmoxvm phoenix-dns-primary
# Check VM details
kubectl describe proxmoxvm phoenix-dns-primary
# Check controller logs
kubectl logs -n crossplane-system -l app=crossplane-provider-proxmox --tail=50
Post-Deployment Verification
VM Status
- VM is in "running" state
- VM has assigned IP address
- QEMU guest agent is active
Service Verification
- Required services are running
- Packages are installed
- Configuration is correct
Connectivity
- SSH access works
- Network connectivity verified
- DNS resolution works (if applicable)
Troubleshooting
Quota Check Fails
- Check current quota usage
- Reduce resource requirements
- Request quota increase
- Use different tenant
VM Creation Fails
- Check controller logs
- Verify Proxmox connectivity
- Check resource availability
- Verify image exists
Guest Agent Not Starting
- Check VM logs
- Verify package installation
- Check systemd status
- Review cloud-init logs
Quick Reference
Validation
./scripts/validate-and-optimize-vms.sh
Quota Check
./scripts/pre-deployment-quota-check.sh
Proxmox Resources
./scripts/check-proxmox-quota-ssh.sh
Deploy VM
kubectl apply -f <vm-file>
Check Status
kubectl get proxmoxvm -A
Last Updated: 2025-12-08