View a markdown version of this page

Trabalhando com dados de usuário do Amazon EC2 para AWS PEÇAS - AWS PEÇAS

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

Trabalhando com dados de usuário do Amazon EC2 para AWS PEÇAS

nota

Para a maioria das tarefas de configuração do nó, recomendamos ações do ciclo de vida do nó. Eles fornecem API-native configuração reutilizável com tratamento de erros por script e controle de reinicialização. Use os dados do usuário do modelo de lançamento para tarefas que devem ser executadas antes do início do agente AWS PCS. Para obter mais informações, consulte Ações do ciclo de vida dos nós.

Você pode fornecer dados de usuário do EC2 em seu modelo de execução que cloud-init é executado quando suas instâncias são iniciadas. Os blocos de dados do usuário com o tipo de conteúdo são cloud-config executados antes do registro da instância na API AWS PCS, enquanto os blocos de dados do usuário com o tipo de conteúdo são text/x‑shellscript executados após a conclusão do registro, mas antes do início do daemon Slurm. Para obter mais informações sobre os tipos de conteúdo, consulte a documentação do cloud-init.

Nossos dados de usuário podem realizar cenários de configuração comuns, incluindo, mas não se limitando ao seguinte:

Os dados do usuário nos modelos de lançamento devem estar no formato de arquivamento https://cloudinit.readthedocs.io/en/latest/topics/format.html#mime-multi-part-archive MIME de várias partes. Isso ocorre porque seus dados de usuário são mesclados com outros dados de usuário do AWS PCS que são necessários para configurar nós em seu grupo de nós. É possível combinar vários blocos de dados de usuário em um único arquivo MIME de várias partes.

Um arquivo em várias partes MIME consiste nos seguintes componentes:

  • O tipo de conteúdo e a declaração de limite da parte: Content-Type: multipart/mixed; boundary="==BOUNDARY=="

  • A declaração da versão MIME: MIME-Version: 1.0

  • Um ou mais blocos de dados do usuário que contêm os seguintes componentes:

    • O limite de abertura, que sinaliza o início de um bloco de dados do usuário: --==BOUNDARY==. Você deve manter a linha antes desse limite em branco.

    • A declaração do tipo de conteúdo para o bloco: Content-Type: text/cloud-config; charset="us-ascii" ouContent-Type: text/x-shellscript; charset="us-ascii". Você deve manter a linha após o branco da declaração do tipo de conteúdo.

    • O conteúdo de dados do usuário, por exemplo, uma lista de comandos de shell ou diretivas do cloud-config.

  • O limite de fechamento que sinaliza o fim do arquivo MIME de várias partes: --==BOUNDARY==--. Você deve manter a linha antes do branco do limite de fechamento.

nota

Se você adicionar dados do usuário a um modelo de lançamento no console do Amazon EC2, poderá colá-los como texto sem formatação. Ou você pode fazer o upload de um arquivo. Se você usa o AWS CLI ou um AWS SDK, você deve primeiro codificar os dados do usuário em base64 e enviar essa string como o valor do UserData parâmetro ao chamar CreateLaunchTemplate, conforme mostrado neste arquivo JSON. 

{
    "LaunchTemplateName": "base64-user-data",
    "LaunchTemplateData": {
        "UserData": "ewogICAgIkxhdW5jaFRlbXBsYXRlTmFtZSI6ICJpbmNyZWFzZS1jb250YWluZXItdm9sdW..."
    }
}
Exemplos