mirror of
https://github.com/kemko/nomad.git
synced 2026-01-08 19:35:41 +03:00
8a597a172d
* Docs SEO: task drivers and plugins; refactor virt section * add redirects for virt driver files * Some updates. committing rather than stashing * fix content-check errors * Remove docs/devices/ and redirect to plugins/devices * Update docs/drivers descriptions * Move USB device plugin up a level. Finish descriptions. * Apply suggestions from Jeff's code review Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> * Apply title case suggestions from code review Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> * apply title case suggestions; fix indentation --------- Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com>
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
|
|
|
|
@include 'virt-beta-callout.mdx'
|
|
|
|
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][].
|
|
|
|
## 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
|