mirror of
https://github.com/kemko/nomad.git
synced 2026-01-05 01:45:44 +03:00
61 lines
2.2 KiB
Plaintext
61 lines
2.2 KiB
Plaintext
---
|
|
layout: docs
|
|
page_title: Virt task driver plugin
|
|
description: >-
|
|
The Virt task driver leverages Linux capabilities and runs virtual machines using the libvirt API and hypervisors such as QEMU. Learn about Nomad client requirements, installation, capabilities, and Nomad client node attributes.
|
|
---
|
|
|
|
# Virt task driver plugin
|
|
|
|
Name: `virt`
|
|
|
|
The Virt task driver utilizes the [libvirt][] API to run and manage virtual
|
|
machines using hypervisors such as [QEMU][]. The task driver supports a wide
|
|
variety of Nomad features including [workload identity][], [task templates][],
|
|
and [service discovery][].
|
|
|
|
@include 'virt-beta-callout.mdx'
|
|
|
|
## Driver Capabilities
|
|
|
|
The Virt task driver implements these driver [capabilities][capabilities].
|
|
|
|
| Feature | Implementation |
|
|
|----------------------|----------------|
|
|
| `nomad alloc signal` | false |
|
|
| `nomad alloc exec` | false |
|
|
| filesystem isolation | image |
|
|
| network isolation | host |
|
|
| volume mounting | false |
|
|
|
|
## Nomad Client Node Attributes
|
|
|
|
The Virt task driver provides these node attributes that you can use as
|
|
constraints when authoring jobs.
|
|
|
|
```
|
|
driver.virt = true
|
|
driver.virt.active = 0
|
|
driver.virt.emulator.version = 8002002
|
|
driver.virt.inactive = 0bytes
|
|
driver.virt.libvirt.version = 10000000
|
|
driver.virt.network.default.bridge_name = virbr0
|
|
driver.virt.network.default.state = active
|
|
```
|
|
|
|
## Reference
|
|
|
|
- [Install and configure the Virt task driver][install].
|
|
- [Configure a virt task in your job specification][task-config].
|
|
|
|
|
|
[libvirt]: https://libvirt.org/
|
|
[QEMU]: https://www.qemu.org/
|
|
[workload identity]: https://developer.hashicorp.com/nomad/docs/concepts/workload-identity
|
|
[task templates]: https://developer.hashicorp.com/nomad/docs/job-specification/template
|
|
[service discovery]: https://developer.hashicorp.com/nomad/docs/networking/service-discovery
|
|
[github]: https://github.com/hashicorp/nomad-driver-virt
|
|
[capabilities]: /nomad/docs/concepts/plugins/task-drivers#task-driver-plugin-api
|
|
[install]: /nomad/plugins/drivers/virt/install
|
|
[task-config]: /nomad/plugins/drivers/virt/task-config
|