1e3c3cb287
IOPS have been modelled as a resource since Nomad 0.1 but has never actually been detected and there is no plan in the short term to add detection. This is because IOPS is a bit simplistic of a unit to define the performance requirements from the underlying storage system. In its current state it adds unnecessary confusion and can be removed without impacting any users. This PR leaves IOPS defined at the jobspec parsing level and in the api/ resources since these are the two public uses of the field. These should be considered deprecated and only exist to allow users to stop using them during the Nomad 0.9.x release. In the future, there should be no expectation that the field will exist.
1.9 KiB
| layout | page_title | sidebar_current | description |
|---|---|---|---|
| docs | resources Stanza - Job Specification | docs-job-specification-resources | The "resources" stanza describes the requirements a task needs to execute. Resource requirements include memory, network, cpu, and more. |
resources Stanza
| Placement |
job -> group -> task -> **resources**
|
|---|
The resources stanza describes the requirements a task needs to execute.
Resource requirements include memory, network, CPU, and more.
job "docs" {
group "example" {
task "server" {
resources {
cpu = 100
memory = 256
network {
mbits = 100
port "http" {}
port "ssh" {
static = 22
}
}
}
}
}
}
resources Parameters
-
cpu(int: 100)- Specifies the CPU required to run this task in MHz. -
memory(int: 300)- Specifies the memory required in MB -
network(Network: )- Specifies the network requirements, including static and dynamic port allocations.
resources Examples
The following examples only show the resources stanzas. Remember that the
resources stanza is only valid in the placements listed above.
Memory
This example specifies the task requires 2 GB of RAM to operate. 2 GB is the equivalent of 2000 MB:
resources {
memory = 2000
}
Network
This example shows network constraints as specified in the network stanza which require 1 Gbit of bandwidth, dynamically allocates two ports, and statically allocates one port:
resources {
network {
mbits = 1000
port "http" {}
port "https" {}
port "lb" {
static = "8889"
}
}
}