Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Konfigurasikan RES-ready AMI Dengan RES-ready Amazon Machine Images (AMI), Anda dapat melakukan pra-instal dependensi RES untuk instance desktop virtual (VDI) pada AMI kustom Anda. Menggunakan RES-ready AMI meningkatkan waktu boot untuk instance VDI menggunakan gambar yang sudah dipanggang sebelumnya. Menggunakan EC2 Image Builder, Anda dapat membangun dan mendaftarkan AMI Anda sebagai tumpukan perangkat lunak baru. Untuk informasi selengkapnya tentang Image Builder, lihat [Panduan Pengguna Image Builder](https://docs.aws.amazon.com/imagebuilder/latest/userguide/what-is-image-builder.html). Sebelum Anda mulai, Anda harus [menerapkan versi terbaru dari RES](update-the-product.md). **penting** RES-ready AMI yang dibuat sebelum RES 2025.06.01 tidak kompatibel dengan RES 2025.06.01 dan semua versi berikutnya. Saat memutakhirkan lingkungan RES Anda dari versi sebelum 2025.06.01 ke yang terbaru, Anda harus membangun kembali semua AMI. RES-ready **Topics** + [Siapkan peran IAM untuk mengakses lingkungan RES](#prepare-role) + [Buat komponen EC2 Image Builder](#image-builder-component) + [Siapkan resep EC2 Image Builder Anda](#prepare-recipe) + [Konfigurasikan infrastruktur EC2 Image Builder](#configure-ib-infrastructure) + [Konfigurasikan pipa gambar Image Builder](#image-builder-pipeline) + [Jalankan pipa gambar Image Builder](#run-image-pipeline) + [Daftarkan tumpukan perangkat lunak baru di RES](#register-res-ready-stack) ## Siapkan peran IAM untuk mengakses lingkungan RES Untuk mengakses layanan lingkungan RES dari EC2 Image Builder, Anda harus membuat atau memodifikasi peran IAM yang disebut. RES-EC2InstanceProfileForImageBuilder Untuk informasi tentang mengonfigurasi peran IAM untuk digunakan di Image Builder, lihat [AWS Identity and Access Management (IAM)](https://docs.aws.amazon.com/imagebuilder/latest/userguide/image-builder-setting-up.html#image-builder-IAM-prereq) di Panduan Pengguna *Image Builder*. **Peran Anda membutuhkan:** + Hubungan tepercaya yang mencakup layanan Amazon EC2. + AmazonS3ReadOnlyAccess, AmazonSSMManagedInstanceCore dan EC2InstanceProfileForImageBuilder kebijakan. ## Buat komponen EC2 Image Builder Ikuti petunjuk untuk [Membuat komponen menggunakan konsol Image Builder](https://docs.aws.amazon.com/imagebuilder/latest/userguide/create-component-console.html) di *Panduan Pengguna Image Builder*. **Masukkan detail komponen Anda:** 1. Untuk **Type**, pilih **Build**. 1. Untuk **sistem operasi Image (OS)**, pilih Linux atau Windows. 1. Untuk **nama Komponen**, masukkan nama yang bermakna seperti**research-and-engineering-studio-vdi-**. 1. Masukkan nomor versi komponen Anda dan tambahkan deskripsi secara opsional. ``` key : value ``` 1. Untuk **dokumen Definisi**, masukkan file definisi berikut. Jika Anda menemukan kesalahan, file YAMM sensitif terhadap ruang dan merupakan penyebab yang paling mungkin. **penting** Dalam file definisi, ganti **latest** di URI unduhan (`- source: 's3://research-engineering-studio-us-east-1/releases/{{latest}}/res-installation-scripts.tar.gz'`) dengan nomor versi yang tepat (misalnya,**2025.06**) jika versi lingkungan RES Anda bukan yang terbaru. ------ #### [ 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. Buat tag opsional apa pun dan pilih **Buat komponen**. ## Siapkan resep EC2 Image Builder Anda Resep EC2 Image Builder mendefinisikan gambar dasar yang akan digunakan sebagai titik awal Anda untuk membuat gambar baru, bersama dengan kumpulan komponen yang Anda tambahkan untuk menyesuaikan gambar Anda dan memverifikasi bahwa semuanya berfungsi seperti yang diharapkan. Anda harus membuat atau memodifikasi resep untuk membangun AMI target dengan dependensi perangkat lunak RES yang diperlukan. Untuk informasi selengkapnya tentang resep, lihat [Mengelola resep](https://docs.aws.amazon.com/imagebuilder/latest/userguide/manage-recipes.html). RES mendukung sistem operasi gambar berikut: + Amazon Linux 2 (x86 dan ARM64) + Amazon Linux 2023 (x86 dan ARM64) + RHEL 8 (x86), dan 9 (x86) + Berbatu Linux 9 (x86) + Ubuntu 22.04.3 (x86) + Ubuntu 24.04.3 (x86) + Server Windows 2019, 2022 (x86) + Windows 10, 11 (x86) **catatan** Dimulai dengan rilis 2026.03, Amazon Linux 2 dan RHEL 8 tidak lagi disertakan sebagai tumpukan perangkat lunak default. Tumpukan perangkat lunak khusus dengan sistem operasi ini masih dapat didaftarkan jika diperlukan. ------ #### [ Create a new recipe ] 1. Buka konsol [https://console.aws.amazon.com/imagebuilder](https://console.aws.amazon.com/imagebuilder) EC2 Image Builder di. 1. Di bawah **Sumber daya tersimpan**, pilih **Resep gambar**. 1. Pilih **Buat resep gambar**. 1. Masukkan nama unik dan nomor versi. 1. Pilih gambar dasar yang didukung oleh RES. 1. Di bawah **konfigurasi Instans**, instal agen SSM jika tidak diinstal sebelumnya. Masukkan informasi dalam **data Pengguna dan data** pengguna lain yang diperlukan. **catatan** Untuk informasi tentang cara menginstal agen SSM, lihat: [Menginstal Agen SSM secara manual pada instans EC2](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-manual-agent-install.html) untuk Linux. [Menginstal dan menghapus instalan Agen SSM secara manual pada instans EC2](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-win.html) untuk Windows Server. 1. Untuk resep berbasis Linux, tambahkan komponen Amazon-managed `aws-cli-version-2-linux` build ke resep. Untuk resep berbasis Windows, tambahkan komponen Amazon-managed `aws-cli-version-2-windows` build ke resep. Skrip instalasi RES menggunakan AWS CLI untuk menyediakan akses VDI ke nilai konfigurasi untuk pengaturan cluster DynamoDB. 1. Tambahkan komponen EC2 Image Builder yang dibuat untuk lingkungan Linux atau Windows Anda. **penting** Anda harus menambahkan komponen ini secara berurutan dengan komponen build `aws-cli-version-2-linux` (untuk Linux) atau ` aws-cli-version-2-windows` (untuk Windows) ditambahkan terlebih dahulu. ![Halaman komponen yang menampilkan komponen build ditambahkan](http://docs.aws.amazon.com/id_id/res/latest/ug/images/res-ami-build-components.png) 1. (Disarankan) Tambahkan komponen Amazon-managed `simple-boot-test-` pengujian untuk memverifikasi bahwa AMI dapat diluncurkan. Ini adalah rekomendasi minimum. Anda dapat memilih komponen pengujian lain yang memenuhi kebutuhan Anda. 1. Lengkapi bagian opsional apa pun jika diperlukan, tambahkan komponen lain yang diinginkan, dan pilih **Buat resep**. ------ #### [ Modify a recipe ] Jika Anda memiliki resep EC2 Image Builder yang sudah ada, Anda dapat menggunakannya dengan menambahkan komponen berikut: 1. Untuk resep berbasis Linux, tambahkan komponen Amazon-managed `aws-cli-version-2-linux` build ke resep. Untuk resep berbasis Windows, tambahkan komponen Amazon-managed `aws-cli-version-2-windows` build ke resep. Skrip instalasi RES menggunakan AWS CLI untuk menyediakan akses VDI ke nilai konfigurasi untuk pengaturan cluster DynamoDB. 1. Tambahkan komponen EC2 Image Builder yang dibuat untuk lingkungan Linux atau Windows Anda. **penting** Anda harus menambahkan komponen ini secara berurutan dengan komponen build `aws-cli-version-2-linux` (untuk Linux) atau ` aws-cli-version-2-windows` (untuk Windows) ditambahkan terlebih dahulu. ![Halaman komponen yang menampilkan komponen build ditambahkan](http://docs.aws.amazon.com/id_id/res/latest/ug/images/res-ami-build-components.png) 1. Lengkapi bagian opsional apa pun jika diperlukan, tambahkan komponen lain yang diinginkan, dan pilih **Buat resep**. ------ ## Konfigurasikan infrastruktur EC2 Image Builder Anda dapat menggunakan konfigurasi infrastruktur untuk menentukan infrastruktur Amazon EC2 yang digunakan Image Builder untuk membangun dan menguji image Image Builder Anda. Untuk digunakan dengan RES, Anda dapat memilih untuk membuat konfigurasi infrastruktur baru, atau menggunakan yang sudah ada. + Untuk membuat konfigurasi infrastruktur baru, lihat [Membuat konfigurasi infrastruktur](https://docs.aws.amazon.com/imagebuilder/latest/userguide/create-infra-config.html). + Untuk menggunakan konfigurasi infrastruktur yang ada, [Perbarui konfigurasi infrastruktur](https://docs.aws.amazon.com/imagebuilder/latest/userguide/update-infra-config.html). **Untuk mengonfigurasi infrastruktur Image Builder Anda:** 1. Untuk peran **IAM, masukkan peran** yang telah Anda konfigurasikan sebelumnya. [Siapkan peran IAM untuk mengakses lingkungan RES](#prepare-role) 1. Untuk **tipe Instance**, pilih tipe dengan memori minimal 4 GB dan dukung arsitektur AMI dasar pilihan Anda. Lihat [jenis Instans Amazon EC2](https://aws.amazon.com/ec2/instance-types/). 1. Untuk **VPC, subnet, dan grup keamanan,** Anda harus mengizinkan akses internet untuk mengunduh paket perangkat lunak. Akses juga harus diizinkan ke tabel `cluster-settings` DynamoDB dan bucket cluster Amazon S3 dari lingkungan RES. ## Konfigurasikan pipa gambar Image Builder Pipeline image Builder Image Builder merakit image dasar, komponen untuk pembuatan dan pengujian, konfigurasi infrastruktur, dan pengaturan distribusi. Untuk mengonfigurasi pipeline gambar untuk RES-ready AMI, Anda dapat memilih untuk membuat pipeline baru, atau menggunakan pipeline yang sudah ada. Untuk informasi selengkapnya, lihat [Membuat dan memperbarui pipeline gambar AMI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/ami-image-pipelines.html) di *Panduan Pengguna Image Builder*. ------ #### [ Create a new Image Builder pipeline ] 1. Buka konsol Image Builder di[https://console.aws.amazon.com/imagebuilder](https://console.aws.amazon.com/imagebuilder). 1. Dari panel navigasi, pilih **Pipeline gambar**. 1. Pilih **Buat pipeline gambar**. 1. Tentukan detail pipeline Anda dengan memasukkan nama unik, deskripsi opsional, jadwal, dan frekuensi. 1. Untuk **Pilih resep**, pilih **Gunakan resep yang ada** dan pilih resep yang dibuat di[Siapkan resep EC2 Image Builder Anda](#prepare-recipe). Verifikasi bahwa detail resep Anda benar. 1. Untuk **proses pembuatan gambar**, pilih alur kerja default atau kustom tergantung pada kasus penggunaan. Dalam kebanyakan kasus, alur kerja default sudah cukup. Untuk informasi selengkapnya, lihat [Mengonfigurasi alur kerja gambar untuk pipeline EC2 Image Builder](https://docs.aws.amazon.com/imagebuilder/latest/userguide/pipeline-workflows.html). 1. Untuk **Tentukan konfigurasi infrastruktur**, pilih **Pilih konfigurasi infrastruktur yang ada** dan pilih konfigurasi infrastruktur yang dibuat[Konfigurasikan infrastruktur EC2 Image Builder](#configure-ib-infrastructure). Verifikasi bahwa detail infrastruktur Anda sudah benar. 1. Untuk **Tentukan setelan distribusi**, pilih **Buat setelan distribusi menggunakan default layanan**. Gambar output harus berada sama dengan lingkungan AWS Region RES Anda. Menggunakan default layanan, gambar akan dibuat di Wilayah tempat Image Builder digunakan. 1. Tinjau detail pipeline dan pilih **Create pipeline**. ------ #### [ Modify an existing Image Builder pipeline ] 1. Untuk menggunakan pipeline yang ada, ubah detail untuk menggunakan resep yang dibuat[Siapkan resep EC2 Image Builder Anda](#prepare-recipe). 1. Pilih **Simpan perubahan**. ------ ## Jalankan pipa gambar Image Builder Untuk menghasilkan gambar keluaran yang dikonfigurasi, Anda harus memulai pipeline gambar. Proses pembangunan berpotensi memakan waktu hingga satu jam tergantung pada jumlah komponen dalam resep gambar. **Untuk menjalankan pipeline gambar:** 1. Dari **pipeline Image**, pilih pipeline yang dibuat di[Konfigurasikan pipa gambar Image Builder](#image-builder-pipeline). 1. Dari **Tindakan**, pilih **Jalankan pipeline**. ## Daftarkan tumpukan perangkat lunak baru di RES 1. Ikuti petunjuk [Tumpukan Perangkat Lunak (AMI)](software-stacks.md) untuk mendaftarkan tumpukan perangkat lunak. 1. Untuk **ID AMI**, masukkan ID AMI dari gambar keluaran bawaan[Jalankan pipa gambar Image Builder](#run-image-pipeline).