

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Cree límites de recursos para los trabajos
<a name="build-job-limits"></a>

Los trabajos enviados a Deadline Cloud pueden depender de los recursos que se comparten entre varios trabajos. Por ejemplo, una granja puede tener más trabajadores que las licencias flotantes para un recurso específico. O bien, es posible que un servidor de archivos compartido solo pueda entregar datos a un número limitado de trabajadores al mismo tiempo. En algunos casos, uno o más trabajos pueden ocupar todos estos recursos y provocar errores debido a que los recursos no están disponibles cuando comienzan a trabajar nuevos trabajadores. 

Para ayudar a solucionar este problema, puedes usar *límites* para estos recursos limitados. Deadline Cloud tiene en cuenta la disponibilidad de los recursos limitados y utiliza esa información para garantizar que los recursos estén disponibles a medida que se van incorporando nuevos trabajadores, de forma que los trabajos tengan menos probabilidades de fracasar debido a la falta de recursos.

Se establecen límites para toda la granja. Los trabajos enviados a una cola solo pueden adquirir los límites asociados a la cola. Si especificas un límite para un trabajo que no está asociado a la cola, el trabajo no es compatible y no se ejecutará.

Para usar un límite, debes 
+ [Crea un límite](job-limit-create.md)
+ [Asocia un límite y una cola](job-limit-associate.md)
+ [Envíe un trabajo que requiera límites](job-limit-job.md)

**nota**  
Si ejecuta un trabajo que tiene recursos limitados en una cola que no está asociada a un límite, ese trabajo puede consumir todos los recursos. Si tiene un recurso restringido, asegúrese de que todos los pasos de los trabajos de las colas que utilizan el recurso estén asociados a un límite.

En el caso de los límites definidos en una granja, asociados a una cola y especificados en un trabajo, puede ocurrir una de estas cuatro cosas:
+ Si crea un límite, lo asocia a una cola y especifica el límite en la plantilla de un trabajo, el trabajo se ejecuta y utiliza solo los recursos definidos en el límite.
+ Si crea un límite, lo especifica en una plantilla de trabajo, pero no lo asocia a una cola, el trabajo se marcará como incompatible y no se ejecutará.
+ Si crea un límite, no lo asocia a una cola ni especifica el límite en la plantilla de un trabajo, el trabajo se ejecuta pero no utiliza el límite.
+ Si no utiliza ningún límite, el trabajo se ejecuta.

Si asocias un límite a varias colas, las colas comparten los recursos limitados por el límite. Por ejemplo, si crea un límite de 100 y una cola utiliza 60 recursos, las demás colas solo pueden utilizar 40 recursos. Cuando se libera un recurso, una tarea de cualquier cola lo puede ocupar.

Deadline Cloud proporciona dos AWS CloudFormation métricas para ayudarte a supervisar los recursos que proporciona un límite. Puede supervisar la cantidad actual de recursos en uso y la cantidad máxima de recursos disponibles dentro del límite. Para obtener más información, consulta [las métricas del límite de recursos](https://docs.aws.amazon.com/deadline-cloud/latest/developerguide/cloudwatch-metrics.html#cloudwatch-metrics-limits) en la *Guía para desarrolladores de Deadline Cloud*.

Aplicas un límite a un paso de trabajo en una plantilla de trabajo. Al especificar la cantidad requerida (nombre) de un límite en la `amounts` sección `hostRequirements` de un paso y `amountRequirementName` se asocia un límite con el mismo nombre a la cola de trabajos, las tareas programadas para este paso están restringidas por el límite del recurso.

Si un paso requiere un recurso limitado por un límite alcanzado, más trabajadores no se encargarán de las tareas de ese paso.

Puede aplicar más de un límite a un paso del trabajo. Por ejemplo, si el paso utiliza dos licencias de software diferentes, puede aplicar un límite diferente para cada licencia. Si un paso requiere dos límites y se alcanza el límite de uno de los recursos, más trabajadores no se encargarán de las tareas de ese paso hasta que los recursos estén disponibles.

## Detener y eliminar los límites
<a name="job-limit-stop-delete"></a>

Al detener o eliminar la asociación entre una cola y un límite, un trabajo que utilice el límite deja de programar las tareas a partir de los pasos que requieren este límite y bloquea la creación de nuevas sesiones para un paso.

Las tareas que están preparadas permanecen listas y las tareas se reanudan automáticamente cuando la asociación entre la cola y el límite vuelve a activarse. No es necesario volver a poner en cola ningún trabajo.

Al detener o eliminar la asociación entre una cola y un límite, tiene dos opciones para detener la ejecución de tareas:
+ Detener y cancelar tareas: los trabajadores con sesiones en las que se ha alcanzado el límite cancelan todas las tareas.
+ Detener y terminar la ejecución de las tareas: los trabajadores con sesiones que han alcanzado el límite completan sus tareas.

Al eliminar un límite mediante la consola, los trabajadores primero dejan de ejecutar las tareas inmediatamente o, finalmente, cuando las terminan. Cuando se elimina la asociación, ocurre lo siguiente: 
+ Los pasos que requieren el límite están marcados como no compatibles.
+ Se cancela todo el trabajo que contiene esos pasos, incluidos los pasos que no requieren el límite.
+ El trabajo está marcado como no compatible.

Si la cola asociada al límite tiene una flota asociada con una capacidad de flota que coincide con la cantidad requerida (nombre del límite), esa flota seguirá procesando los trabajos con el límite especificado.

# Crea un límite
<a name="job-limit-create"></a>

Puede crear un límite mediante la consola de Deadline Cloud o la [CreateLimit operación en la API de Deadline Cloud](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/API_CreateLimit.html). Los límites se definen para una granja, pero se asocian a las colas. Tras crear un límite, puede asociarlo a una o más colas.

**Para crear un límite**

1. En el panel de la consola de [Deadline Cloud (consola](https://console.aws.amazon.com/deadlinecloud/home) de Deadline Cloud), selecciona la granja para la que quieres crear una cola.

1. Elige la granja a la que quieres añadir el límite, selecciona la pestaña **Límites** y, a continuación, selecciona **Crear límite**.

1. Proporcione los detalles del límite. El **nombre del importe obligatorio** es el nombre utilizado en la plantilla de trabajo para identificar el límite. Debe empezar por el prefijo **amount.** seguido del nombre del importe. El nombre del importe requerido debe ser exclusivo en las colas asociadas al límite.

1. Si elige **Establecer una cantidad máxima**, esa es la cantidad total de recursos permitidos por este límite. Si eliges **Sin cantidad máxima**, el uso de los recursos no está limitado. Incluso cuando el uso de los recursos no está limitado, la CloudWatch métrica de `CurrentCount` Amazon se emite para que puedas realizar un seguimiento del uso. Para obtener más información, consulta [CloudWatchlas métricas](https://docs.aws.amazon.com/deadline-cloud/latest/developerguide/cloudwatch-metrics.html) en la *Guía para desarrolladores de Deadline Cloud*.

1. Si ya conoces las colas que deberían usar el límite, puedes elegirlas ahora. No necesitas asociar una cola para crear un límite.

1. Selecciona **Crear límite**.

# Asocia un límite y una cola
<a name="job-limit-associate"></a>

Tras crear un límite, puede asociar una o más colas al límite. Solo las colas asociadas a un límite utilizan los valores especificados en el límite.

Para crear una asociación con una cola, utilice la consola de Deadline Cloud o la [CreateQueueLimitAssociation operación de la API de Deadline Cloud](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/API_CreateQueueLimitAssociation.html).

**Para asociar una cola a un límite**

1. En el panel de la consola de [Deadline Cloud (consola](https://console.aws.amazon.com/deadlinecloud/home) de Deadline Cloud), selecciona la granja a la que quieres asociar un límite a una cola.

1. Selecciona la pestaña **Límites**, elige el límite al que quieres asociar una cola y, a continuación, selecciona **Editar** límite.

1. En la sección **Asociar colas**, elija las colas que desee asociar al límite.

1. Seleccione **Save changes (Guardar cambios)**.

# Envíe un trabajo que requiera límites
<a name="job-limit-job"></a>

Para aplicar un límite, debe especificarlo como un requisito de anfitrión para el trabajo o paso del trabajo. Si no especificas un límite en un paso y ese paso usa un recurso asociado, el uso del paso no se descuenta del límite cuando se programan los trabajos.

Algunos remitentes de Deadline Cloud te permiten establecer un requisito de anfitrión. Puede especificar el nombre del requisito de cantidad del límite en el remitente para aplicar el límite.

Si el remitente no admite la adición de requisitos de anfitrión, también puedes aplicar un límite editando la plantilla de trabajo correspondiente al trabajo.

**Para aplicar un límite a un paso de trabajo del paquete de trabajos**

1. Abra la plantilla de trabajo del trabajo mediante un editor de texto. La plantilla de trabajo se encuentra en el directorio del paquete de trabajos del trabajo. Para obtener más información, consulte [Paquetes de trabajos](https://docs.aws.amazon.com/deadline-cloud/latest/developerguide/build-job-bundle.html) en la *Guía para desarrolladores de Deadline Cloud*.

1. Busca la definición del paso al que quieres aplicar el límite.

1. Añada lo siguiente a la definición del paso. *amount.name*Sustitúyalo por el nombre del importe obligatorio de tu límite. Para un uso normal, debe establecer el `min` valor en 1.

------
#### [ YAML ]

   ```
     hostRequirements:
       amounts:
       - name: amount.name
         min: 1
   ```

------
#### [ JSON ]

   ```
   "hostRequirements": {
       "amounts": [
           {
               "name": "amount.name",
               "min": "1"
           }
       }
   }
   ```

------

   Puede añadir varios límites a un paso de trabajo de la siguiente manera. Sustituya *amount.name\$11* y *amount.name\$12* por los nombres de los requisitos de importe de sus límites.

------
#### [ YAML ]

   ```
     hostRequirements:
       amounts:
       - name: amount.name_1
         min: 1
       - name: amount.name_2
         min: 1
   ```

------
#### [ JSON ]

   ```
   "hostRequirements": {
       "amounts": [
           {
               "name": "amount.name_1",
               "min": "1"
           },
           {
               "name": "amount.name_2",
               "min": "1"
           }
       }
   }
   ```

------

1. Guarde los cambios en la plantilla de trabajo.