mirantis/virtlet

Virtlet 

镜像概述和主要用途

Virtlet是一个Kubernetes运行时服务器，允许基于QCOW2镜像运行虚拟机工作负载。它扩展了Kubernetes的能力，使其能够管理传统虚拟机，同时保持与Kubernetes生态系统的兼容性。

核心功能和特性

• 支持基于QCOW2镜像的虚拟机工作负载在Kubernetes集群中运行
• 提供专用命令行工具virtletctl，简化虚拟机Pod的管理
• 兼容主流Kubernetes网络插件（bridge、calico、flannel、weave）
• 支持KVM加速（若宿主机支持），否则使用QEMU
• 可通过DaemonSets或本地环境部署

架构说明

查看此处了解Virtlet架构描述。

使用场景和适用范围

• 需要在Kubernetes集群中运行传统虚拟机工作负载的场景
• 希望统一管理容器和虚拟机的混合环境
• 开发和测试环境中快速部署虚拟机集群
• 运行无法容器化的应用或操作系统

详细使用方法和配置说明

社区支持

可加入Kubernetes Slack上的#virtlet频道（若未加入k8s群组，可通过slack.k8s.io注册）。欢迎用户和开发者参与！

快速开始

要试用Virtlet，请按照本地环境运行和示例尝试文档中的说明操作。

Virtlet介绍视频

可观看在Kubernetes社区会议上录制的Virtlet演示视频此处。

命令行界面

Virtlet提供辅助工具virtletctl，用于管理虚拟机Pod。Linux和Mac OS X的二进制文件可在https://github.com/Mirantis/virtlet/releases%E8%8E%B7%E5%8F%96%E3%80%82

若使用Kubernetes 1.9，可将virtletctl安装为kubectl插件：

bash
virtletctl install

之后可使用kubectl plugin virt代替virtletctl（当kubectl插件稳定后，plugin子命令将不再需要）：

bash
kubectl plugin virt ssh cirros@cirros-vm -- -i examples/vmkey

使用演示

可通过此链接观看示例使用会话。

也可使用演示脚本快速试用Virtlet（需Docker 1.12+）：

bash
wget https://raw.githubusercontent.com/Mirantis/virtlet/master/deploy/demo.sh
chmod +x demo.sh
# './demo.sh --help'显示说明
./demo.sh

演示将启动测试集群，在其上部署Virtlet，然后启动CirrOS虚拟机。可从虚拟机内部通过curl http://nginx.default.svc.cluster.local访问示例nginx服务器。要断开与虚拟机的连接，按Ctrl-D。虚拟机启动后，也可使用virtletctl工具连接其SSH服务器：

bash
virtletctl ssh cirros@cirros-vm -- -i examples/vmkey [command...]

默认使用CNI bridge插件进行集群网络。也可使用calico、flannel或weave插件覆盖默认设置，例如：

bash
CNI_PLUGIN=flannel ./demo.sh

还可选择在DIND集群的master节点上部署Virtlet，这在不想使用工作节点时很有用（即使用NUM_NODES=0启动集群）：

bash
VIRTLET_ON_MASTER=1 ./demo.sh

演示脚本将检查主机的KVM支持，若Docker主机上可用，Virtlet将使用KVM；若不可用，则使用纯QEMU。

演示基于https://github.com/Mirantis/kubeadm-dind-cluster%E9%A1%B9%E7%9B%AE%E3%80%82**%E7%9B%AE%E5%89%8D%E4%B8%8D%E6%94%AF%E6%8C%81Docker btrfs存储驱动**。有关更多信息，请参考kubeadm-dind-cluster文档。

不再需要测试集群时，可使用./dind-cluster-v1.9.sh clean移除。

部署方式

可按照本地环境运行或使用DaemonSets部署文档中的说明运行Virtlet。另有单独文档描述在真实集群上安装Virtlet的过程。

外部使用项目

已有一些外部项目在使用Virtlet。一个有趣的用例是MIKELANGELO项目，它使用Virtlet在Kubernetes上运行OSv unikernels。Unikernels是一种特殊的虚拟机，体积极小（约20MB），每个只能运行单个进程。Virtlet在Kubernetes上处理它们没有问题，如此视频所示。微服务演示可在https://github.com/mikelangelo-project/osv-microservice-demo#deploying-unikernels-on-kubernetes%E8%8E%B7%E5%8F%96%E3%80%82

帮助支持

使用Virtlet时若遇到任何问题，请查看GitHub上的http://github.com/Mirantis/virtlet/issues%E3%80%82%E8%8B%A5%E6%9C%AA%E6%89%BE%E5%88%B0%E7%9B%B8%E5%85%B3%E6%A1%88%E4%BE%8B%EF%BC%8C%E8%AF%B7%E6%8F%90%E4%BA%A4%E6%96%B0issue%E3%80%82%E5%A6%82%E6%9C%89%E4%BB%BB%E4%BD%95%E9%97%AE%E9%A2%98%EF%BC%8C%E4%B9%9F%E5%8F%AF%E4%BD%BF%E7%94%A8Kubernetes Slack上的#virtlet频道。

贡献

Virtlet是开源项目，欢迎任何贡献。请查看贡献指南文档了解我们的指导原则和设置Virtlet开发环境的进一步说明。

许可

除非特别说明，本项目的所有部分均采用Apache 2.0许可证。