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.
147 lines
2.8 KiB
Markdown
147 lines
2.8 KiB
Markdown
# VM Deployment Checklist
|
|
|
|
## Pre-Deployment Checklist
|
|
|
|
### 1. Configuration Validation
|
|
|
|
- [ ] Run validation script
|
|
```bash
|
|
./scripts/validate-and-optimize-vms.sh
|
|
```
|
|
- [ ] Fix any errors reported
|
|
- [ ] Review warnings (may be acceptable)
|
|
|
|
### 2. Quota Verification
|
|
|
|
- [ ] Check tenant quota (if applicable)
|
|
```bash
|
|
./scripts/pre-deployment-quota-check.sh <vm-file>
|
|
```
|
|
- [ ] Verify Proxmox resources
|
|
```bash
|
|
./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
|
|
```bash
|
|
./scripts/validate-and-optimize-vms.sh examples/production/phoenix/dns-primary.yaml
|
|
```
|
|
|
|
### Step 2: Check Quota
|
|
```bash
|
|
./scripts/pre-deployment-quota-check.sh examples/production/phoenix/dns-primary.yaml
|
|
```
|
|
|
|
### Step 3: Deploy
|
|
```bash
|
|
kubectl apply -f examples/production/phoenix/dns-primary.yaml
|
|
```
|
|
|
|
### Step 4: Monitor
|
|
```bash
|
|
kubectl get proxmoxvm -w
|
|
kubectl describe proxmoxvm phoenix-dns-primary
|
|
```
|
|
|
|
### Step 5: Verify
|
|
```bash
|
|
# 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
|
|
1. Check current quota usage
|
|
2. Reduce resource requirements
|
|
3. Request quota increase
|
|
4. Use different tenant
|
|
|
|
### VM Creation Fails
|
|
1. Check controller logs
|
|
2. Verify Proxmox connectivity
|
|
3. Check resource availability
|
|
4. Verify image exists
|
|
|
|
### Guest Agent Not Starting
|
|
1. Check VM logs
|
|
2. Verify package installation
|
|
3. Check systemd status
|
|
4. Review cloud-init logs
|
|
|
|
## Quick Reference
|
|
|
|
### Validation
|
|
```bash
|
|
./scripts/validate-and-optimize-vms.sh
|
|
```
|
|
|
|
### Quota Check
|
|
```bash
|
|
./scripts/pre-deployment-quota-check.sh
|
|
```
|
|
|
|
### Proxmox Resources
|
|
```bash
|
|
./scripts/check-proxmox-quota-ssh.sh
|
|
```
|
|
|
|
### Deploy VM
|
|
```bash
|
|
kubectl apply -f <vm-file>
|
|
```
|
|
|
|
### Check Status
|
|
```bash
|
|
kubectl get proxmoxvm -A
|
|
```
|
|
|
|
---
|
|
|
|
**Last Updated**: 2025-12-08
|
|
|