As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Crie uma fila de trabalhos
Antes de enviar trabalhos em AWS Batch, você precisa criar uma fila. Ao criar uma fila de tarefas, você associa um ou mais ambientes de computação à fila e lhes atribui uma ordem de preferência.
Você também pode definir uma prioridade para a fila de tarefas para determinar a ordem na qual o programador AWS Batch irá posicionar as tarefas. Isso quer dizer que, se um ambiente de computação for associado a mais de uma fila de tarefas, aquela com prioridade mais alta terá preferência.
**Topics**
+ [
# Criar uma fila de trabalhos Amazon EC2
](create-job-queue-ec2.md)
+ [
# Criar uma fila de trabalhos Fargate
](create-job-queue-fargate.md)
+ [
# Criar uma fila de trabalhos Amazon EKS
](create-job-queue-eks.md)
+ [
# Criar uma fila de trabalhos do SageMaker Training no AWS Batch
](create-sagemaker-job-queue.md)
+ [
# Modelo de fila de trabalhos
](job-queue-template.md)
# Criar uma fila de trabalhos Amazon EC2
Conclua as etapas a seguir para criar uma fila de trabalhos para o Amazon Elastic Compute Cloud (Amazon EC2).
**Para criar uma fila de tarefas Amazon EC2**
1. Abra o console AWS Batch em [https://console.aws.amazon.com/batch/](https://console.aws.amazon.com/batch/).
1. Na barra de navegação, selecione Região da AWS a ser usada.
1. No painel de navegação, escolha **Filas de Tarefas**.
1. Escolha **Criar**.
1. Para o **Tipo de orquestração,** escolha **Amazon Elastic Compute Cloud (Amazon EC2)**.
1. Para **Nome**, insira um nome exclusivo para a sua fila de tarefas. Ele pode ter até 128 caracteres e conter letras minúsculas, maiúsculas, números e sublinhados (\$1).
1. Em **Prioridade**, insira um valor inteiro para a prioridade da fila de tarefas. As filas com prioridade mais alta serão executadas antes das filas com prioridade mais baixa associadas ao mesmo ambiente de computação. A prioridade é determinada em ordem decrescente. Por exemplo, uma fila de tarefas com valor de prioridade 10 tem preferência de programação em relação a uma fila com valor de prioridade 1.
1. (Opcional) Para **Política de Agendamento do Nome do Recurso da Amazon (ARN)**, escolha uma política de agendamento existente.
1. Em **Ambientes de Computação Conectados**, selecione um ou mais ambientes de computação da lista para associar à lista de tarefas. Selecione ambientes de computação na ordem que quiser que a fila tente posicionar a fila de tarefas. O programador de trabalhos usará a ordem do ambiente de computação para determinar o ambiente de computação responsável por iniciar uma tarefa específica. Antes de poder associá-los a uma fila de tarefas, os ambientes de computação devem estar no estado `VALID`. Você pode associar até três ambientes de computação a uma fila de tarefas. Caso não possua um ambiente de computação existente, escolha **Criar Ambiente Computacional**
**nota**
Todos os ambientes de computação associados a uma fila devem compartilhar o mesmo modelo de provisionamento. AWS Batch não é compatível com a mistura de modelos de provisionamento em uma única fila de tarefas.
1. Em **Computar Ordem de Provisionamento**, escolha as setas para cima e para baixo para configurar a ordem desejada.
1. Escolha **Criar Fila de Tarefas** para concluir e criar sua fila.
# Criar uma fila de trabalhos Fargate
Conclua as etapas a seguir para criar uma fila de trabalho para o AWS Fargate.
**Para criar uma fila de tarefas**
1. Abra o console AWS Batch em [https://console.aws.amazon.com/batch/](https://console.aws.amazon.com/batch/).
1. Na barra de navegação, selecione Região da AWS a ser usada.
1. No painel de navegação, escolha **Filas de Tarefas**.
1. Escolha **Criar**.
1. Para **Tipo de Orquestração**, escolha **Fargate**.
1. Para **Nome**, insira um nome exclusivo para a sua fila de tarefas. Ele pode ter até 128 caracteres e conter letras minúsculas, maiúsculas, números e sublinhados (\$1).
1. Em **Prioridade**, insira um valor inteiro para a prioridade da fila de tarefas. As filas com prioridade mais alta serão executadas antes das filas com prioridade mais baixa associadas ao mesmo ambiente de computação. A prioridade é determinada em ordem decrescente. Por exemplo, uma fila de tarefas com valor de prioridade 10 tem preferência de programação em relação a uma fila com valor de prioridade 1.
1. (Opcional) Para **Política de Agendamento do Nome do Recurso da Amazon (ARN)**, escolha uma política de agendamento existente.
1. Em **Ambientes de Computação Conectados**, selecione um ou mais ambientes de computação da lista para associar à lista de tarefas. Selecione ambientes de computação na ordem que quiser que a fila tente posicionar a fila de tarefas. O programador de trabalhos usará a ordem do ambiente de computação para determinar o ambiente de computação responsável por iniciar uma tarefa específica. Antes de poder associá-los a uma fila de tarefas, os ambientes de computação devem estar no estado `VALID`. Você pode associar até três ambientes de computação a uma fila de tarefas.
**nota**
Todos os ambientes de computação associados a uma fila devem compartilhar o mesmo modelo de provisionamento. AWS Batch não é compatível com a mistura de modelos de provisionamento em uma única fila de tarefas.
1. Em **Computar Ordem de Provisionamento**, escolha as setas para cima e para baixo para configurar a ordem desejada.
1. Escolha **Criar Fila de Tarefas** para concluir e criar sua fila.
# Criar uma fila de trabalhos Amazon EKS
Conclua as etapas a seguir para criar uma fila de trabalho para o Amazon Elastic Kubernetes Service (Amazon EKS).
**Para criar uma fila de trabalhos Amazon EKS**
1. Abra o console AWS Batch em [https://console.aws.amazon.com/batch/](https://console.aws.amazon.com/batch/).
1. Na barra de navegação, selecione Região da AWS a ser usada.
1. No painel de navegação, escolha **Filas de Tarefas**.
1. Escolha **Criar**.
1. Em **Tipo de Orquestração**, escolha **Amazon Elastic Kubernetes Service (Amazon EKS)**.
1. Para **Nome**, insira um nome exclusivo para a sua fila de tarefas. Ele pode ter até 128 caracteres e conter letras minúsculas, maiúsculas, números e sublinhados (\$1).
1. Para **Prioridade**, insira um valor inteiro para a prioridade da fila de tarefas. As filas com prioridade mais alta serão executadas antes das filas com prioridade mais baixa associadas ao mesmo ambiente de computação. A prioridade é determinada em ordem decrescente. Por exemplo, uma fila de tarefas com valor de prioridade 10 tem preferência de programação em relação a uma fila com valor de prioridade 1.
1. (Opcional) Para **Política de Agendamento do Nome do Recurso da Amazon (ARN)**, escolha uma política de agendamento existente.
1. Em **Ambientes de Computação Conectados**, selecione um ou mais ambientes de computação da lista para associar à lista de tarefas. Selecione ambientes de computação na ordem que quiser que a fila tente posicionar a fila de tarefas. O programador de trabalhos usará a ordem do ambiente de computação para determinar o ambiente de computação responsável por iniciar uma tarefa específica. Antes de poder associá-los a uma fila de tarefas, os ambientes de computação devem estar no estado `VALID`. Você pode associar até três ambientes de computação a uma fila de tarefas.
**nota**
Todos os ambientes de computação associados a uma fila devem compartilhar o mesmo modelo de provisionamento. AWS Batch não é compatível com a mistura de modelos de provisionamento em uma única fila de tarefas.
**nota**
Todos os ambientes de computação associados a uma fila de trabalhos devem compartilhar a mesma arquitetura. AWS Batch não oferece suporte à mistura de tipos de arquitetura de ambiente de computação em uma única fila de tarefas.
1. Em **Computar Ordem de Provisionamento**, escolha as setas para cima e para baixo para configurar a ordem desejada.
1. Escolha **Criar Fila de Tarefas** para concluir e criar sua fila.
# Criar uma fila de trabalhos do SageMaker Training no AWS Batch
As filas de trabalhos do SageMaker Training se integram diretamente ao serviço SageMaker AI para fornecer agendamento de tarefas em tecnologia sem servidor, sem exigir que você gerencie a infraestrutura computacional subjacente.
## Pré-requisitos
Antes de criar uma lista de trabalhos do SageMaker Training, certifique-se de ter:
+ **Ambiente de serviço** — Um ambiente de serviço que define limites de capacidade. Para obter mais informações, consulte [Crie um ambiente de serviço em AWS Batch](create-service-environments.md).
+ **Permissões do IAM** — Permissões para criar e gerenciar filas de trabalhos AWS Batch e ambientes de serviço. Para obter mais informações, consulte [AWS Batch Políticas, funções e permissões do IAM](IAM_policies.md).
------
#### [ Create a SageMaker Training job queue (AWS Batch console) ]
1. Abra o console AWS Batch em [https://console.aws.amazon.com/batch/](https://console.aws.amazon.com/batch/).
1. No painel de navegação, escolha **Filas de trabalho** e **Criar**.
1. Em **Tipo de orquestração**, escolha **SageMaker Training**.
1. Em **Configuração da fila de trabalhos**:
1. Em **Nome**, insira o nome da fila de trabalho.
1. Em **Prioridade**, insira um valor entre 0 e 1000. Uma fila de trabalhos com maior prioridade tem preferência para ambientes de serviço.
1. (Opcional) Para **Política de Agendamento do Nome do Recurso da Amazon (ARN)**, escolha uma política de agendamento existente.
1. Para **Ambientes de serviços conectados**, selecione um ambiente de serviço da lista para associar à lista de tarefas.
1. (Opcional) Em **Limites de estado de trabalho**:
1. Em **Configuração incorreta**, escolha `SERVICE_ENVIRONMENT_MAX_RESOURCE` e insira o **Tempo máximo de execução (segundos) **.
1. Em **Capacidade**, escolha `INSUFFICIENT_INSTANCE_CAPACITY` e insira o **Tempo máximo de execução (segundos)**.
1. Selecione **Criar fila de trabalho**.
------
#### [ Create a SageMaker Training job queue (AWS CLI) ]
Use o comando `create-job-queue` para criar uma fila de trabalhos do SageMaker Training.
O exemplo a seguir cria uma fila de trabalhos básica do SageMaker Training que usa um ambiente de serviço:
```
aws batch create-job-queue \
--job-queue-name my-sm-training-fifo-jq \
--job-queue-type SAGEMAKER_TRAINING \
--priority 1 \
--service-environment-order order=1,serviceEnvironment=ExampleServiceEnvironment
```
Substitua *ExampleServiceEnvironment* pelo nome do seu ambiente de serviço.
Esse comando retorna uma saída semelhante à seguinte:
```
{
"jobQueueName": "my-sm-training-fifo-jq",
"jobQueueArn": "arn:aws:batch:region:account:job-queue/my-sm-training-fifo-jq"
}
```
Depois de criar sua fila de trabalhos, verifique se ela foi criada com sucesso e se está em um estado válido.
Use o comando `describe-job-queues` para visualizar detalhes sobre a lista de trabalhos:
```
aws batch describe-job-queues --job-queues my-sm-training-fifo-jq
```
Esse comando retorna uma saída semelhante à seguinte:
```
{
"jobQueues": [
{
"jobQueueName": "my-sm-training-fifo-jq",
"jobQueueArn": "arn:aws:batch:region:account:job-queue/my-sm-training-fifo-jq",
"state": "ENABLED",
"status": "VALID",
"statusReason": "JobQueue Healthy",
"priority": 1,
"computeEnvironmentOrder": [],
"serviceEnvironmentOrder": [
{
"order": 1,
"serviceEnvironment": "arn:aws:batch:region:account:service-environment/ExampleServiceEnvironment"
}
],
"jobQueueType": "SAGEMAKER_TRAINING",
"tags": {},
"jobStateTimeLimitActions": []
}
]
}
```
Verifique se:
+ O `state` é `ENABLED`
+ O `status` é `VALID`
+ O `statusReason` é `JobQueue Healthy`
+ O `jobQueueType` é `SAGEMAKER_TRAINING`
+ `serviceEnvironmentOrder` faz referência ao seu ambiente de serviço
------
# Modelo de fila de trabalhos
O seguinte é um modelo de fila de tarefas vazio. Você pode usar esse modelo para criar sua fila de trabalhos. Em seguida, você pode salvar essa fila de trabalhos em um arquivo e usá-la com a AWS CLI `--cli-input-json` opção. Para obter mais informações sobre esses parâmetros, consulte [CreateJobQueue](https://docs.aws.amazon.com/batch/latest/APIReference/API_CreateJobQueue.html) no *AWS Batch API Reference*.
**nota**
Você pode gerar o modelo de fila de trabalhos com o comando da AWS CLI a seguir.
```
$ aws batch create-job-queue --generate-cli-skeleton
```
```
{
"computeEnvironmentOrder": [
{
"computeEnvironment": "",
"order": 0
}
],
"jobQueueName": "",
"jobStateTimeLimitActions": [
{
"state": "RUNNABLE",
"action": "CANCEL",
"maxTimeSeconds": 0,
"reason": ""
}
],
"priority": 0,
"schedulingPolicyArn": "",
"state": "ENABLED",
"tags": {
"KeyName": ""
}
}
```