crit/vm-migrate

vm-migrate — 在Kubernetes集群间迁移KubeVirt虚拟机镜像

镜像概述

本工具面向KubeVirt运维人员和工程师，用于在不同Kubernetes集群之间导出和导入虚拟机磁盘镜像。支持将源集群的虚拟机磁盘导出为压缩包并上传至S3/Azure存储，或从URL/云存储将镜像导入到目标集群的DataVolume中。

核心功能

• 导出: 从源集群将KubeVirt虚拟机的PVC磁盘导出为压缩包，上传至S3/Azure存储或保存到本地文件。
• 导入: 从URL（直接.img或压缩包）或云存储下载镜像，通过KubeVirt的CDI工具导入到目标集群的DataVolume中。
• 辅助命令: 支持下载、压缩、解压、独立上传等实用操作。

使用场景

1. 跨Kubernetes集群迁移KubeVirt虚拟机。
2. 通过云存储备份/恢复虚拟机镜像。
3. 本地迁移虚拟机镜像（无需云存储）。

配置说明

前提条件

• 源集群: 已安装KubeVirt及VirtualMachineExport CRD，具备创建/读取VMExport的权限，云存储凭证（如使用）。
• 目标集群: 已安装KubeVirt和CDI，具备创建DataVolume的权限。

安装方式

1. Go安装:

   bash
   go install github.com/armadasystems/vm-migrate@latest
   

2. 容器运行: 参考examples/k8s/job-export.yaml在集群内作为Job运行。

快速开始

1. 导出到云存储

bash
# 导出到S3
vm-migrate export \
  --namespace prod \
  --pvc web-01 \
  --provider s3 \
  --bucket my-vm-exports \
  --key exports/web-01-$(date +%s).tar.gz

# 导出到Azure Blob
vm-migrate export \
  --namespace prod \
  --pvc web-01 \
  --provider azure \
  --container vm-archives \
  --blob web-01-$(date +%s).tar.gz \
  --connection-string "$AZURE_STORAGE_CONNECTION_STRING"

2. 生成下载URL

bash
# S3预签名URL
aws s3 presign s3://my-vm-exports/exports/web-01-123456.tar.gz --expires-in 86400

# Azure SAS URL
az storage blob generate-sas \
  --account-name <account> \
  --container-name vm-archives \
  --name web-01-123456.tar.gz \
  --permissions r \
  --expiry 2025-12-31T23:59Z \
  --https-only --full-uri

3. 导入到目标集群

bash
# 从URL导入
vm-migrate import "https://example.com/exports/web-01-123456.tar.gz" \
  --name web-01-dv --size 40Gi \
  --namespace kubevirt-workloads \
  --storage-class fast-ssd

# 从Azure Blob导入
export AZURE_STORAGE_CONNECTION_STRING="DefaultEndpointsProtocol=..."
vm-migrate import azure://vm-archives/web-01-123456.tar.gz \
  --name web-01-dv --size 40Gi

环境变量配置

支持通过环境变量设置默认参数，例如：

bash
export VM_MIGRATE_NAMESPACE=prod
export VM_MIGRATE_PVC=web-01
export VM_MIGRATE_PROVIDER=s3
export VM_MIGRATE_BUCKET=my-vm-exports
vm-migrate export

集群内运行示例

参考examples/k8s/job-export.yaml创建ServiceAccount和Job：

yaml
apiVersion: batch/v1
kind: Job
metadata:
  name: vm-export
spec:
  template:
    spec:
      serviceAccountName: vm-migrate-sa
      containers:
      - name: vm-migrate
        image: crit/vm-migrate
        command: ["vm-migrate", "export", "--namespace", "prod", "--pvc", "web-01", "--provider", "s3", "--bucket", "my-vm-exports"]
        env:
        - name: AWS_ACCESS_KEY_ID
          valueFrom:
            secretKeyRef:
              name: s3-creds
              key: access_key
        - name: AWS_SECRET_ACCESS_KEY
          valueFrom:
            secretKeyRef:
              name: s3-creds
              key: secret_key
      restartPolicy: Never

安全注意事项

• 生产环境中建议关闭--insecure-skip-tls-verify以启用TLS验证。
• 预签名URL/SAS令牌应设置较短有效期，避免泄露。
• 导入前验证镜像来源的安全性。

故障排除

• virtctl未找到: 确保本地或容器内安装了KubeVirt的virtctl工具。
• 上传代理不可达: 检查kubeconfig是否指向目标集群，或显式指定--uploadproxy-url。
• 镜像导入失败: 确认--size参数足够大，且镜像来源有效。