github.com/Ilhicas/nomad@v1.0.4-0.20210304152020-e86851182bc3/website/content/docs/job-specification/resources.mdx (about)

     1  ---
     2  layout: docs
     3  page_title: resources Stanza - Job Specification
     4  sidebar_title: resources
     5  description: |-
     6    The "resources" stanza describes the requirements a task needs to execute.
     7    Resource requirements include memory, cpu, and more.
     8  ---
     9  
    10  # `resources` Stanza
    11  
    12  <Placement groups={['job', 'group', 'task', 'resources']} />
    13  
    14  The `resources` stanza describes the requirements a task needs to execute.
    15  Resource requirements include memory, CPU, and more.
    16  
    17  ```hcl
    18  job "docs" {
    19    group "example" {
    20      task "server" {
    21        resources {
    22          cpu    = 100
    23          memory = 256
    24  
    25          device "nvidia/gpu" {
    26            count = 2
    27          }
    28        }
    29      }
    30    }
    31  }
    32  ```
    33  
    34  ## `resources` Parameters
    35  
    36  - `cpu` `(int: 100)` - Specifies the CPU required to run this task in MHz.
    37  
    38  - `memory` `(int: 300)` - Specifies the memory required in MB
    39  
    40  - `device` <code>([Device][]: &lt;optional&gt;)</code> - Specifies the device
    41    requirements. This may be repeated to request multiple device types.
    42  
    43  ## `resources` Examples
    44  
    45  The following examples only show the `resources` stanzas. Remember that the
    46  `resources` stanza is only valid in the placements listed above.
    47  
    48  ### Memory
    49  
    50  This example specifies the task requires 2 GB of RAM to operate. 2 GB is the
    51  equivalent of 2000 MB:
    52  
    53  ```hcl
    54  resources {
    55    memory = 2000
    56  }
    57  ```
    58  
    59  ### Devices
    60  
    61  This example shows a device constraints as specified in the [device][] stanza
    62  which require two nvidia GPUs to be made available:
    63  
    64  ```hcl
    65  resources {
    66    device "nvidia/gpu" {
    67      count = 2
    68    }
    69  }
    70  ```
    71  
    72  [device]: /docs/job-specification/device 'Nomad device Job Specification'