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á. # Configurar RES-ready AMIs Com o RES-ready Amazon Machine Images (AMIs), você pode pré-instalar dependências RES para instâncias de desktop virtual (VDIs) em suas AMIs personalizadas. O uso de RES-ready AMIs melhora os tempos de inicialização das instâncias de VDI usando as imagens pré-criadas. Usando o EC2 Image Builder, você pode criar e registrar suas AMIs como novas pilhas de software. Para obter mais informações sobre o Image Builder, consulte o [Guia do usuário do Image Builder](https://docs.aws.amazon.com/imagebuilder/latest/userguide/what-is-image-builder.html). Antes de começar, você deve [implantar a versão mais recente do RES](update-the-product.md). **Importante** RES-ready As AMIs criadas antes do RES 2025.06.01 são incompatíveis com o RES 2025.06.01 e todas as versões subsequentes. Ao atualizar seu ambiente RES de uma versão anterior à 2025.06.01 para a mais recente, você deve reconstruir todas as AMIs. RES-ready **Topics** + [Prepare uma função do IAM para acessar o ambiente RES](#prepare-role) + [Crie o componente EC2 Image Builder](#image-builder-component) + [Prepare sua receita do EC2 Image Builder](#prepare-recipe) + [Configurar a infraestrutura do EC2 Image Builder](#configure-ib-infrastructure) + [Configurar o pipeline de imagens do Image Builder](#image-builder-pipeline) + [Execute o pipeline de imagens do Image Builder](#run-image-pipeline) + [Registre uma nova pilha de software no RES](#register-res-ready-stack) ## Prepare uma função do IAM para acessar o ambiente RES Para acessar o serviço de ambiente RES a partir do EC2 Image Builder, você deve criar ou modificar uma função RES-EC2InstanceProfileForImageBuilder do IAM chamada. Para obter informações sobre como configurar uma função do IAM para uso no Image Builder, consulte [AWS Identity and Access Management (IAM)](https://docs.aws.amazon.com/imagebuilder/latest/userguide/image-builder-setting-up.html#image-builder-IAM-prereq) no *Guia do usuário do Image Builder*. **Sua função exige:** + Relacionamentos confiáveis que incluem o serviço Amazon EC2. + AmazonS3ReadOnlyAccess AmazonSSMManagedInstanceCore e EC2InstanceProfileForImageBuilder políticas. ## Crie o componente EC2 Image Builder Siga as instruções para [Criar um componente usando o console do Image Builder](https://docs.aws.amazon.com/imagebuilder/latest/userguide/create-component-console.html) no *Guia do usuário do Image Builder*. **Insira os detalhes do seu componente:** 1. Em **Tipo**, escolha **Construir**. 1. Para **Sistema operacional (SO) de imagem**, escolha Linux ou Windows. 1. Em **Nome do componente**, insira um nome significativo, como**research-and-engineering-studio-vdi-**. 1. Insira o número da versão do seu componente e, opcionalmente, adicione uma descrição. ``` key : value ``` 1. Para o **documento de definição**, insira o arquivo de definição a seguir. Se você encontrar algum erro, o arquivo YAML é sensível ao espaço e é a causa mais provável. **Importante** No arquivo de definição, **latest** substitua o URI de download (`- source: 's3://research-engineering-studio-us-east-1/releases/{{latest}}/res-installation-scripts.tar.gz'`) pelo número exato da versão (por exemplo,**2025.06**) se a versão do seu ambiente RES não for a mais recente. ------ #### [ Linux ] ``` # Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. # # Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance # with the License. A copy of the License is located at # # http://www.apache.org/licenses/LICENSE-2.0 # # or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES # OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions # and limitations under the License. name: research-and-engineering-studio-vdi-linux description: An RES EC2 Image Builder component to install required RES software dependencies for Linux VDI. schemaVersion: 1.0 parameters: - GPUFamily: type: string description: GPU family (NONE, NVIDIA, or AMD) default: NONE phases: - name: build steps: - name: PrepareRESBootstrap action: ExecuteBash onFailure: Abort maxAttempts: 3 inputs: commands: - "mkdir -p /root/bootstrap/logs" - "mkdir -p /root/bootstrap/latest" - name: DownloadRESLinuxInstallPackage action: S3Download onFailure: Abort maxAttempts: 3 inputs: - source: "s3://research-engineering-studio-us-east-1/releases/latest/res-installation-scripts.tar.gz" destination: "/root/bootstrap/res-installation-scripts/res-installation-scripts.tar.gz" - name: RunInstallScript action: ExecuteBash onFailure: Abort maxAttempts: 3 inputs: commands: - "cd /root/bootstrap/res-installation-scripts" - "tar -xf res-installation-scripts.tar.gz" - "cd scripts/virtual-desktop-host/linux" - "/bin/bash install.sh -g {{ GPUFamily }}" - name: RebootAfterInstall action: Reboot onFailure: Abort maxAttempts: 3 inputs: delaySeconds: 0 - name: RunInstallPostRebootScript action: ExecuteBash onFailure: Abort maxAttempts: 3 inputs: commands: - "cd /root/bootstrap/res-installation-scripts/scripts/virtual-desktop-host/linux" - 'sed -i ''/^export AWS_DEFAULT_PROFILE="bootstrap_profile"$/d'' install_post_reboot.sh' - "/bin/bash install_post_reboot.sh -g {{ GPUFamily }}" - name: PreventAL2023FromUninstallingCronie action: ExecuteBash onFailure: Abort maxAttempts: 3 inputs: commands: - "rm -f /tmp/imagebuilder_service/crontab_installed" ``` ------ #### [ Windows ] ``` # Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. # # Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance # with the License. A copy of the License is located at # # http://www.apache.org/licenses/LICENSE-2.0 # # or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES # OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions # and limitations under the License. name: research-and-engineering-studio-vdi-windows description: An RES EC2 Image Builder component to install required RES software dependencies for Windows VDI. schemaVersion: 1.0 phases: - name: build steps: - name: CreateRESBootstrapFolder action: CreateFolder onFailure: Abort maxAttempts: 3 inputs: - path: 'C:\Users\Administrator\RES\Bootstrap' overwrite: true - name: DownloadRESWindowsInstallPackage action: S3Download onFailure: Abort maxAttempts: 3 inputs: - source: 's3://research-engineering-studio-us-east-1/releases/latest/res-installation-scripts.tar.gz' destination: '{{ build.CreateRESBootstrapFolder.inputs[0].path }}\res-installation-scripts.tar.gz' - name: RunInstallScript action: ExecutePowerShell onFailure: Abort maxAttempts: 3 inputs: commands: - 'cd {{ build.CreateRESBootstrapFolder.inputs[0].path }}' - 'tar -xf res-installation-scripts.tar.gz' - 'Import-Module .\scripts\virtual-desktop-host\windows\Install.ps1' - 'Install-WindowsEC2Instance -PrebakeAMI' ``` ------ 1. Crie qualquer tag opcional e escolha **Criar componente**. ## Prepare sua receita do EC2 Image Builder Uma fórmula do EC2 Image Builder define a imagem base a ser usada como ponto de partida para criar uma nova imagem, junto com o conjunto de componentes que você adiciona para personalizar sua imagem e verificar se tudo funciona conforme o esperado. Você deve criar ou modificar uma receita para construir a AMI de destino com as dependências de software RES necessárias. Para obter mais informações sobre receitas, consulte [Gerenciar receitas](https://docs.aws.amazon.com/imagebuilder/latest/userguide/manage-recipes.html). O RES suporta os seguintes sistemas operacionais de imagem: + Amazon Linux 2 (x86 e ARM64) + Amazon Linux 2023 (x86 e ARM64) + RHEL 8 (x86) e 9 (x86) + Rocky Linux 9 (x86) + Ubuntu 22.04.3 (x86) + Ubuntu 24.04.3 (x86) + Windows Server 2019, 2022 (x86) + Windows 10, 11 (x86) **nota** A partir da versão 2026.03, o Amazon Linux 2 e o RHEL 8 não estão mais incluídos como pilhas de software padrão. As pilhas de software personalizadas com esses sistemas operacionais ainda podem ser registradas, se necessário. ------ #### [ Create a new recipe ] 1. Abra o console [https://console.aws.amazon.com/imagebuilder](https://console.aws.amazon.com/imagebuilder) do EC2 Image Builder em. 1. Em **Recursos salvos**, escolha **Receitas de imagens**. 1. Escolha **Criar fórmula de imagem.** 1. Insira um nome exclusivo e um número de versão. 1. Selecione uma imagem base compatível com RES. 1. Em **Configuração da instância**, instale um agente SSM se um não vier pré-instalado. Insira as informações em **Dados do usuário** e quaisquer outros dados necessários do usuário. **nota** Para obter informações sobre como instalar um agente SSM, consulte: [Instalação manual do SSM Agent em instâncias do EC2 para Linux](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-manual-agent-install.html). [Instalando e desinstalando manualmente o SSM Agent em instâncias do EC2 para Windows Server](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-win.html). 1. Para receitas baseadas em Linux, adicione o componente de Amazon-managed `aws-cli-version-2-linux` compilação à receita. Para receitas baseadas em Windows, adicione o componente de Amazon-managed `aws-cli-version-2-windows` compilação à receita. Os scripts de instalação do RES usam o AWS CLI para fornecer acesso VDI aos valores de configuração das configurações de cluster do DynamoDB. 1. Adicione o componente EC2 Image Builder criado para seu ambiente Linux ou Windows. **Importante** Você deve adicionar esses componentes em ordem, com o componente de compilação `aws-cli-version-2-linux` ` aws-cli-version-2-windows` (para Linux) ou (para Windows) adicionado primeiro. ![Página de componentes mostrando componentes de construção adicionados](http://docs.aws.amazon.com/pt_br/res/latest/ug/images/res-ami-build-components.png) 1. (Recomendado) Adicione o componente Amazon-managed `simple-boot-test-` de teste para verificar se a AMI pode ser iniciada. Essa é uma recomendação mínima. Você pode selecionar outros componentes de teste que atendam às suas necessidades. 1. Complete todas as seções opcionais, se necessário, adicione outros componentes desejados e escolha **Criar receita**. ------ #### [ Modify a recipe ] Se você tiver uma receita existente do EC2 Image Builder, poderá usá-la adicionando os seguintes componentes: 1. Para receitas baseadas em Linux, adicione o componente de Amazon-managed `aws-cli-version-2-linux` compilação à receita. Para receitas baseadas em Windows, adicione o componente de Amazon-managed `aws-cli-version-2-windows` compilação à receita. Os scripts de instalação do RES usam o AWS CLI para fornecer acesso VDI aos valores de configuração das configurações de cluster do DynamoDB. 1. Adicione o componente EC2 Image Builder criado para seu ambiente Linux ou Windows. **Importante** Você deve adicionar esses componentes em ordem, com o componente de compilação `aws-cli-version-2-linux` ` aws-cli-version-2-windows` (para Linux) ou (para Windows) adicionado primeiro. ![Página de componentes mostrando componentes de construção adicionados](http://docs.aws.amazon.com/pt_br/res/latest/ug/images/res-ami-build-components.png) 1. Complete todas as seções opcionais, se necessário, adicione outros componentes desejados e escolha **Criar receita**. ------ ## Configurar a infraestrutura do EC2 Image Builder Você pode usar configurações de infraestrutura para especificar a infraestrutura do Amazon EC2 que o Image Builder usa para criar e testar sua imagem do Image Builder. Para uso com RES, você pode optar por criar uma nova configuração de infraestrutura ou usar uma existente. + Para criar uma nova configuração de infraestrutura, consulte [Criar uma configuração de infraestrutura](https://docs.aws.amazon.com/imagebuilder/latest/userguide/create-infra-config.html). + Para usar uma configuração de infraestrutura existente, [atualize uma configuração de infraestrutura](https://docs.aws.amazon.com/imagebuilder/latest/userguide/update-infra-config.html). **Para configurar sua infraestrutura do Image Builder:** 1. Para a **função do IAM**, insira a função na qual você configurou anteriormente[Prepare uma função do IAM para acessar o ambiente RES](#prepare-role). 1. Em **Tipo de instância**, escolha um tipo com pelo menos 4 GB de memória e que seja compatível com a arquitetura básica de AMI de sua escolha. Veja os [tipos de instância do Amazon EC2](https://aws.amazon.com/ec2/instance-types/). 1. Para **VPC, sub-rede e grupos de segurança,** você deve permitir o acesso à Internet para baixar pacotes de software. O acesso também deve ser permitido à tabela do `cluster-settings` DynamoDB e ao bucket do cluster Amazon S3 do ambiente RES. ## Configurar o pipeline de imagens do Image Builder O pipeline de imagens do Image Builder reúne a imagem base, os componentes para construção e teste, a configuração da infraestrutura e as configurações de distribuição. Para configurar um pipeline de imagem para RES-ready AMIs, você pode optar por criar um novo pipeline ou usar um existente. Para obter mais informações, consulte [Criar e atualizar pipelines de imagem da AMI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/ami-image-pipelines.html) no *Guia do usuário do Image Builder*. ------ #### [ Create a new Image Builder pipeline ] 1. Abra o console do Image Builder em[https://console.aws.amazon.com/imagebuilder](https://console.aws.amazon.com/imagebuilder). 1. No painel de navegação, escolha **Pipelines de imagem**. 1. Escolha **Criar pipeline de imagens**. 1. Especifique os detalhes do seu funil inserindo um nome exclusivo, uma descrição opcional, uma programação e uma frequência. 1. Em **Escolher receita**, escolha **Usar receita existente** e selecione a receita criada em[Prepare sua receita do EC2 Image Builder](#prepare-recipe). Verifique se os detalhes da receita estão corretos. 1. Em **Definir processo de criação de imagem**, escolha o fluxo de trabalho padrão ou personalizado, dependendo do caso de uso. Na maioria dos casos, os fluxos de trabalho padrão são suficientes. Para obter mais informações, consulte [Configurar fluxos de trabalho de imagem para seu pipeline do EC2 Image Builder](https://docs.aws.amazon.com/imagebuilder/latest/userguide/pipeline-workflows.html). 1. Em **Definir configuração de infraestrutura**, **escolha Escolher configuração de infraestrutura existente** e selecione a configuração de infraestrutura criada em[Configurar a infraestrutura do EC2 Image Builder](#configure-ib-infrastructure). Verifique se os detalhes da sua infraestrutura estão corretos. 1. Em **Definir configurações de distribuição**, escolha **Criar configurações de distribuição usando padrões de serviço**. A imagem de saída deve residir no Região da AWS mesmo ambiente do RES. Usando padrões de serviço, a imagem será criada na região em que o Image Builder é usado. 1. Analise os detalhes do funil e escolha **Criar funil**. ------ #### [ Modify an existing Image Builder pipeline ] 1. Para usar um pipeline existente, modifique os detalhes para usar a receita criada em[Prepare sua receita do EC2 Image Builder](#prepare-recipe). 1. Escolha **Salvar alterações**. ------ ## Execute o pipeline de imagens do Image Builder Para produzir a imagem de saída configurada, você deve iniciar o pipeline de imagem. O processo de construção pode levar até uma hora, dependendo do número de componentes na receita da imagem. **Para executar o pipeline de imagens:** 1. Em **Pipelines de imagem**, selecione o pipeline criado em[Configurar o pipeline de imagens do Image Builder](#image-builder-pipeline). 1. Em **Ações**, escolha **Executar pipeline**. ## Registre uma nova pilha de software no RES 1. Siga as instruções [Pilhas de software (AMIs)](software-stacks.md) para registrar uma pilha de software. 1. Em **ID da AMI**, insira a ID da AMI da imagem de saída incorporada[Execute o pipeline de imagens do Image Builder](#run-image-pipeline).