View a markdown version of this page

registros de imagem de exportação do pcluster - AWS ParallelCluster
Argumentos nomeados

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

registros de imagem de exportação do pcluster

Exporta os logs da pilha do construtor de imagens para um arquivo tar.gz local passando por um bucket do Amazon S3.

pcluster export-image-logs [-h]
                 --image-id IMAGE_ID
                [--bucket BUCKET]
                [--bucket-prefix BUCKET_PREFIX]
                [--debug]                         
                [--end-time END_TIME]
                [--keep-s3-objects KEEP_S3_OBJECTS]
                [--output-file OUTPUT_FILE]
                [--region REGION]
                [--start-time START_TIME]
nota

O export-image-logs comando espera que o CloudWatch Logs conclua a exportação dos registros, portanto, espera-se que ele passe um período sem nenhuma saída.

Argumentos nomeados

-h, --help

Mostra o texto de ajuda para pcluster export-image-logs.

--bucket BUCKET_NAME

Especifica o nome do bucket do Amazon S3 para o qual exportar logs criação de imagem. Deve estar na mesma região da imagem.

nota

  • Você deve adicionar permissões à política de bucket do Amazon S3 para conceder CloudWatch acesso. Para obter mais informações, consulte Definir permissões em um bucket do Amazon S3 no Guia do usuário de CloudWatch registros.

  • A partir da AWS ParallelCluster versão 3.12.0, a --bucket opção é opcional. Se a opção não for especificada, o bucket padrão AWS ParallelCluster regional (parallelcluster-hash-v1-DO-NOT-DELETE) será usado ou, se CustomS3Bucket for especificado na configuração da imagem, ele será usado.

Importante

Se o bucket AWS ParallelCluster padrão for usado, o pcluster se encarregará de configurar a política do bucket. Se você personalizar a política de bucket antes de atualizar para a AWS ParallelCluster versão 3.12.0, a política de bucket será substituída e você precisará reaplicar as alterações.

--image-id, -i IMAGE_ID

O ID da imagem cujos logs serão exportados.

--bucket-prefix BUCKET_PREFIX

Especifica o caminho no bucket do Amazon S3 para o qual os dados de log exportados devem ser armazenados.

Por padrão, o prefixo do bucket é:

ami-id-logs-202209061743.tar.gz

202209061743 é a hora atual no formato %Y%m%d%H%M.

nota

A partir da AWS ParallelCluster versão 3.12.0, se você não especificar a --bucket opção e usar o AWS ParallelCluster bucket padrão, não poderá exportar registros para a parallelcluster/ pasta, pois é uma pasta protegida reservada para uso interno.

--debug

Habilita o log de depuração.

--end-time END_TIME

Especifica o final do intervalo de tempo para coletar eventos de log, expresso no formato ISO 8601 (YYYY-MM-DDThh:mm:ssZ, por exemplo 2021-01-01T20:00:00Z'). Eventos com uma marca de data/hora igual ou posterior a esse horário não estão incluídos. Elementos de tempo (por exemplo, minutos e segundos) podem ser omitidos. O valor padrão é o horário atual.

--keep-s3-objects KEEP_S3_OBJECTS

Se for true, as exportações de objetos exportados para o Amazon S3 serão mantidas. (Padronizado como false.)

--output-file OUTPUT_FILE

Especifica o caminho do arquivo onde será salvo o arquivamento de log. Se isso for fornecido, os logs serão salvos localmente. Caso contrário, eles serão enviados para o Amazon S3 com o URL retornado na saída. O padrão é fazer upload para o Amazon S3.

--region, -r REGION

Especifica o a Região da AWS ser usado. O Região da AWS deve ser especificado usando a variável de AWS_DEFAULT_REGION ambiente, a region configuração na [default] seção do ~/.aws/config arquivo ou o --region parâmetro.

--start-time START_TIME

Especifica o início do intervalo de tempo, expresso no formato ISO 8601 (YYYY-MM-DDThh:mm:ssZ, por exemplo 2021-01-01T20:00:00Z). Eventos de log com uma marca de data/hora igual ou posterior a esse horário estão incluídos. Se não for especificado, o padrão é a hora em que o cluster foi criado.

Exemplo usando a AWS ParallelCluster versão 3.1.4:

$ pcluster export-image-logs --bucket image-v3-bucket --image-id ami-1234abcd5678efgh
{
  "url": "https://image-v3-bucket..."
}