AWS ParallelCluster Personalização da AMI

Há cenários em que AWS ParallelCluster é necessário criar uma AMI personalizada para. Esta seção aborda o que considerar ao criar uma AWS ParallelCluster AMI personalizada.

Você pode criar uma AWS ParallelCluster AMI personalizada usando um dos seguintes métodos:

1. Crie um arquivo de configuração de imagem de compilação e, em seguida, use a pcluster CLI para criar a imagem com o EC2 Image Builder. Esse processo é automatizado, repetível e oferece suporte ao monitoramento. Para obter mais informações, consulte os comandos de imagem pcluster.

2. Crie uma instância a partir de uma AWS ParallelCluster AMI, faça login nela e faça modificações manuais. Por último, use o Amazon EC2 para criar uma nova AMI a partir da instância modificada. Esse processo leva menos tempo. No entanto, ele não é automatizado nem repetível e não oferece suporte ao uso dos comandos de monitoramento de imagem da CLI pcluster.

Para ter mais informações sobre esses métodos, consulte Criação de uma AWS ParallelCluster AMI personalizada.

AWS ParallelCluster Considerações sobre a personalização da AMI

Independente de como você cria sua imagem personalizada, recomendamos que você realize testes preliminares de validação e inclua provisões para monitorar o status da imagem que está sendo criada.

Para criar uma AMI personalizada usando pcluster, você cria um arquivo de configuração de imagem de compilação com uma Build e seçãoImage que o EC2 Image Builder usa para criar sua imagem personalizada. A seção Build especifica o que o Image Builder precisa para criar a imagem. Isso inclui a ParentImage (imagem base) e Components. Um componente do Image Builder define uma sequência de etapas necessárias para personalizar uma instância antes que uma imagem seja criada ou para testar uma instância que foi executada pela imagem criada. Para exemplos de AWS ParallelCluster componentes, consulte AMIs personalizadas. A seção Image especifica as propriedades da imagem.

Quando chamado do pcluster build-imagepara criar uma imagem personalizada, o Image Builder usa a configuração da imagem de compilação com o AWS ParallelCluster livro de receitas para inicializar sua. AWS ParallelCluster ParentImage O Image Builder baixa componentes, executa fases de compilação e validação, cria a AMI, executa uma instância da AMI e executa testes. Quando o processo é concluído, o Image Builder produz uma nova imagem ou uma mensagem de interrupção.

Execute testes personalizados de validação de componentes

Antes de incluir um componente do Image Builder em uma configuração, teste e valide usando um dos métodos a seguir. Como o processo do Image Builder pode levar até 1 hora, recomendamos que você teste os componentes com antecedência. Isso pode economizar uma quantidade considerável de tempo.

Caso de script

Teste o script em uma instância em execução, fora do processo de criação da imagem, e verifique se o script sai com o código de saída 0.

Caso do nome do recurso da Amazon (ARN)

Teste o documento do componente em uma instância em execução, fora do processo de criação da imagem. Para obter uma lista dos requisitos, consulte Gerenciador de componentes no Guia do usuário do Image Builder.

Após a validação bem-sucedida, adicione o componente à sua configuração de imagem de compilação

Depois de verificar se o componente personalizado está funcionando, adicione-o ao arquivo de configuração de criação de imagem.

Monitore o processo do Image Builder com comandos pcluster para auxiliar na depuração

describe-image

Use esse comando para monitorar o status de criação da imagem.

list-image-log-streams

Use esse comando para obter os IDs dos fluxos de log que você pode usar para recuperar eventos de log com get-image-log-events.

get-image-log-events

Use esse comando para obter o fluxo de log dos eventos do processo de criação de imagem.

Por exemplo, você pode iniciar eventos da imagem usando o seguinte comando.

$ watch -n 1 'pcluster get-image-log-events -i <image-id> \
        --log-stream-name/1 <pcluster-version> \
        --query "events[*].message" | tail -n 50'

get-image-stack-events

Use esse comando para recuperar eventos da pilha de imagens para a pilha criada pelo Image Builder.

export-image-logs

Use este comando para salvar registros de imagens.

Para obter mais informações sobre AWS ParallelCluster registros e a Amazon CloudWatch, consulte Logs de imagem de compilação do Amazon CloudWatch Logs CloudWatch Painel da Amazon e.

Outras considerações

Novos AWS ParallelCluster lançamentos e AMIs personalizadas

Se você criar e usar uma AMI personalizada, será necessário repetir as etapas usadas para criar sua AMI personalizada com cada versão nova do AWS ParallelCluster .

Ações de bootstrap personalizadas

Revise a Ações de bootstrap personalizadas seção para determinar se as modificações que você deseja fazer podem ser programadas e suportadas em AWS ParallelCluster versões futuras.

Uso de AMIs personalizadas

Você pode especificar AMIs personalizadas na configuração do cluster nas seções Image / CustomAmi e Scheduling / SlurmQueues / - Name / Image / CustomAmi.

Para solucionar problemas de avisos de validação da AMI personalizada, consulte Solução de problemas de AMI personalizada.