mirror of
https://github.com/kemko/nomad.git
synced 2026-01-05 09:55:44 +03:00
d305f32017
* create plugin author guide; remove concepts/plugins * style guide; update links * update cni redirect * move host-volume plugin to /plugins/. Add arch host volume content. * Apply Jeff's style guide updates Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> * Create Base plugin API section, link to BasePlugin interface --------- Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com>
61 lines
2.1 KiB
Plaintext
61 lines
2.1 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]: /nomad/docs/concepts/workload-identity
|
|
[task templates]: /nomad/docs/job-specification/template
|
|
[service discovery]: /nomad/docs/job-networking/service-discovery
|
|
[github]: https://github.com/hashicorp/nomad-driver-virt
|
|
[capabilities]: /nomad/plugins/author/task-driver#task-driver-plugin-api
|
|
[install]: /nomad/plugins/drivers/virt/install
|
|
[task-config]: /nomad/plugins/drivers/virt/task-config
|