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á.
# Armazenamento persistente para frotas gerenciadas por serviços
AWS O armazenamento persistente Deadline Cloud (Deadline Cloud) anexa volumes gp3 dedicados do Amazon Elastic Block Store (Amazon EBS) aos trabalhadores da frota gerenciados pelo serviço. Esses volumes preservam dados como instalações de pacotes conda, caches de aplicativos e espaços de trabalho de controle de versão em todos os eventos do ciclo de vida do trabalhador. Para uma visão geral conceitual, consulte [Armazenamento persistente para frotas gerenciadas por serviços](https://docs.aws.amazon.com/deadline-cloud/latest/userguide/volumes.html) no Guia do usuário do *AWS Deadline* Cloud.
## Configuração da frota
Para habilitar o armazenamento persistente, inclua o `persistentVolumeConfiguration` objeto no `serviceManagedEc2FleetConfiguration` quando você chama `CreateFleet` ou`UpdateFleet`.
### Parâmetros de configuração
O `persistentVolumeConfiguration` objeto aceita os seguintes parâmetros. Para intervalos válidos e valores padrão, consulte [CreateFleet](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/API_CreateFleet.html)a *Referência da API Deadline Cloud*.
| Parâmetro | Tipo | Obrigatório | Description |
| --- | --- | --- | --- |
| sizeGiB | Inteiro | Não | O tamanho do volume persistente em GiB. |
| iops | Inteiro | Não | O IOPS provisionado para o volume gp3. |
| throughputMiB | Inteiro | Não | A taxa de transferência provisionada MiB/s para o volume gp3. |
| mountPath | String | Sim | O local de montagem no trabalhador. ParaLinux, especifique um caminho absoluto (por exemplo,/mnt/persistent). ParaWindows, especifique uma letra de drive (por exemplo,D:). |
| lastUsedTtlHours | Inteiro | Não | O número de horas após o último uso de um volume antes da limpeza automática. |
### Crie uma frota com armazenamento persistente
O AWS CLI exemplo a seguir cria uma frota gerenciada por serviços com o armazenamento persistente ativado:
```
aws deadline create-fleet \
--farm-id {{farm-0123456789abcdef0}} \
--display-name "Rendering Fleet" \
--max-worker-count 20 \
--configuration '{
"serviceManagedEc2FleetConfiguration": {
"instanceCapabilities": {
"vCpuCount": {"min": 4, "max": 16},
"memoryMiB": {"min": 16384, "max": 65536},
"osFamily": "LINUX",
"rootEbsVolume": {"sizeGiB": 250}
},
"instanceMarketOptions": {"type": "spot"},
"persistentVolumeConfiguration": {
"sizeGiB": 2048,
"iops": 16000,
"throughputMiB": 500,
"mountPath": "/mnt/persistent",
"lastUsedTtlHours": 168
}
}
}'
```
### Atualizar a configuração de armazenamento persistente
O AWS CLI exemplo a seguir adiciona armazenamento persistente a uma frota existente:
```
aws deadline update-fleet \
--farm-id {{farm-0123456789abcdef0}} \
--fleet-id {{fleet-0123456789abcdef0}} \
--configuration '{
"serviceManagedEc2FleetConfiguration": {
"instanceCapabilities": {
"vCpuCount": {"min": 4, "max": 16},
"memoryMiB": {"min": 16384, "max": 65536},
"osFamily": "LINUX",
"rootEbsVolume": {"sizeGiB": 250}
},
"instanceMarketOptions": {"type": "spot"},
"persistentVolumeConfiguration": {
"sizeGiB": 2048,
"iops": 16000,
"throughputMiB": 500,
"mountPath": "/mnt/persistent",
"lastUsedTtlHours": 168
}
}
}'
```
Para desativar o armazenamento persistente, omita o `persistentVolumeConfiguration` objeto da configuração da frota em uma `UpdateFleet` chamada. O Deadline Cloud limpa automaticamente os volumes existentes quando eles não estão mais conectados a um funcionário.
## Operações de gerenciamento de volumes
Você pode usar as seguintes operações para gerenciar volumes persistentes:
### GetVolume
Recupera informações detalhadas sobre um volume persistente específico.
**Solicitação**
```
aws deadline get-volume \
--farm-id {{farm-0123456789abcdef0}} \
--fleet-id {{fleet-0123456789abcdef0}} \
--volume-id {{volume-0123456789abcdef0}}
```
**Resposta**
```
{
"volumeId": "volume-0123456789abcdef0",
"fleetId": "fleet-0123456789abcdef0",
"farmId": "farm-0123456789abcdef0",
"state": "AVAILABLE",
"volumeType": "gp3",
"sizeGiB": 2048,
"iops": 16000,
"throughputMiB": 500,
"availabilityZone": "us-west-2a",
"attachedWorkerId": null,
"createdAt": "2024-01-15T10:30:00Z",
"lastAttachedAt": "2024-11-15T14:22:00Z",
"ttl": "2024-11-22T14:22:00Z"
}
```
O `state` campo indica o estado atual do volume. Os valores possíveis são:
+ `AVAILABLE`— O volume está separado e pronto para ser anexado.
+ `IN_USE`— O volume está atualmente anexado a um trabalhador.
+ `PENDING_CREATION`— O volume está sendo criado.
+ `PENDING_ATTACHMENT`— O volume é reservado para ser anexado a um trabalhador.
+ `PENDING_DELETION`— O volume está marcado para exclusão.
## Variável de ambiente
Quando o armazenamento persistente é montado com sucesso, o Deadline Cloud define a seguinte variável de ambiente no trabalhador:
```
DEADLINE_PERSISTENT_MOUNT={{/mnt/persistent}}
```
O valor da variável de ambiente é o caminho de montagem que você especificou na configuração da frota. Essa variável de ambiente está disponível para todos os processos de trabalho em execução no trabalhador, incluindo scripts de configuração do host e ações do modelo de trabalho.
Os seguintes consumidores de tempo de execução usam automaticamente o armazenamento persistente quando a variável de ambiente está presente:
+ **Ambientes de fila Conda** — Armazena instalações de pacotes no volume persistente.
+ Cache **imutável do VFS — armazena o cache** de ativos no volume persistente.
Você pode referenciar a variável de ambiente em seus modelos de trabalho do Open Job Description para armazenar dados personalizados no volume persistente. O exemplo a seguir mostra uma etapa que grava a saída no armazenamento persistente:
```
steps:
- name: ProcessAssets
script:
actions:
onRun:
command: bash
args:
- "-c"
- |
CACHE_DIR="${DEADLINE_PERSISTENT_MOUNT}/my-app-cache"
mkdir -p "$CACHE_DIR"
# Your processing logic here
```
## Comportamento de mudança de configuração
A tabela a seguir descreve como as alterações de configuração afetam os volumes persistentes existentes:
| Alteração | Comportamento |
| --- | --- |
| Aumente o IOPS ou a taxa de transferência | O Deadline Cloud aplica as alterações antes da próxima anexação do volume. |
| Diminua o IOPS ou a taxa de transferência | O Deadline Cloud aplica as alterações antes da próxima anexação do volume. |
| Aumentar o tamanho do volume | O Deadline Cloud aumenta o volume antes do próximo anexo e expande o sistema de arquivos automaticamente durante a inicialização do trabalhador. |
| Diminuir tamanho do volume | Sem compatibilidade. Os volumes do Amazon EBS não podem ser reduzidos em tamanho. |
| Alterar caminho de montagem | Aplica-se somente a novos trabalhadores. Os trabalhadores existentes mantêm sua trajetória de montagem atual. |
| Remova o armazenamento persistente | O Deadline Cloud marca os volumes existentes para exclusão e os limpa quando não estão mais conectados a um trabalhador. |