View a markdown version of this page

Armazenamento persistente para frotas gerenciadas por serviços - Nuvem de prazos

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 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 ouUpdateFleet.

Parâmetros de configuração

O persistentVolumeConfiguration objeto aceita os seguintes parâmetros. Para intervalos válidos e valores padrão, consulte CreateFleeta 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.