Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Citra
Anda dapat membuat gambar WorkSpaces Aplikasi Amazon yang berisi aplikasi yang dapat Anda streaming ke pengguna Anda dan pengaturan sistem dan aplikasi default untuk memungkinkan pengguna Anda memulai aplikasi tersebut dengan cepat. Namun, setelah Anda membuat gambar, Anda tidak dapat mengubahnya. Untuk menambahkan aplikasi lain, memperbarui aplikasi yang ada, atau mengubah pengaturan gambar, Anda harus memulai dan menyambung kembali ke pembuat gambar yang Anda gunakan untuk membuat gambar. Jika Anda menghapus pembuat gambar itu, luncurkan pembuat gambar baru yang didasarkan pada gambar Anda. Kemudian buat perubahan Anda dan buat gambar baru. Untuk informasi selengkapnya, lihat [Luncurkan Image Builder untuk Menginstal dan Mengkonfigurasi Aplikasi Streaming](tutorial-image-builder-create.md) dan [Tutorial: Membuat Gambar WorkSpaces Aplikasi Kustom dengan Menggunakan Konsol WorkSpaces Aplikasi](tutorial-image-builder.md).
Gambar yang tersedia untuk Anda tercantum dalam **Image Registry** di konsol WorkSpaces Aplikasi. Mereka dikategorikan sebagai publik, pribadi, atau bersama. Anda dapat menggunakan salah satu jenis gambar ini untuk meluncurkan pembuat gambar dan menyiapkan armada WorkSpaces Aplikasi. Gambar bersama dimiliki oleh akun Amazon Web Services lainnya dan dibagikan dengan Anda. Izin yang ditetapkan pada gambar yang dibagikan dengan Anda dapat membatasi apa yang dapat Anda lakukan dengan gambar tersebut. Untuk informasi selengkapnya, lihat [Kelola Gambar WorkSpaces Aplikasi Amazon Anda](administer-images.md).
**Topics**
+ [Pengaturan Aplikasi dan Windows Default dan Kinerja Peluncuran Aplikasi di WorkSpaces Aplikasi Amazon](customizing-appstream-images.md)
+ [Kelola Versi Agen WorkSpaces Aplikasi](base-images-agent.md)
+ [WorkSpaces Catatan Rilis Agen Aplikasi](agent-software-versions.md)
+ [Tutorial: Membuat Gambar WorkSpaces Aplikasi Kustom dengan Menggunakan Konsol WorkSpaces Aplikasi](tutorial-image-builder.md)
+ [Kelola Gambar WorkSpaces Aplikasi Amazon Anda](administer-images.md)
+ [Buat Gambar WorkSpaces Aplikasi Amazon Anda Secara Terprogram dengan Menggunakan Operasi CLI Asisten Gambar](programmatically-create-image.md)
+ [Buat Gambar Berbasis Linux Anda](create-linux-based-images.md)
+ [Gunakan Skrip Sesi untuk Mengelola Pengalaman Streaming Pengguna WorkSpaces Aplikasi Amazon Anda](use-session-scripts.md)
# Pengaturan Aplikasi dan Windows Default dan Kinerja Peluncuran Aplikasi di WorkSpaces Aplikasi Amazon
Anda dapat membuat aplikasi default dan pengaturan Windows untuk memungkinkan pengguna Anda memulai aplikasi mereka dengan cepat, sehingga mereka tidak perlu membuat atau mengkonfigurasi pengaturan itu sendiri.
WorkSpaces Aplikasi mengoptimalkan kinerja peluncuran aplikasi Anda untuk sesi streaming pengguna Anda. Untuk memastikan bahwa semua file yang diperlukan disertakan dalam proses ini, Anda mungkin perlu menambahkan file dan folder tertentu secara manual ke manifes pengoptimalan.
**Topics**
+ [Membuat Aplikasi Default dan Pengaturan Windows untuk Pengguna WorkSpaces Aplikasi Anda](creating-default-app-Windows-settings.md)
+ [Mengoptimalkan Kinerja Peluncuran Aplikasi Anda di Aplikasi Amazon WorkSpaces](optimizing-app-launch-performance.md)
# Membuat Aplikasi Default dan Pengaturan Windows untuk Pengguna WorkSpaces Aplikasi Anda
Kustomisasi aplikasi dan pengaturan Windows yang disimpan ke folder profil pengguna Windows atau sarang registri pengguna dapat diatur sebagai default. Saat Anda menyimpan pengaturan default dengan menggunakan **Pengguna Template** di Asisten Gambar, WorkSpaces Aplikasi menggantikan profil pengguna default Windows dengan profil yang Anda konfigurasikan. Profil pengguna default Windows kemudian digunakan untuk membuat pengaturan awal untuk pengguna dalam instance armada. Jika pengaturan aplikasi atau Windows yang Anda konfigurasikan tidak berfungsi di armada, konfirmasikan bahwa pengaturan tersebut disimpan di profil pengguna Windows. Untuk informasi selengkapnya, lihat Langkah 3: Membuat Aplikasi Default dan Pengaturan Windows di[Tutorial: Membuat Gambar WorkSpaces Aplikasi Kustom dengan Menggunakan Konsol WorkSpaces Aplikasi](tutorial-image-builder.md).
Pengaturan default yang dapat Anda buat dan konfigurasikan meliputi:
+ Preferensi aplikasi, termasuk beranda browser, kustomisasi toolbar, dan pengaturan keamanan.
+ Pengaturan data aplikasi, termasuk bookmark browser dan profil koneksi.
+ Pengaturan pengalaman Windows, termasuk menampilkan ekstensi nama file dan folder tersembunyi.
Selain itu, Anda dapat mengubah atau menonaktifkan pengaturan keamanan Internet Explorer, seperti Enhanced Security Configuration (ESC). Untuk informasi selengkapnya, lihat [Nonaktifkan Konfigurasi Keamanan Internet Explorer yang Ditingkatkan di WorkSpaces Aplikasi Amazon](customize-fleets-disable-ie-esc.md).
# Mengoptimalkan Kinerja Peluncuran Aplikasi Anda di Aplikasi Amazon WorkSpaces
Saat Anda membuat gambar, WorkSpaces Aplikasi mengharuskan Anda mengoptimalkan kinerja peluncuran aplikasi Anda untuk sesi streaming pengguna Anda. Ketika aplikasi Anda dibuka selama proses ini, pastikan bahwa mereka menggunakan komponen awal yang diperlukan oleh pengguna Anda. Melakukan hal itu memastikan bahwa komponen-komponen ini ditangkap oleh proses optimasi. Dalam beberapa kasus, tidak semua file yang diperlukan untuk pengoptimalan terdeteksi. Contoh file tersebut adalah plug-in atau komponen yang tidak dibuka di pembuat gambar. Untuk memastikan bahwa semua file yang diperlukan untuk aplikasi Anda ditangkap, Anda dapat memasukkannya ke dalam manifes pengoptimalan. Menambahkan file ke manifes pengoptimalan dapat meningkatkan waktu yang diperlukan untuk membuat instance armada dan tersedia bagi pengguna. Melakukannya, bagaimanapun, mengurangi waktu yang dibutuhkan aplikasi untuk diluncurkan pertama kali pada instance armada.
Untuk mengoptimalkan semua file dalam folder, buka PowerShell dan gunakan PowerShell perintah berikut:
```
dir -path "C:\Path\To\Folder\To\Optimize" -Recurse -ErrorAction SilentlyContinue | %{$_.FullName} | Out-File "C:\ProgramData\Amazon\Photon\Prewarm\PrewarmManifest.txt" -encoding UTF8 -append
```
Secara default, Image Assistant menggantikan manifes pengoptimalan aplikasi setiap kali langkah Image Assistant **Optimize** berjalan. Anda harus menjalankan PowerShell perintah untuk mengoptimalkan semua file dalam folder:
+ Setiap kali setelah langkah **Optimalkan** berjalan.
+ Sebelum Anda memilih **Putuskan sambungan dan buat gambar** di halaman **Tinjauan** Asisten Gambar.
Atau, Anda dapat menentukan manifes pengoptimalan berdasarkan per aplikasi dengan menggunakan operasi antarmuka baris perintah Image Assistant (CLI). **Saat Anda menentukan manifes pengoptimalan menggunakan operasi CLI Asisten Gambar, WorkSpaces Aplikasi menggabungkan manifes pengoptimalan aplikasi yang ditentukan dengan file yang diidentifikasi oleh langkah Image Assistant Optimize.** Untuk informasi selengkapnya, lihat [Buat Gambar WorkSpaces Aplikasi Amazon Anda Secara Terprogram dengan Menggunakan Operasi CLI Asisten Gambar](programmatically-create-image.md).
# Kelola Versi Agen WorkSpaces Aplikasi
Agen WorkSpaces Aplikasi adalah perangkat lunak yang berjalan pada instance streaming Anda dan memungkinkan pengguna untuk melakukan streaming aplikasi. Saat Anda membuat gambar baru, opsi **Selalu gunakan versi agen terbaru** dipilih secara default. Ketika opsi ini dipilih, pembuat gambar baru atau instance armada yang diluncurkan dari gambar Anda selalu menggunakan versi agen WorkSpaces Aplikasi terbaru. Anda mungkin ingin mengontrol pembaruan agen untuk memastikan kompatibilitas dengan perangkat lunak Anda atau untuk memenuhi syarat lingkungan yang diperbarui sebelum Anda menerapkannya untuk pengguna akhir Anda.
Prosedur berikut menjelaskan cara mengelola versi agen WorkSpaces Aplikasi.
**Topics**
+ [Buat Gambar yang Selalu Menggunakan Versi Terbaru dari Agen WorkSpaces Aplikasi](create-image-that-always-uses-latest-agent.md)
+ [Buat Gambar yang Menggunakan Versi Tertentu dari Agen WorkSpaces Aplikasi](create-image-that-uses-specific-agent.md)
+ [Buat Gambar yang Menggunakan Versi Baru dari Agen WorkSpaces Aplikasi](create-image-that-uses-newer-agent.md)
# Buat Gambar yang Selalu Menggunakan Versi Terbaru dari Agen WorkSpaces Aplikasi
Ketika gambar Anda dikonfigurasi untuk selalu menggunakan versi agen WorkSpaces Aplikasi terbaru, instans streaming Anda diperbarui secara otomatis dengan fitur terbaru, peningkatan kinerja, dan pembaruan keamanan yang tersedia AWS sejak versi agen baru dirilis.
**catatan**
Dalam beberapa kasus, versi agen WorkSpaces Aplikasi baru mungkin bertentangan dengan perangkat lunak Anda. Kami menyarankan Anda memenuhi syarat versi agen WorkSpaces Aplikasi baru sebelum menerapkannya ke armada produksi Anda.
**Untuk membuat gambar yang selalu menggunakan versi terbaru dari agen WorkSpaces Aplikasi**
1. Buka konsol WorkSpaces Aplikasi di [https://console.aws.amazon.com/appstream2/rumah](https://console.aws.amazon.com/appstream2/home).
1. Lakukan salah satu dari langkah berikut:
+ Jika Anda memiliki pembuat gambar yang ingin Anda gunakan untuk membuat gambar, mulai pembuat gambar dan kemudian sambungkan ke sana. Jika pembuat gambar tidak menjalankan versi terbaru dari agen WorkSpaces Aplikasi, Anda diminta untuk memilih apakah akan memulai pembuat gambar dengan agen terbaru. Pastikan opsi ini dipilih, pilih **Mulai**, lalu sambungkan ke pembuat gambar.
+ Jika Anda tidak memiliki pembuat gambar yang ingin Anda gunakan untuk membuat gambar, luncurkan pembuat gambar baru. Pada **Langkah 1: Pilih Gambar**, pilih gambar AWS dasar atau gambar khusus. Pada **Langkah 2: Konfigurasikan Image Builder**, jika gambar yang Anda pilih tidak menjalankan versi terbaru dari agen WorkSpaces Aplikasi, bagian **WorkSpaces Aplikasi** akan ditampilkan. Dalam daftar **versi Agen**, pilih versi agen terbaru. Selesaikan langkah-langkah yang tersisa untuk membuat pembuat gambar, lalu sambungkan ke sana. Untuk informasi selengkapnya, lihat [Luncurkan Image Builder untuk Menginstal dan Mengkonfigurasi Aplikasi Streaming](tutorial-image-builder-create.md).
1. Pada desktop pembuat gambar, buka Image Assistant dan ikuti langkah-langkah untuk membuat gambar baru Anda. Untuk langkah **Configure Image**, pastikan bahwa **Selalu gunakan versi agen terbaru** dipilih. Untuk informasi selengkapnya, lihat [Tutorial: Membuat Gambar WorkSpaces Aplikasi Kustom dengan Menggunakan Konsol WorkSpaces Aplikasi](tutorial-image-builder.md).
Jika Anda memutuskan nanti untuk tidak selalu menggunakan versi terbaru dari agen WorkSpaces Aplikasi, Anda harus membuat gambar baru dan menghapus opsi itu.
1. Buat armada baru atau modifikasi yang sudah ada. Saat Anda mengonfigurasi armada, pilih gambar baru yang Anda buat. Untuk informasi selengkapnya, lihat [Buat Armada dan Tumpukan WorkSpaces Aplikasi Amazon](set-up-stacks-fleets.md).
1. Buat tumpukan baru atau modifikasi yang sudah ada dan kaitkan dengan armada Anda.
# Buat Gambar yang Menggunakan Versi Tertentu dari Agen WorkSpaces Aplikasi
Anda mungkin ingin mengontrol pembaruan agen WorkSpaces Aplikasi daripada selalu menggunakan versi terbaru sehingga Anda dapat menguji kompatibilitasnya terlebih dahulu. Untuk memastikan bahwa versi agen WorkSpaces Aplikasi yang Anda gunakan kompatibel dengan aplikasi streaming Anda, Anda dapat membuat gambar yang menggunakan versi tertentu dari perangkat lunak agen. Kemudian lakukan tes kualifikasi Anda dalam armada terpisah sebelum dikerahkan ke armada produksi Anda.
Saat Anda membuat gambar, pastikan opsi **Selalu gunakan versi agen terbaru** tidak dipilih. Melakukannya menyematkan gambar Anda ke versi agen WorkSpaces Aplikasi yang Anda pilih saat meluncurkan pembuat gambar, daripada selalu menggunakan versi terbaru. Setelah Anda menyelesaikan tes kualifikasi Anda, Anda dapat memperbarui armada produksi Anda dengan gambar.
**Untuk membuat gambar yang menggunakan versi tertentu dari agen WorkSpaces Aplikasi**
1. Buka konsol WorkSpaces Aplikasi di [https://console.aws.amazon.com/appstream2/rumah](https://console.aws.amazon.com/appstream2/home).
1. Lakukan salah satu dari langkah berikut:
+ Jika Anda memiliki pembuat gambar yang ingin Anda gunakan untuk membuat gambar, mulai pembuat gambar dan kemudian sambungkan ke sana.
+ Jika Anda tidak memiliki pembuat gambar yang ingin Anda gunakan untuk membuat gambar, luncurkan pembuat gambar baru. Pada **Langkah 1: Pilih Gambar**, pilih gambar AWS dasar atau gambar khusus. Pada **Langkah 2: Konfigurasikan Image Builder**, jika gambar yang Anda pilih tidak menjalankan versi terbaru dari agen WorkSpaces Aplikasi, bagian **WorkSpaces Aplikasi** akan ditampilkan. Dalam daftar **versi Agen**, jangan pilih versi agen terbaru. Selesaikan langkah-langkah yang tersisa untuk membuat pembuat gambar, lalu sambungkan ke sana. Untuk informasi selengkapnya, lihat [Luncurkan Image Builder untuk Menginstal dan Mengkonfigurasi Aplikasi Streaming](tutorial-image-builder-create.md).
1. Pada desktop pembuat gambar, buka Image Assistant dan ikuti langkah-langkah untuk membuat gambar baru Anda. Untuk langkah **Configure Image** di Image Assistant, pastikan bahwa **Selalu gunakan versi agen terbaru** tidak dipilih. Untuk informasi selengkapnya, lihat [Tutorial: Membuat Gambar WorkSpaces Aplikasi Kustom dengan Menggunakan Konsol WorkSpaces Aplikasi](tutorial-image-builder.md).
Jika Anda memutuskan nanti untuk selalu menggunakan versi terbaru dari agen WorkSpaces Aplikasi, Anda harus membuat gambar baru dan memilih opsi itu.
1. Buat armada baru atau modifikasi yang sudah ada. Saat Anda mengonfigurasi armada, pilih gambar baru yang Anda buat. Untuk informasi selengkapnya, lihat [Buat Armada dan Tumpukan WorkSpaces Aplikasi Amazon](set-up-stacks-fleets.md).
1. Buat tumpukan baru atau modifikasi yang sudah ada dan kaitkan dengan armada Anda.
1. Connect ke armada Anda dan uji aplikasi Anda untuk kompatibilitas.
# Buat Gambar yang Menggunakan Versi Baru dari Agen WorkSpaces Aplikasi
Jika Anda menyematkan gambar Anda ke versi agen WorkSpaces Aplikasi tertentu, Anda harus memperbarui ke versi yang lebih baru dengan membuat gambar baru. Pendekatan ini memungkinkan Anda menguji setiap pembaruan agen untuk kompatibilitas terlebih dahulu, dan kemudian memperbarui armada Anda secara bertahap.
Saat Anda membuat gambar, pastikan opsi **Selalu gunakan versi agen terbaru** tidak dipilih. Setelah Anda membuat gambar Anda, lakukan tes kualifikasi Anda dalam armada terpisah sebelum dikerahkan ke armada produksi Anda. Setelah Anda menyelesaikan tes kualifikasi Anda, Anda dapat memperbarui armada produksi Anda dengan gambar.
**Untuk membuat gambar yang menggunakan versi agen WorkSpaces Aplikasi yang lebih baru**
1. Buka konsol WorkSpaces Aplikasi di [https://console.aws.amazon.com/appstream2/rumah](https://console.aws.amazon.com/appstream2/home).
1. Lakukan salah satu dari langkah berikut:
+ Jika Anda memiliki pembuat gambar yang ingin Anda gunakan untuk membuat gambar, mulai pembuat gambar dan kemudian sambungkan ke sana. Jika pembuat gambar tidak menjalankan versi terbaru dari agen WorkSpaces Aplikasi, Anda diminta untuk memilih apakah akan memulai pembuat gambar dengan agen terbaru. Pastikan opsi ini dipilih, pilih **Mulai**, lalu sambungkan ke pembuat gambar.
+ Jika Anda tidak memiliki pembuat gambar yang ingin Anda gunakan untuk membuat gambar, luncurkan pembuat gambar baru. Pada **Langkah 1: Pilih Gambar**, pilih gambar AWS dasar atau gambar khusus. Pada **Langkah 2: Konfigurasikan Image Builder**, jika gambar yang Anda pilih tidak menjalankan versi terbaru dari agen WorkSpaces Aplikasi, bagian **WorkSpaces Aplikasi** akan ditampilkan. Dalam daftar **versi Agen**, pilih versi agen terbaru. Selesaikan langkah-langkah yang tersisa untuk membuat pembuat gambar, lalu sambungkan ke sana. Untuk informasi selengkapnya, lihat [Luncurkan Image Builder untuk Menginstal dan Mengkonfigurasi Aplikasi Streaming](tutorial-image-builder-create.md).
1. Pada desktop pembuat gambar, buka Image Assistant dan ikuti langkah-langkah untuk membuat gambar baru Anda. Untuk langkah **Configure Image** di Image Assistant, pastikan bahwa **Selalu gunakan versi agen terbaru** tidak dipilih. Untuk informasi selengkapnya, lihat [Tutorial: Membuat Gambar WorkSpaces Aplikasi Kustom dengan Menggunakan Konsol WorkSpaces Aplikasi](tutorial-image-builder.md).
Jika Anda memutuskan nanti untuk selalu menggunakan versi terbaru dari agen WorkSpaces Aplikasi, Anda harus membuat gambar baru dan memilih opsi itu.
1. Buat armada baru atau modifikasi yang sudah ada. Saat Anda mengonfigurasi armada, pilih gambar baru yang Anda buat. Untuk informasi selengkapnya, lihat [Buat Armada dan Tumpukan WorkSpaces Aplikasi Amazon](set-up-stacks-fleets.md).
1. Buat tumpukan baru atau modifikasi yang sudah ada dan kaitkan dengan armada Anda.
1. Connect ke armada Anda dan uji aplikasi Anda untuk kompatibilitas.
# WorkSpaces Catatan Rilis Agen Aplikasi
Perangkat lunak agen WorkSpaces Aplikasi Amazon berjalan pada instans streaming Anda, memungkinkan pengguna akhir untuk terhubung dan memulai aplikasi streaming mereka. Mulai 7 Desember 2017, instans streaming Anda dapat diperbarui secara otomatis dengan fitur terbaru, peningkatan kinerja, dan pembaruan keamanan yang tersedia. AWS Sebelum 7 Desember 2017, pembaruan agen disertakan dengan rilis gambar dasar baru.
Untuk menggunakan perangkat lunak agen WorkSpaces Aplikasi terbaru, Anda perlu membangun kembali gambar Anda dengan menggunakan gambar dasar baru yang diterbitkan AWS pada atau setelah 7 Desember 2017. Saat Anda melakukan ini, opsi untuk mengaktifkan pembaruan otomatis agen dipilih secara default di Asisten Gambar. Kami menyarankan Anda membiarkan opsi ini dipilih sehingga pembuat gambar atau instance armada baru yang diluncurkan dari gambar Anda selalu menggunakan versi terbaru dari agen. Untuk informasi selengkapnya, lihat [Tutorial: Membuat Gambar WorkSpaces Aplikasi Kustom dengan Menggunakan Konsol WorkSpaces Aplikasi](tutorial-image-builder.md).
Tabel berikut menjelaskan pembaruan terbaru yang tersedia dalam versi rilis agen WorkSpaces Aplikasi untuk instance Windows.
| Versi agen WorkSpaces Aplikasi Amazon | Perubahan |
| --- | --- |
| 02-09-2026 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 02-04-2026 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 12-06-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 10-02-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 09-30-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 07-15-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 05-29-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 03-05-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 02-07-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 10-31-2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 10-21-2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 09-18-2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 05-21-2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 04-15-2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 01-17-2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 12-07-2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 09-06-2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 05-30-2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 05-08-2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 04-13-2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 03-21-2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 10-13-2022 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 06-20-2022 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 03-14-2022 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 02-21-2022 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 12-20-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 10-19-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 08-02-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 07-01-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 06-25-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 05-17-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 03-04-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 12-17-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 01-04-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 12-17-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 10-08-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 09-01-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 07-30-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 05-27-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 04-20-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 02-19-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 01-13-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 11-13-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 10-08-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 09-23-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 09-03-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 08-08-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 07-26-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 06-19-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 05-07-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 04-02-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 03-07-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 01-22-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 01-08-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 12-19-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 12-17-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 12-04-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 11-14-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 10-30-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 10-24-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 10-01-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 08-29-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 07-26-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 06-19-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 06-06-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 05-31-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 05-21-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 03-19-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 01-24-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
| 12-07-2017 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/agent-software-versions.html) |
# Tutorial: Membuat Gambar WorkSpaces Aplikasi Kustom dengan Menggunakan Konsol WorkSpaces Aplikasi
Tutorial ini menjelaskan cara membuat gambar WorkSpaces Aplikasi yang didasarkan pada sistem operasi Microsoft Windows Server. Jika Anda ingin membuat gambar khusus yang didasarkan pada sistem operasi Amazon Linux 2, Rocky Linux, atau Red Hat Enterprise Linux, lihat[Tutorial: Buat Gambar Aplikasi Berbasis Linux WorkSpaces Kustom](tutorial-create-linux-image.md).
Dalam tutorial ini, Anda akan belajar cara membuat gambar WorkSpaces Aplikasi Amazon khusus yang berisi aplikasi yang dapat Anda streaming ke pengguna Anda, dan aplikasi default dan pengaturan Windows untuk memungkinkan pengguna Anda memulai aplikasi mereka dengan cepat. Untuk menyelesaikan tutorial ini, Anda harus sudah memiliki pembuat gambar. Jika Anda tidak memiliki pembuat gambar, lihat[Luncurkan Image Builder untuk Menginstal dan Mengkonfigurasi Aplikasi Streaming](tutorial-image-builder-create.md).
**penting**
Tutorial ini mencakup informasi yang berlaku untuk rilis gambar dasar terbaru. Untuk informasi selengkapnya, lihat [WorkSpaces Catatan Rilis Pembaruan Gambar Dasar Aplikasi dan Gambar Terkelola](base-image-version-history.md).
**Topics**
+ [Langkah 1: Instal Aplikasi pada Image Builder](#tutorial-image-builder-install)
+ [Langkah 2: Buat Katalog WorkSpaces Aplikasi Aplikasi](#tutorial-image-builder-add)
+ [Langkah 3: Buat Aplikasi Default dan Pengaturan Windows](#tutorial-image-builder-create-default-app-settings)
+ [Langkah 4: Uji Aplikasi](#tutorial-image-builder-test-applications)
+ [Langkah 5: Optimalkan Aplikasi](#tutorial-image-builder-optimize)
+ [Langkah 6: Selesai Membuat Gambar Anda](#tutorial-image-builder-finish-create-image)
+ [Langkah 7 (Opsional): Tag dan Salin Gambar](#tutorial-image-builder-tag-copy)
+ [Langkah 8: Bersihkan](#tutorial-image-builder-finish)
## Langkah 1: Instal Aplikasi pada Image Builder
Pada langkah ini, Anda menghubungkan pembuat gambar dan menginstal aplikasi Anda pada pembuat gambar.
**penting**
Untuk menyelesaikan langkah ini, Anda harus masuk ke pembuat gambar dengan akun **Administrator** lokal atau akun domain yang memiliki izin administrator lokal. Jangan mengganti nama atau menghapus akun **Administrator** bawaan lokal. Jika Anda mengganti nama atau menghapus akun ini, pembuat gambar tidak akan memulai dan pembuatan gambar akan gagal.
**Untuk menginstal aplikasi pada pembuat gambar**
1. Connect ke image builder dengan melakukan salah satu hal berikut:
+ [Gunakan konsol WorkSpaces Aplikasi](managing-image-builders-connect-console.md) (hanya untuk koneksi web)
+ [Buat URL streaming](managing-image-builders-connect-streaming-URL.md) (untuk koneksi klien web atau WorkSpaces Aplikasi)
**catatan**
Jika pembuat gambar yang ingin Anda sambungkan digabungkan ke domain Direktori Aktif dan organisasi Anda memerlukan login kartu pintar, Anda harus membuat URL streaming dan menggunakan klien WorkSpaces Aplikasi untuk koneksi. Untuk informasi tentang login kartu pintar, lihat[Kartu Pintar](feature-support-USB-devices-qualified.md#feature-support-USB-devices-qualified-smart-cards).
1. Instal aplikasi dari situs web aplikasi atau sumber unduhan lainnya. Instal aplikasi yang Anda inginkan sebelum melanjutkan ke langkah berikutnya.
**catatan**
Unduh dan instal aplikasi hanya dari situs yang Anda percayai.
Jika aplikasi memerlukan sistem operasi Windows untuk memulai ulang, biarkan saja. Sebelum sistem operasi restart, Anda terputus dari pembuat gambar Anda. Setelah restart selesai, sambungkan ke pembuat gambar lagi, lalu selesaikan menginstal aplikasi.
## Langkah 2: Buat Katalog WorkSpaces Aplikasi Aplikasi
*Pada langkah ini, buat katalog WorkSpaces aplikasi Aplikasi dengan menentukan aplikasi (*.exe), skrip batch (.bat**), dan pintasan aplikasi (.lnk*) untuk gambar Anda.* Untuk setiap aplikasi yang Anda rencanakan untuk streaming, Anda dapat menentukan nama, nama tampilan, file yang dapat dieksekusi untuk diluncurkan, dan ikon yang akan ditampilkan. Jika Anda memilih pintasan aplikasi, nilai-nilai ini sudah terisi untuk Anda.
**penting**
Untuk menyelesaikan langkah ini, Anda harus masuk ke pembuat gambar dengan akun **Administrator** lokal atau akun domain yang memiliki izin administrator lokal.
**Untuk membuat katalog WorkSpaces aplikasi Aplikasi**
1. Dari desktop pembuat gambar, buka Image Assistant. Image Assistant memandu Anda melalui proses pembuatan gambar.
![\[Row of icons representing different functions in Image Assistant interface.\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/images/Image-Builder-Desktop-Image-Assistant.png)
1. Dalam **1. Tambahkan Aplikasi**, pilih **\$1 Tambah Aplikasi**, dan arahkan ke lokasi aplikasi, skrip, atau pintasan untuk ditambahkan. Pilih **Buka**.
1. Di kotak dialog **Pengaturan Peluncuran Aplikasi**, simpan atau ubah pengaturan default untuk **Nama, Nama** **Tampilan**, dan **Jalur Ikon**. Secara opsional, Anda dapat menentukan parameter peluncuran (argumen tambahan diteruskan ke aplikasi saat diluncurkan) dan direktori kerja untuk aplikasi. Setelah selesai, pilih **Simpan**.
Pengaturan **Nama Tampilan** dan **Jalur Ikon** menentukan bagaimana nama dan ikon aplikasi Anda muncul di katalog aplikasi. Katalog ditampilkan kepada pengguna saat mereka masuk ke sesi streaming WorkSpaces Aplikasi.
1. Ulangi langkah 2 dan 3 untuk setiap aplikasi di Image Assistant dan konfirmasikan bahwa aplikasi muncul di tab **Add Apps**. Setelah selesai, pilih **Berikutnya** untuk melanjutkan menggunakan Asisten Gambar untuk membuat gambar Anda.
## Langkah 3: Buat Aplikasi Default dan Pengaturan Windows
Pada langkah ini, Anda membuat aplikasi default dan pengaturan Windows untuk pengguna WorkSpaces Aplikasi Anda. Melakukan hal ini memungkinkan pengguna Anda untuk memulai dengan aplikasi dengan cepat selama sesi streaming WorkSpaces Aplikasi mereka, tanpa perlu membuat atau mengonfigurasi pengaturan ini sendiri.
**penting**
Untuk menyelesaikan langkah ini, Anda harus masuk ke pembuat gambar dengan akun **Pengguna Template** lokal atau akun pengguna domain yang tidak memiliki izin administrator lokal.
**Untuk membuat aplikasi default dan pengaturan Windows untuk pengguna Anda**
1. Di Image Assistant, di **2. Konfigurasikan Aplikasi**, pilih **Ganti pengguna**. Ini memutus Anda dari sesi saat ini dan menampilkan menu login.
1. Lakukan salah satu dari langkah berikut:
+ Jika pembuat gambar Anda tidak bergabung dengan domain Direktori Aktif, pada tab **Pengguna Lokal**, pilih **Pengguna Template**. Akun ini memungkinkan Anda untuk membuat aplikasi default dan pengaturan Windows.
+ Jika pembuat gambar Anda bergabung ke domain Direktori Aktif, pilih **Pengguna Direktori**, dan masuk sebagai pengguna domain yang tidak memiliki izin administrator lokal.
1. Dari desktop pembuat gambar, buka Image Assistant, yang menampilkan aplikasi yang Anda tambahkan saat Anda membuat katalog aplikasi.
1. Pilih aplikasi yang ingin Anda buat pengaturan aplikasi default.
1. Setelah aplikasi terbuka, buat pengaturan ini sesuai kebutuhan.
1. Setelah selesai, tutup aplikasi, dan kembali ke Image Assistant.
1. Jika Anda menentukan lebih dari satu aplikasi di Image Assistant, ulangi langkah 4 hingga 6 untuk setiap aplikasi sesuai kebutuhan.
1. Jika Anda ingin pengaturan Windows default, buat sekarang. Setelah selesai, kembali ke Image Assistant.
1. Pilih **Beralih pengguna** dan masuk dengan akun yang sama dengan yang Anda gunakan untuk membuat katalog aplikasi (akun yang memiliki izin administrator lokal).
1. Di Image Assistant, di **2. Konfigurasikan Aplikasi**, lakukan salah satu hal berikut:
+ Jika pembuat gambar Anda tidak bergabung dengan domain Direktori Aktif, pilih **Simpan pengaturan**.
+ Jika pembuat gambar Anda bergabung ke domain Direktori Aktif, dalam daftar **Pilih pengaturan pengguna yang akan disalin**, pilih akun yang sama dengan yang Anda gunakan untuk masuk ke pembuat gambar saat Anda membuat aplikasi default dan pengaturan Windows, lalu pilih **Simpan pengaturan**.
Daftar **Pilih pengaturan mana yang akan disalin** menampilkan akun apa pun yang saat ini memiliki pengaturan yang disimpan di pembuat gambar.
1. Setelah selesai, pilih **Berikutnya** untuk terus membuat gambar Anda.
## Langkah 4: Uji Aplikasi
Pada langkah ini, verifikasi bahwa aplikasi yang telah Anda tambahkan terbuka dengan benar dan lakukan seperti yang diharapkan. Untuk melakukannya, mulailah sesi Windows baru sebagai pengguna yang memiliki izin yang sama dengan pengguna Anda.
**penting**
Untuk menyelesaikan langkah ini, Anda harus masuk ke pembuat gambar dengan akun **Pengguna Uji** atau akun domain yang tidak memiliki izin administrator lokal.
**Untuk menguji aplikasi Anda**
1. Di Image Assistant, di **3. Uji**, lakukan salah satu dari hal berikut:
+ Jika pembuat gambar Anda tidak bergabung dengan domain Direktori Aktif, pilih **Ganti pengguna**.
+ Jika pembuat gambar Anda bergabung ke domain Direktori Aktif, Anda memerlukan akun domain untuk menguji aplikasi Anda, dan pengguna sudah memiliki pengaturan pada pembuat gambar, Anda harus mengatur ulang pengaturan aplikasi untuk pengguna tersebut. Untuk melakukannya, pilih pengguna dari daftar **Pengguna untuk mengatur ulang**, dan pilih **Reset**. Setelah selesai, pilih **Ganti pengguna**.
**catatan**
Jika pembuat gambar Anda baru dan tidak ada pengguna yang memiliki pengaturan pada pembuat gambar, daftar tidak menampilkan pengguna mana pun.
1. Pilih pengguna yang akan digunakan untuk pengujian dengan melakukan salah satu dari hal berikut:
+ Jika pembuat gambar Anda tidak bergabung dengan domain Direktori Aktif, pilih **Pengguna Uji**. Akun ini memungkinkan Anda untuk menguji aplikasi Anda dengan menggunakan kebijakan dan izin yang sama dengan pengguna Anda.
+ **Jika pembuat gambar Anda bergabung ke domain Direktori Aktif, pilih **Pengguna Direktori**, tentukan kredensi untuk akun domain yang tidak memiliki izin administrator lokal, lalu pilih Masuk.**
1. Dari desktop pembuat gambar, buka Image Assistant, yang menampilkan aplikasi yang Anda tentukan saat membuat katalog aplikasi.
1. Pilih aplikasi yang ingin Anda uji, untuk mengonfirmasi bahwa itu terbuka dengan benar dan bahwa pengaturan aplikasi default yang Anda buat diterapkan.
1. Setelah aplikasi terbuka, ujilah sesuai kebutuhan. Setelah selesai, tutup aplikasi dan kembali ke Image Assistant.
1. Jika Anda menentukan lebih dari satu aplikasi di Image Assistant, ulangi langkah 4 dan 5 untuk menguji setiap aplikasi sesuai kebutuhan.
1. Setelah selesai, pilih **Switch user**, lalu lakukan salah satu hal berikut:
+ Jika pembuat gambar Anda tidak bergabung dengan domain Direktori Aktif, pada tab **Pengguna Lokal**, pilih **Administrator**.
+ Jika pembuat gambar Anda bergabung ke domain Direktori Aktif dan Anda masuk sebagai pengguna domain dengan izin administrator lokal untuk menentukan aplikasi di Asisten Gambar, masuk sebagai pengguna tersebut.
1. Pilih **Berikutnya** untuk terus membuat gambar Anda.
## Langkah 5: Optimalkan Aplikasi
Pada langkah ini, Image Assistant membuka aplikasi Anda satu demi satu, mengidentifikasi dependensi peluncurannya, dan melakukan pengoptimalan untuk memastikan aplikasi diluncurkan dengan cepat. Ini adalah langkah-langkah yang diperlukan yang dilakukan pada semua aplikasi dalam daftar.
**Untuk mengoptimalkan aplikasi Anda**
1. Di Image Assistant, di **4. Optimalkan**, pilih **Luncurkan**.
1. WorkSpaces Aplikasi secara otomatis meluncurkan aplikasi pertama dalam daftar Anda. Ketika aplikasi benar-benar dimulai, berikan masukan yang diperlukan untuk melakukan pengalaman lari pertama untuk aplikasi. Misalnya, browser web mungkin meminta Anda untuk mengimpor pengaturan sebelum benar-benar aktif dan berjalan.
1. Setelah Anda menyelesaikan pengalaman lari pertama dan memverifikasi bahwa aplikasi berfungsi seperti yang diharapkan, pilih **Lanjutkan**. Jika Anda menambahkan lebih dari satu aplikasi ke gambar Anda, setiap aplikasi terbuka secara otomatis. Ulangi langkah ini untuk setiap aplikasi sesuai kebutuhan, biarkan semua aplikasi berjalan.
1. Setelah selesai, tab berikutnya di Image Assistant, **5. Konfigurasikan Gambar**, secara otomatis ditampilkan.
## Langkah 6: Selesai Membuat Gambar Anda
Pada langkah ini, pilih nama gambar dan selesaikan pembuatan gambar Anda.
**Untuk membuat gambar**
1. Ketik nama gambar yang unik, dan nama tampilan gambar opsional dan deskripsi. Nama gambar tidak dapat dimulai dengan “Amazon,” “AWS,” atau “AppStream.”
Anda juga dapat menambahkan satu atau lebih tag ke gambar. Untuk melakukannya, pilih **Tambah Tag**, dan ketik kunci dan nilai untuk tag. Untuk menambahkan lebih banyak tag, ulangi langkah ini. Untuk informasi selengkapnya, lihat [Menandai Sumber Daya WorkSpaces Aplikasi Amazon Anda](tagging-basic.md). Setelah selesai, pilih **Berikutnya**.
**catatan**
Jika Anda memilih gambar dasar yang diterbitkan AWS pada atau setelah 7 Desember 2017, opsi **Selalu gunakan versi agen terbaru** muncul, dipilih secara default. Kami menyarankan Anda membiarkan opsi ini dipilih sehingga instance streaming yang diluncurkan dari gambar selalu menggunakan versi terbaru agen. Jika Anda menonaktifkan opsi ini, Anda tidak dapat mengaktifkannya lagi setelah Anda selesai membuat gambar. Untuk informasi tentang rilis terbaru agen WorkSpaces Aplikasi, lihat[WorkSpaces Catatan Rilis Agen Aplikasi](agent-software-versions.md).
1. Dalam **6. Tinjau**, verifikasi detail gambar. Untuk membuat perubahan, pilih **Sebelumnya** untuk menavigasi ke tab Asisten Gambar yang sesuai, buat perubahan, lalu lanjutkan melalui langkah-langkah di Asisten Gambar sesuai kebutuhan.
1. Setelah Anda selesai meninjau detail gambar, pilih **Putuskan sambungan dan buat** gambar.
1. Sesi jarak jauh terputus dalam beberapa saat. Ketika pesan **Konektivitas Hilang** muncul, tutup tab browser. Saat gambar dibuat, status pembuat gambar muncul sebagai **Snapshotting**. Anda tidak dapat terhubung ke pembuat gambar sampai proses ini selesai.
1. Kembali ke konsol dan arahkan ke **Images**, **Image Registry**. Verifikasi bahwa gambar baru Anda muncul dalam daftar.
Saat gambar Anda sedang dibuat, status gambar di registri gambar konsol muncul sebagai **Tertunda** dan Anda tidak dapat terhubung dengannya.
1. Pilih ikon **Refresh** secara berkala untuk memperbarui status. Setelah gambar Anda dibuat, status gambar berubah menjadi **Tersedia** dan pembuat gambar dihentikan secara otomatis.
Untuk terus membuat gambar, mulai pembuat gambar dan sambungkan dari konsol, atau buat pembuat gambar baru.
**catatan**
Setelah Anda membuat gambar Anda, Anda bertanggung jawab untuk mempertahankan pembaruan untuk sistem operasi Windows. Untuk melakukannya, Anda dapat menggunakan pembaruan gambar WorkSpaces Aplikasi terkelola. Anda juga bertanggung jawab untuk menjaga pembaruan untuk aplikasi Anda dan dependensinya. Untuk informasi selengkapnya, lihat [Simpan Gambar WorkSpaces Aplikasi Amazon Anda Up-to-Date](keep-image-updated.md).
Untuk menambahkan aplikasi lain, memperbarui aplikasi yang ada, atau mengubah pengaturan gambar, Anda harus memulai dan menyambung kembali ke pembuat gambar yang Anda gunakan untuk membuat gambar. Atau, jika Anda menghapus pembuat gambar itu, luncurkan pembuat gambar baru yang didasarkan pada gambar Anda. Kemudian, buat perubahan Anda dan buat gambar baru.
## Langkah 7 (Opsional): Tag dan Salin Gambar
Anda dapat menambahkan satu atau beberapa tag ke gambar selama pembuatan gambar atau setelah Anda membuat gambar. Anda juga dapat menyalin gambar dalam Wilayah yang sama atau ke Wilayah baru dalam akun Amazon Web Services yang sama. Menyalin gambar sumber menghasilkan gambar tujuan yang identik tetapi berbeda. AWS Namun, tidak menyalin tag yang ditentukan pengguna. Selain itu, Anda hanya dapat menyalin gambar khusus yang Anda buat, bukan gambar dasar yang disediakan oleh AWS.
**catatan**
Anda dapat menyalin hingga dua gambar sekaligus ke tujuan. Jika tujuan Anda menyalin gambar berada pada batas gambar, Anda menerima kesalahan. Untuk menyalin gambar dalam hal ini, Anda harus terlebih dahulu menghapus gambar dari tujuan. Setelah tujuan berada di bawah kuota gambar (disebut juga limit), mulailah salinan gambar dari daerah sumber. Untuk informasi selengkapnya, lihat [Service Quotas WorkSpaces Aplikasi Amazon](limits.md).
**Untuk menambahkan tag ke gambar yang ada**
1. Di panel navigasi, pilih **Gambar**, **Registri Gambar**.
1. Dalam daftar gambar, pilih gambar yang ingin Anda tambahkan tag.
1. **Pilih **Tag**, pilih **Tambah/Edit Tag**, pilih **Tambah Tag**, tentukan kunci dan nilai untuk tag, lalu pilih Simpan.**
Untuk informasi selengkapnya, lihat [Menandai Sumber Daya WorkSpaces Aplikasi Amazon Anda](tagging-basic.md).
**Untuk menyalin gambar**
Menyalin gambar di wilayah yang beragam secara geografis memungkinkan Anda melakukan streaming aplikasi dari beberapa wilayah berdasarkan gambar yang sama. Dengan streaming aplikasi Anda di dekat pengguna Anda, Anda dapat meningkatkan pengalaman pengguna Anda streaming aplikasi dengan WorkSpaces Aplikasi.
1. Di panel navigasi, pilih **Gambar**, **Registri Gambar**.
1. Dalam daftar gambar, pilih gambar yang ingin Anda salin.
1. Pilih **Tindakan**, **Salin**.
1. Dalam **Salin Gambar** kotak dialog, tentukan informasi berikut, lalu pilih **Salin Gambar:**
+ Untuk **wilayah Tujuan**, pilih wilayah untuk menyalin gambar baru.
+ Untuk **Nama**, tentukan nama yang akan dimiliki gambar saat disalin ke tujuan.
+ Untuk **Deskripsi** (opsional), tentukan deskripsi yang akan dimiliki gambar saat disalin ke tujuan.
1. Untuk memeriksa kemajuan operasi penyalinan, kembali ke konsol dan arahkan ke **Gambar**, **Registri Gambar**. Gunakan bilah navigasi untuk beralih ke wilayah tujuan (jika ada), dan konfirmasikan bahwa gambar baru Anda muncul dalam daftar gambar.
Gambar baru pertama kali muncul dengan status **Menyalin** di registri gambar konsol Anda. Setelah gambar berhasil dibuat, status gambar berubah menjadi **Tersedia**, yang berarti Anda dapat menggunakan gambar untuk meluncurkan tumpukan dan mengalirkan aplikasi Anda.
## Langkah 8: Bersihkan
Terakhir, hentikan pembuat gambar Anda yang sedang berjalan untuk membebaskan sumber daya dan menghindari biaya yang tidak diinginkan ke akun Anda. Kami merekomendasikan untuk menghentikan pembuat gambar yang tidak terpakai dan berjalan. Untuk informasi selengkapnya, lihat [Harga WorkSpaces Aplikasi](https://aws.amazon.com/appstream2/pricing/).
**Untuk menghentikan pembuat gambar yang sedang berjalan**
1. Di panel navigasi, pilih **Gambar**, **Pembuat Gambar**, dan pilih instance pembuat gambar yang sedang berjalan.
1. Pilih **Tindakan**, **Berhenti**.
# Kelola Gambar WorkSpaces Aplikasi Amazon Anda
Gambar yang tersedia tercantum dalam **Image Registry** di konsol WorkSpaces Aplikasi, dan dikategorikan berdasarkan visibilitas sebagai berikut:
+ **Publik** — Gambar dasar yang dimiliki dan disediakan oleh AWS. Gambar dasar termasuk sistem operasi Windows terbaru dan perangkat lunak agen WorkSpaces Aplikasi. Anda dapat menggunakan gambar dasar ini untuk membuat gambar baru yang menyertakan aplikasi Anda sendiri. Untuk informasi tentang gambar dasar yang dirilis oleh AWS, lihat[WorkSpaces Catatan Rilis Pembaruan Gambar Dasar Aplikasi dan Gambar Terkelola](base-image-version-history.md).
+ **Private** — Gambar yang Anda buat dan miliki, dan yang belum Anda bagikan dengan AWS akun lain.
+ **Dibagikan dengan orang lain** — Gambar yang Anda buat dan miliki, dan yang telah Anda bagikan dengan satu atau beberapa AWS akun di AWS Wilayah yang sama. Ketika Anda berbagi gambar dengan AWS akun lain, Anda dapat menentukan apakah gambar dapat digunakan untuk pembuat gambar (untuk membuat gambar baru), untuk armada, atau keduanya.
+ **Dibagikan dengan saya** — Gambar yang dibuat dan dimiliki oleh AWS akun lain di AWS Wilayah yang sama, dan yang dibagikan dengan AWS akun Anda. Bergantung pada izin yang diberikan pemilik saat berbagi gambar dengan akun Anda, Anda dapat menggunakan gambar ini untuk pembuat gambar, untuk armada, atau keduanya.
**Topics**
+ [Hapus Gambar Pribadi di WorkSpaces Aplikasi Amazon](delete-private-image.md)
+ [Salin Gambar yang Anda Miliki ke AWS Wilayah Lain di WorkSpaces Aplikasi Amazon](copy-image-different-region.md)
+ [Bagikan Gambar yang Anda Miliki Dengan AWS Akun Lain di WorkSpaces Aplikasi Amazon](share-image-with-another-account.md)
+ [Berhenti Berbagi Gambar yang Anda Miliki di WorkSpaces Aplikasi Amazon](stop-sharing-image-with-all-accounts.md)
+ [Simpan Gambar WorkSpaces Aplikasi Amazon Anda Up-to-Date](keep-image-updated.md)
+ [Pembaruan Windows dan Perangkat Lunak Antivirus di WorkSpaces Aplikasi Amazon](windows-update-antivirus-software.md)
+ [Buat Gambar Baru Secara Terprogram di Aplikasi Amazon WorkSpaces](create-image-programmatically.md)
+ [Kelola Aplikasi Termasuk Lisensi pada Gambar Anda di WorkSpaces Aplikasi Amazon](license-included-applications.md)
+ [Impor Gambar](import-image.md)
+ [Ekspor Gambar](export-image.md)
# Hapus Gambar Pribadi di WorkSpaces Aplikasi Amazon
Anda dapat menghapus gambar pribadi Anda ketika Anda tidak lagi membutuhkannya. Anda tidak dapat menghapus gambar yang digunakan oleh armada atau dibagikan dengan AWS akun lain. Untuk menghapus gambar yang digunakan oleh armada atau dibagikan, Anda harus terlebih dahulu menghapus gambar dari armada apa pun dan menghapus semua izin berbagi gambar. Setelah Anda menghapus gambar, Anda tidak dapat memulihkannya.
**Untuk menghapus gambar pribadi**
1. Buka konsol WorkSpaces Aplikasi di [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).
1. Di panel navigasi, pilih **Gambar**, **Registri Gambar**.
1. Dalam daftar gambar, pilih gambar pribadi yang ingin Anda hapus.
1. Pilih **Tindakan**, **Hapus**, lalu pilih **Hapus** lagi.
Gambar dihapus dari registri gambar dan dihapus.
# Salin Gambar yang Anda Miliki ke AWS Wilayah Lain di WorkSpaces Aplikasi Amazon
**penting**
Untuk Wilayah AWS Asia Pasifik (Malaysia), Eropa (Milan), Eropa (Spanyol), dan Israel (Tel Aviv): Penyalinan gambar lintas wilayah hanya didukung untuk gambar WorkSpaces dengan versi agen Aplikasi yang on/after dirilis 02 Oktober 2025, atau gambar menggunakan pembaruan terkelola yang on/after dirilis 05 September 2025. Versi lama tidak memenuhi syarat untuk menyalin antar wilayah. Perbarui gambar Anda untuk memenuhi persyaratan versi minimum ini untuk mengaktifkan fungsionalitas penyalinan lintas wilayah.
Anda dapat menyalin gambar yang Anda miliki ke AWS Wilayah lain. Menggunakan gambar yang sama di berbagai AWS Wilayah dapat membantu menyederhanakan penerapan global aplikasi Anda di Aplikasi. WorkSpaces Dengan menerapkan aplikasi Anda di AWS Wilayah yang secara geografis paling dekat dengan pengguna Anda, Anda dapat membantu memberikan pengalaman yang lebih responsif kepada pengguna Anda.
**Untuk menyalin gambar yang Anda miliki ke AWS Wilayah lain**
1. Buka konsol WorkSpaces Aplikasi di [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).
1. Di panel navigasi, pilih **Gambar**, **Registri Gambar**.
1. Dalam daftar gambar, pilih gambar yang ingin Anda salin ke AWS Wilayah lain.
1. Pilih **Tindakan**, **Salin**.
1. Dalam kotak dialog **Salin gambar**, di **Wilayah tujuan**, pilih AWS Wilayah yang ingin Anda salin gambarnya.
1. Ketik nama unik dan opsional, deskripsi untuk gambar di **wilayah Tujuan**.
1. Pilih **Salin Gambar**.
# Bagikan Gambar yang Anda Miliki Dengan AWS Akun Lain di WorkSpaces Aplikasi Amazon
WorkSpaces Gambar aplikasi adalah sumber daya regional, sehingga Anda dapat berbagi gambar yang Anda miliki dengan AWS akun lain dalam AWS Wilayah yang sama. Melakukan hal itu dapat membantu dalam beberapa skenario yang berbeda. Misalnya, jika Anda memisahkan sumber daya pengembangan dan produksi dengan menggunakan AWS akun yang berbeda, Anda dapat membuat gambar dengan menggunakan akun pengembangan Anda. Kemudian Anda dapat berbagi gambar dengan akun produksi Anda. Jika organisasi Anda adalah vendor perangkat lunak independen (ISV), Anda dapat berbagi gambar yang dioptimalkan dengan pelanggan Anda. Gambar yang dioptimalkan yang memiliki aplikasi yang diperlukan sudah diinstal dan dikonfigurasi memungkinkan pelanggan Anda memulai dengan aplikasi Anda dengan cepat, sehingga mereka tidak perlu menginstal dan mengkonfigurasi aplikasi itu sendiri.
Saat Anda berbagi gambar dengan AWS akun lain, Anda menentukan apakah akun tujuan dapat menggunakan gambar dalam armada atau membuat gambar baru dengan membuat pembuat gambar. Anda terus memiliki gambar yang Anda bagikan. Dengan cara ini, Anda dapat menambahkan, mengubah, atau menghapus izin sesuai kebutuhan untuk gambar yang Anda bagikan.
Jika Anda berbagi gambar dengan akun dan memberikan izin armada akun, gambar bersama dapat digunakan untuk membuat atau memperbarui armada di akun tersebut. Jika Anda menghapus izin ini nanti, akun tidak dapat lagi menggunakan gambar. Untuk armada di akun yang menggunakan gambar bersama, kapasitas yang diinginkan diatur ke 0, yang mencegah instance armada baru dibuat. Sesi yang ada berlanjut hingga sesi streaming berakhir. Agar instance armada baru dibuat, armada di akun tersebut harus diperbarui dengan gambar yang valid.
Jika Anda berbagi gambar dengan akun dan memberikan izin pembuat gambar akun, gambar bersama dapat digunakan untuk membuat pembuat gambar dan gambar di akun tersebut. Jika Anda menghapus izin ini nanti, pembuat gambar dan gambar yang dibuat dari gambar Anda tidak akan terpengaruh.
**penting**
Setelah membagikan gambar dengan akun, Anda tidak dapat mengontrol pembuat gambar atau gambar di akun yang dibuat dari gambar Anda. Untuk alasan ini, berikan izin pembuat gambar ke akun hanya jika Anda ingin mengaktifkan akun untuk membuat salinan gambar Anda, dan pertahankan akses ke salinan setelah Anda berhenti membagikan gambar Anda.
**Untuk berbagi gambar yang Anda miliki dengan AWS akun lain**
1. Buka konsol WorkSpaces Aplikasi di [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).
1. Di panel navigasi, pilih **Gambar**, **Registri Gambar**.
1. Dalam daftar gambar, pilih gambar yang ingin Anda bagikan.
1. Pilih **Tindakan**, **Bagikan**.
1. Dalam kotak dialog **Bagikan gambar**, pilih **Tambah akun**.
1. Ketik 12 digit ID AWS akun dari akun yang ingin Anda bagikan gambarnya, lalu pilih apakah akun dapat melakukan salah satu atau kedua hal berikut:
+ Gunakan gambar untuk meluncurkan pembuat gambar, jika Anda ingin membuat gambar baru.
+ Gunakan gambar dengan armada.
Untuk menghapus akun dari daftar akun tempat gambar dibagikan, di baris untuk akun yang ingin Anda hapus, pilih ikon X di sebelah kanan opsi **Gunakan untuk armada**.
1. Untuk berbagi gambar dengan lebih banyak AWS akun, ulangi langkah 6 untuk setiap akun yang ingin Anda bagikan gambarnya.
1. Pilih **Bagikan Gambar**.
**Untuk menambah atau memperbarui izin berbagi gambar untuk gambar yang Anda miliki**
1. Buka konsol WorkSpaces Aplikasi di [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).
1. Di panel navigasi, pilih **Gambar**, **Registri Gambar**.
1. Dalam daftar gambar, pilih gambar yang ingin Anda ubah izinnya.
1. Di bawah daftar gambar, pilih tab **Izin** untuk gambar yang Anda pilih, lalu pilih **Edit**.
1. Dalam kotak dialog **Edit izin gambar**, pilih atau hapus salah satu atau kedua opsi berbagi gambar berikut sesuai kebutuhan untuk satu atau beberapa AWS akun. Jika Anda menghapus kedua opsi untuk akun, gambar tidak lagi dibagikan dengan akun itu.
+ Gunakan gambar untuk meluncurkan pembuat gambar, jika Anda ingin membuat gambar baru.
+ Gunakan gambar dengan armada.
Untuk menghapus akun dari daftar akun tempat gambar dibagikan, di baris untuk akun yang ingin Anda hapus, pilih ikon X di sebelah kanan opsi **Gunakan untuk armada**.
1. Untuk mengedit izin berbagi gambar untuk lebih banyak AWS akun, ulangi langkah 5 untuk setiap akun yang ingin Anda perbarui izinnya.
1. Pilih **Perbarui izin berbagi gambar**.
# Berhenti Berbagi Gambar yang Anda Miliki di WorkSpaces Aplikasi Amazon
Ikuti langkah-langkah ini untuk berhenti berbagi gambar yang Anda miliki dengan AWS akun lain.
**Untuk berhenti berbagi gambar yang Anda miliki dengan AWS akun lain**
1. Buka konsol WorkSpaces Aplikasi di [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).
1. Di panel navigasi, pilih **Gambar**, **Registri Gambar**.
1. Dalam daftar gambar, pilih gambar yang ingin Anda ubah izinnya.
1. Di bawah daftar gambar, pilih tab **Izin** untuk gambar yang Anda pilih, lalu pilih **Edit**.
1. Di kotak dialog **Edit izin gambar**, di baris untuk semua AWS akun tempat gambar dibagikan, pilih ikon X di sebelah kanan opsi **Gunakan untuk armada**.
1. Pilih **Perbarui izin berbagi gambar**.
# Simpan Gambar WorkSpaces Aplikasi Amazon Anda Up-to-Date
Anda dapat menyimpan gambar WorkSpaces Aplikasi Anda up-to-date dengan melakukan salah satu dari berikut ini:
+ [Memperbarui Gambar dengan Menggunakan Pembaruan Gambar WorkSpaces Aplikasi Terkelola](keep-image-updated-managed-image-updates.md)— Metode pembaruan ini menyediakan pembaruan sistem operasi terbaru dan pembaruan driver, dan perangkat lunak agen WorkSpaces Aplikasi terbaru.
+ [Perbarui Perangkat Lunak Agen WorkSpaces Aplikasi dengan Menggunakan Versi Agen WorkSpaces Aplikasi Terkelola](keep-image-updated-manage-image-versions.md)— Metode pembaruan ini menyediakan perangkat lunak agen WorkSpaces Aplikasi terbaru.
# Memperbarui Gambar dengan Menggunakan Pembaruan Gambar WorkSpaces Aplikasi Terkelola
WorkSpaces Aplikasi menyediakan cara otomatis untuk memperbarui gambar Anda dengan pembaruan sistem operasi terbaru, lisensi termasuk pembaruan aplikasi, pembaruan driver, dan perangkat lunak agen WorkSpaces Aplikasi. Dengan pembaruan gambar WorkSpaces Aplikasi terkelola, Anda memilih gambar yang ingin Anda perbarui. WorkSpaces Aplikasi membuat pembuat gambar di AWS akun dan Wilayah yang sama untuk menginstal pembaruan dan membuat gambar baru. Setelah gambar baru dibuat, Anda dapat mengujinya pada armada pra-produksi sebelum memperbarui armada produksi Anda atau berbagi gambar dengan akun lain AWS .
**catatan**
Pembaruan Gambar WorkSpaces Aplikasi Terkelola tersedia untuk sistem operasi Microsoft Windows Server, Red Hat Enterprise Linux, dan Rocky Linux.
**catatan**
Setelah gambar baru Anda dibuat, Anda bertanggung jawab untuk mempertahankan pembaruan untuk sistem operasi. Untuk melakukannya, Anda dapat terus menggunakan pembaruan gambar WorkSpaces Aplikasi terkelola.
Anda bertanggung jawab untuk menjaga pembaruan untuk driver Amazon EC2 Windows Paravirtual (PV), driver ENA, dan driver. AWS NVMe Untuk informasi selengkapnya tentang cara memperbarui driver, lihat [Mengelola driver perangkat untuk instans EC2 Anda](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/manage-device-drivers.html).
Anda juga bertanggung jawab untuk memelihara aplikasi Anda dan dependensinya. Untuk menambahkan aplikasi lain, memperbarui aplikasi yang ada, atau mengubah pengaturan gambar, Anda harus memulai dan menyambung kembali ke pembuat gambar yang Anda gunakan untuk membuat gambar. Atau, jika Anda menghapus pembuat gambar itu, luncurkan pembuat gambar baru yang didasarkan pada gambar Anda. Kemudian, buat perubahan Anda dan buat gambar baru.
## Prasyarat
Berikut ini adalah prasyarat dan pertimbangan untuk bekerja dengan pembaruan gambar terkelola.
+ Pastikan kuota akun WorkSpaces Aplikasi Anda (juga disebut sebagai batas) cukup untuk mendukung pembuatan pembuat gambar baru dan gambar baru. Untuk meminta peningkatan kuota, Anda dapat menggunakan konsol Service Quotas di. [https://console.aws.amazon.com/servicequotas/](https://console.aws.amazon.com/servicequotas/) Untuk informasi tentang kuota WorkSpaces Aplikasi default, lihat[Service Quotas WorkSpaces Aplikasi Amazon](limits.md).
+ Anda harus memiliki gambar yang Anda perbarui. Anda tidak dapat memperbarui gambar yang dibagikan dengan Anda.
+ Saat WorkSpaces Aplikasi membuat pembuat gambar untuk menginstal pembaruan sistem operasi terbaru, pembaruan driver, dan perangkat lunak agen WorkSpaces Aplikasi, dan membuat gambar baru, Anda dikenakan biaya untuk instance pembuat gambar saat memperbarui.
+ Gambar yang didukung harus dibuat dari gambar dasar yang dirilis pada 2017-07-24T 00:00:00 Z atau yang lebih baru.
+ Bahasa Inggris dan Jepang adalah bahasa tampilan yang didukung. Untuk informasi selengkapnya, lihat [Tentukan Bahasa Tampilan Default](configure-default-display-language.md).
+ Gunakan versi terbaru dari SSM Agent. Untuk informasi versi, lihat [WorkSpaces Catatan Rilis Pembaruan Gambar Dasar Aplikasi dan Gambar Terkelola](base-image-version-history.md). Untuk informasi penginstalan, lihat [Menginstal Agen SSM secara manual pada instans EC2 untuk Windows Server](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-win.html).
## Cara Memperbarui Gambar dengan Menggunakan WorkSpaces Aplikasi Terkelola Pembaruan Gambar
Untuk memperbarui gambar WorkSpaces Aplikasi dengan tambalan terbaru, pembaruan driver, dan perangkat lunak agen WorkSpaces Aplikasi, lakukan langkah-langkah berikut.
1. Buka konsol WorkSpaces Aplikasi di [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).
1. Di panel navigasi, pilih **Gambar**, **Registri Gambar**.
1. Dalam daftar gambar, pilih gambar yang ingin Anda perbarui. Verifikasi bahwa status gambar **tersedia**.
1. Pilih **Tindakan**, **Perbarui**.
1. Dalam kotak dialog **Perbarui gambar**, lakukan hal berikut:
+ Untuk **nama gambar baru**, masukkan nama gambar yang unik di dalam AWS akun dan Wilayah. Nama gambar tidak dapat dimulai dengan “Amazon,” “AWS,” atau “AppStream.”
+ Untuk **nama tampilan gambar baru**, Anda dapat secara opsional memasukkan nama untuk ditampilkan untuk gambar.
+ Untuk **deskripsi gambar baru**, Anda dapat memberikan deskripsi untuk gambar secara opsional.
+ Untuk **Tag**, Anda dapat memilih **Tambah Tag**, dan ketik kunci dan nilai untuk tag. Untuk menambahkan lebih banyak tag, ulangi langkah ini. Untuk informasi selengkapnya, lihat [Menandai Sumber Daya WorkSpaces Aplikasi Amazon Anda](tagging-basic.md).
1. Pilih **Perbarui gambar**.
Jika gambar Anda saat ini sudah up to date, sebuah pesan akan memberi tahu Anda.
1. Di panel navigasi, pilih **Gambar**, lalu pilih **Image Builder**.
1. Dalam daftar pembuat gambar, verifikasi bahwa pembuat gambar baru muncul di status **Memperbarui**. Nama pembuat gambar mencakup sufiks 10 digit acak.
Pembuat gambar adalah ukuran terkecil dalam keluarga instance yang Anda pilih untuk gambar baru di langkah 5. Tidak ada subnet yang ditentukan karena pembuat gambar tidak dilampirkan ke virtual private cloud (VPC) Anda.
1. Pilih **Image Registry** dan verifikasi bahwa gambar baru Anda muncul dalam daftar.
Saat gambar Anda sedang dibuat, status gambar di registri gambar konsol muncul sebagai **Membuat**.
1. Setelah gambar Anda dibuat, WorkSpaces Aplikasi melakukan proses kualifikasi untuk memverifikasi bahwa gambar berfungsi seperti yang diharapkan.
Selama waktu ini, pembuat gambar, yang juga digunakan untuk proses ini, muncul di daftar **Image Builder** dengan status **Kualifikasi Tertunda**.
1. Setelah proses kualifikasi berhasil diselesaikan, pesan **Sukses** muncul di bagian atas konsol dan status gambar di registri gambar muncul sebagai **Tersedia**.
Selain itu, pembuat gambar yang dibuat WorkSpaces Aplikasi dihapus secara otomatis.
**catatan**
Tergantung pada volume pembaruan sistem operasi, mungkin diperlukan beberapa jam untuk pembaruan gambar selesai. **Jika masalah mencegah gambar diperbarui, ikon merah dengan tanda seru muncul di sebelah nama gambar, dan status gambar di registri gambar muncul sebagai Gagal.** Jika ini terjadi, pilih gambar, pilih tab **Pemberitahuan**, dan tinjau notifikasi kesalahan apa pun. Untuk informasi selengkapnya, lihat informasi di [Image Layanan Internal](troubleshooting-notification-codes.md#troubleshooting-notification-codes-image) bagian dokumentasi untuk memecahkan masalah kode notifikasi.
Jika proses kualifikasi tidak berhasil, pembuat gambar yang dibuat WorkSpaces Aplikasi masih dihapus secara otomatis.
1. Setelah WorkSpaces Aplikasi membuat gambar baru, uji gambar pada armada pra-produksi. Setelah Anda memverifikasi bahwa aplikasi Anda berfungsi seperti yang diharapkan, perbarui armada produksi Anda dengan gambar baru.
# Perbarui Perangkat Lunak Agen WorkSpaces Aplikasi dengan Menggunakan Versi Agen WorkSpaces Aplikasi Terkelola
WorkSpaces Aplikasi menyediakan cara otomatis untuk memperbarui pembuat gambar Anda dengan perangkat lunak agen WorkSpaces Aplikasi yang lebih baru. Melakukan hal itu memungkinkan Anda untuk membuat gambar baru setiap kali versi baru dari agen dirilis. Anda kemudian dapat menguji gambar sebelum memperbarui armada produksi Anda. Untuk informasi selengkapnya tentang cara mengelola perangkat lunak agen WorkSpaces Aplikasi, lihat[Kelola Versi Agen WorkSpaces Aplikasi](base-images-agent.md).
**catatan**
Anda bertanggung jawab untuk menginstal dan memelihara pembaruan untuk sistem operasi Windows, aplikasi Anda, dan dependensinya.
Untuk menjaga gambar WorkSpaces Aplikasi Anda diperbarui dengan pembaruan sistem operasi Windows terbaru, lakukan salah satu hal berikut:
+ Instal aplikasi Anda pada gambar dasar terbaru setiap kali gambar baru dirilis.
+ Instal pembaruan untuk sistem operasi Windows, aplikasi Anda, dan dependensinya pada pembuat gambar yang ada.
+ Instal pembaruan untuk sistem operasi Windows, aplikasi Anda, dan dependensinya pada pembuat gambar baru dari gambar yang ada.
Setelah Anda membuat gambar baru dengan sistem operasi Windows terbaru, aplikasi dan dependensinya, dan perangkat lunak agen WorkSpaces Aplikasi, uji gambar pada armada pengembangan. Setelah Anda memverifikasi bahwa aplikasi Anda berfungsi seperti yang diharapkan, perbarui armada produksi Anda dengan gambar baru.
# Pembaruan Windows dan Perangkat Lunak Antivirus di WorkSpaces Aplikasi Amazon
WorkSpaces Instans streaming aplikasi tidak persisten. Ketika sesi streaming pengguna berakhir, WorkSpaces Aplikasi menghentikan instans yang digunakan oleh sesi dan, tergantung pada kebijakan penskalaan Anda, menyediakan instans baru untuk menggantinya di armada Anda. Semua instance armada disediakan dari gambar yang sama. Karena gambar tidak dapat diubah setelah dibuat, semua instance armada yang digunakan dalam sesi streaming pengguna hanya memiliki pembaruan Windows dan aplikasi yang diinstal pada gambar yang mendasarinya saat gambar dibuat. Selain itu, karena instance armada yang digunakan untuk sesi streaming berakhir pada akhir sesi, pembaruan apa pun yang dilakukan ke Windows atau aplikasi pada instans selama sesi streaming tidak akan bertahan untuk sesi future oleh pengguna yang sama atau pengguna lain.
**catatan**
Jika Anda mengaktifkan persistensi pengaturan aplikasi untuk tumpukan Anda, WorkSpaces Aplikasi akan mempertahankan perubahan konfigurasi Windows dan aplikasi yang dibuat oleh pengguna ke sesi future untuk pengguna yang sama jika perubahan konfigurasi tersebut disimpan di profil Windows pengguna. Namun, fitur persistensi pengaturan aplikasi hanya bertahan Windows dan pengaturan konfigurasi aplikasi. Itu tidak bertahan pembaruan perangkat lunak untuk Windows atau aplikasi pada instance streaming.
Untuk alasan ini, WorkSpaces Aplikasi mengambil pendekatan berikut untuk Pembaruan Windows dan perangkat lunak antivirus pada instance WorkSpaces Aplikasi.
## Pembaruan Windows
Pembaruan Windows tidak diaktifkan secara default pada gambar dasar WorkSpaces Aplikasi. Jika Anda mengaktifkan Pembaruan Windows pada pembuat gambar dan kemudian mencoba membuat gambar, Asisten Gambar menampilkan peringatan dan menonaktifkan Pembaruan Windows selama proses pembuatan gambar. Untuk memastikan bahwa instans armada Anda memiliki pembaruan Windows terbaru yang diinstal, kami sarankan Anda menginstal pembaruan Windows pada pembuat gambar Anda, membuat gambar baru, dan memperbarui armada Anda dengan gambar baru secara teratur.
## Perangkat Lunak Antivirus
Jika Anda memilih untuk menginstal perangkat lunak antivirus pada gambar Anda, kami sarankan Anda tidak mengaktifkan pembaruan otomatis untuk perangkat lunak antivirus. Jika tidak, perangkat lunak antivirus dapat mencoba memperbarui dirinya sendiri dengan file definisi terbaru atau pembaruan lainnya selama sesi pengguna. Ini dapat mempengaruhi kinerja. Selain itu, pembaruan apa pun yang dilakukan pada perangkat lunak antivirus tidak akan bertahan di luar sesi pengguna saat ini. Untuk memastikan bahwa instans armada Anda selalu memiliki pembaruan antivirus terbaru, kami sarankan Anda melakukan salah satu hal berikut:
+ Perbarui pembuat gambar Anda dan buat gambar baru secara teratur (misalnya, dengan menggunakan [operasi CLI Asisten Gambar](https://docs.aws.amazon.com/appstream2/latest/developerguide/programmatically-create-image.html)).
+ Gunakan aplikasi antivirus yang mendelegasikan pemindaian atau operasi lain ke server always-up-to-date eksternal.
**catatan**
Bahkan jika Anda tidak mengaktifkan pembaruan otomatis untuk perangkat lunak antivirus Anda, perangkat lunak antivirus dapat melakukan pemindaian hard drive atau operasi lain yang dapat memengaruhi kinerja instance armada Anda selama sesi pengguna.
Pada WorkSpaces Aplikasi Windows Server 2025/2022/2019/2016 gambar dasar yang dipublikasikan pada atau setelah 10 September 2019, Windows Defender tidak diaktifkan secara default. Pada WorkSpaces Aplikasi Windows Server 2016 dan Windows Server 2019 gambar dasar yang diterbitkan pada 24 Juni 2019, Windows Defender diaktifkan secara default.
**Untuk mengaktifkan Windows Defender secara manual**
Jika Windows Defender tidak diaktifkan pada gambar dasar Anda, Anda dapat mengaktifkannya secara manual. Untuk melakukannya, selesaikan langkah-langkah berikut.
1. Buka konsol WorkSpaces Aplikasi di [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).
1. Di panel navigasi kiri, pilih **Images**, **Image Builder**.
1. Pilih pembuat gambar untuk mengaktifkan Windows Defender, verifikasi bahwa itu dalam status **Running**, dan pilih **Connect**.
1. Masuk ke pembuat gambar dengan akun **Administrator** lokal atau dengan akun domain yang memiliki izin administrator lokal.
1. Buka Editor Registri.
1. Arahkan ke lokasi berikut di registri: **HKLM\$1 SOFTWARE\$1 Policies\$1 Microsoft\$1 Windows Defender\$1**. DisableAntiSpyware
1. **Untuk mengedit kunci registri ini, klik dua kali, atau klik kanan kunci registri, dan pilih Ubah.**
1. **Dalam kotak dialog **Edit Nilai DWORD (32-bit)**, di **Data nilai**, ubah **1 menjadi 0**.**
1. Pilih **OK**.
1. Tutup Editor Registri.
1. Buka snap-in () **Layanan** Microsoft Management Console (`services.msc`MMC).
1. Dalam daftar layanan, lakukan salah satu hal berikut.
Jika Anda menggunakan Microsoft Windows Server 2022/2025, lakukan salah satu hal berikut:
+ **Klik kanan **Microsoft Defender Antivirus Service**, dan pilih Mulai.**
+ **Klik dua kali **Microsoft Defender Antivirus Service**, pilih **Mulai** di kotak dialog properti, lalu pilih OK.**
Jika Anda menggunakan Microsoft Windows Server 2019 atau 2016, lakukan salah satu hal berikut:
+ **Klik kanan **Windows Defender Antivirus Service**, dan pilih Mulai.**
+ **Klik dua kali **Windows Defender Antivirus Service**, pilih **Mulai** di kotak dialog properti, lalu pilih OK.**
1. Tutup snap-in **Layanan**.
# Buat Gambar Baru Secara Terprogram di Aplikasi Amazon WorkSpaces
Anda dapat membuat gambar WorkSpaces Aplikasi secara terprogram dengan menghubungkan ke pembuat gambar dan menggunakan operasi antarmuka baris perintah Image Assistant (CLI). Untuk informasi selengkapnya, lihat [Buat Gambar WorkSpaces Aplikasi Amazon Anda Secara Terprogram dengan Menggunakan Operasi CLI Asisten Gambar](programmatically-create-image.md).
# Kelola Aplikasi Termasuk Lisensi pada Gambar Anda di WorkSpaces Aplikasi Amazon
Anda dapat melakukan streaming aplikasi lisensi Microsoft berikut yang disertakan menggunakan WorkSpaces Aplikasi. Anda dapat menginstal aplikasi ini pada Gambar Windows Anda, menggunakan gambar khusus ini untuk membuat armada, dan kemudian streaming aplikasi ini. Semua aplikasi berikut tersedia dalam arsitektur 32-bit dan 64-bit:
+ Microsoft Office LTSC Professional Plus 2021/2024
+ Microsoft Visio LTSC Professional 2021/2024
+ Microsoft Project Professional 2021/2024
+ Microsoft Office LTSC Standar 2021/2024
+ Microsoft Visio LTSC Standar 2021/2024
+ Standar Proyek Microsoft 2021/2024
**penting**
Microsoft Office, Visio, dan Project harus mengikuti versi yang sama. Misalnya, Anda tidak dapat mencampur aplikasi 2021 dengan 2024 aplikasi.
Microsoft Office, Visio, dan Project harus mengikuti arsitektur yang sama. Misalnya, Anda tidak dapat mencampur aplikasi 32-bit dengan aplikasi 64-bit.
Standard/Professional versions are supported on Microsoft Windows Server 2019/2022/2025. Microsoft Office, Visio, and Project 2024 Standard/ProfessionalVersi Microsoft Office, Visio, dan Project 2021 didukung di Microsoft Windows Server 2022 dan 2025.
Untuk mengaktifkan fitur ini, Anda harus menggunakan WorkSpaces Applications Image Builder yang menggunakan agen WorkSpaces Aplikasi yang dirilis pada atau setelah 2 Oktober 2025. Untuk informasi selengkapnya, lihat [Kelola Versi Agen WorkSpaces Aplikasi](base-images-agent.md). Atau, gambar Anda harus menggunakan pembaruan gambar WorkSpaces Aplikasi terkelola yang dirilis pada atau setelah 3 Oktober 2025. Untuk informasi selengkapnya, lihat [Simpan Gambar WorkSpaces Aplikasi Amazon Anda Up-to-Date](keep-image-updated.md).
TCP keluar pada port 1688 harus terbuka pada antarmuka jaringan manajemen semua instance streaming.
Semua pengguna yang streaming melalui armada yang didukung oleh gambar dengan satu atau lebih aplikasi berlisensi dikenakan tagihan untuk aplikasi ini setiap bulan, terlepas dari penggunaannya. Fitur hak aplikasi tidak membatasi akses untuk pengguna tertentu.
Aplikasi yang disertakan lisensi pada Image Builder tidak diaktifkan karena diinstal untuk tujuan administratif. Aktivasi terjadi ketika pengguna melakukan streaming melalui instance armada.
**Topics**
+ [Lihat daftar aplikasi yang disertakan lisensi yang diinstal pada gambar Anda](view-list-image.md)
+ [Lihat daftar aplikasi yang disertakan lisensi pada pembuat gambar Anda](view-list-apps.md)
+ [Instal atau hapus instalan aplikasi yang disertakan lisensi](install-uninstall-apps.md)
+ [Aktifkan pembaruan untuk aplikasi yang disertakan lisensi pada pembuat gambar](updates-image-builder.md)
+ [Aktifkan pembaruan untuk aplikasi yang disertakan lisensi pada pembuat gambar dengan Powershell](enable-updates-managed-powershell.md)
+ [Aktifkan pembaruan untuk aplikasi yang disertakan lisensi pada pembuat gambar dengan Pembaruan Gambar Terkelola](enable-updates-managed.md)
# Lihat daftar aplikasi yang disertakan lisensi yang diinstal pada gambar Anda
**Lihat daftar aplikasi yang disertakan lisensi yang diinstal pada gambar Anda**
Untuk melihat daftar aplikasi yang disertakan lisensi yang diinstal pada gambar Anda, ikuti langkah-langkah ini.
1. Buka konsol WorkSpaces Aplikasi di [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).
1. Pilih **Gambar** di panel navigasi kiri dan tab **Image Registry**.
1. Pilih gambar, dan pilih **Lihat Detail**.
1. Tinjau daftar semua aplikasi yang diinstal di bawah aplikasi yang **disertakan Lisensi**.
# Lihat daftar aplikasi yang disertakan lisensi pada pembuat gambar Anda
**Lihat daftar aplikasi yang disertakan lisensi pada pembuat gambar Anda**
Untuk melihat daftar aplikasi yang disertakan lisensi pada pembuat gambar Anda, ikuti langkah-langkah ini.
1. Buka konsol WorkSpaces Aplikasi di [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).
1. Pilih **Gambar** di panel navigasi kiri dan tab **Pembuat gambar**.
1. Pilih pembuat gambar, dan pilih **Lihat detail**.
1. Tinjau daftar aplikasi dan statusnya di bawah **aplikasi yang disertakan Lisensi**.
# Instal atau hapus instalan aplikasi yang disertakan lisensi
**Instal atau hapus instalan aplikasi yang disertakan lisensi**
Untuk menginstal atau menghapus satu atau beberapa aplikasi yang disertakan lisensi pada gambar Anda, ikuti langkah-langkah ini.
1. Lengkapi salah satu opsi berikut:
+ Luncurkan Builder gambar dan konfigurasikan aplikasi yang disertakan lisensi. Untuk informasi selengkapnya, lihat [Luncurkan Image Builder untuk Menginstal dan Mengkonfigurasi Aplikasi Streaming](tutorial-image-builder-create.md).
+ Kelola aplikasi yang disertakan lisensi pada pembuat gambar Anda. Untuk informasi selengkapnya, lihat [Hak Aplikasi Berbasis Atribut Menggunakan Penyedia Identitas SAMP 2.0 Pihak Ketiga](application-entitlements-saml.md).
1. Ketika Anda memiliki gambar yang dibuat dengan satu atau lebih aplikasi termasuk lisensi, Anda dapat menggunakan gambar ini untuk membuat armada. Pengguna yang terhubung ke armada ini dapat mengakses aplikasi ini.
**penting**
Semua pengguna yang streaming melalui armada yang didukung oleh gambar dengan satu atau lebih aplikasi berlisensi akan dikenakan tagihan untuk aplikasi ini setiap bulan, terlepas dari penggunaannya. Fitur hak aplikasi tidak membatasi akses untuk pengguna tertentu.
Jika Anda mengalami kegagalan selama instalasi atau penghapusan instalasi aplikasi yang disertakan dengan lisensi, Anda akan melihat status kegagalan pada halaman detail Pembuat Gambar Anda. Untuk mengatasi masalah ini, sebaiknya sambungkan ke Image Builder Anda dan mengaktifkan pencatatan verbose. Untuk informasi selengkapnya, lihat [Cara mengaktifkan Aplikasi Microsoft 365 untuk pencatatan perusahaan](https://learn.microsoft.com/en-us/troubleshoot/microsoft-365-apps/diagnostic-logs/how-to-enable-office-365-proplus-uls-logging). Jika masalah berlanjut setelah meninjau log dan pemecahan masalah, hubungi untuk bantuan. AWS Dukungan
# Aktifkan pembaruan untuk aplikasi yang disertakan lisensi pada pembuat gambar
**Aktifkan pembaruan untuk aplikasi yang disertakan lisensi pada pembuat gambar**
Pembaruan untuk semua aplikasi yang disertakan lisensi dinonaktifkan secara default. Anda dapat mengaktifkan pembaruan untuk aplikasi ini pada pembuat gambar dengan gambar yang menyertakan satu atau lebih aplikasi ini. Pembaruan pada instance armada tetap dinonaktifkan untuk mencegah penginstalan selama penyiapan sesi.
Ada tiga opsi untuk mengaktifkan pembaruan untuk aplikasi yang disertakan lisensi pada pembuat gambar.
Untuk mengaktifkan pembaruan untuk lisensi termasuk aplikasi pada pembuat gambar dengan menu aplikasi, ikuti langkah-langkah ini.
1. Buka aplikasi apa pun yang termasuk lisensi.
1. Pilih **File**, **Akun**, **Opsi Pembaruan**, dan **Aktifkan Pembaruan**.
# Aktifkan pembaruan untuk aplikasi yang disertakan lisensi pada pembuat gambar dengan Powershell
Untuk mengaktifkan pembaruan untuk aplikasi yang disertakan lisensi pada pembuat gambar dengan Powershell, ikuti langkah-langkah ini.
+ Jalankan perintah berikut dengan PowerShell sebagai administrator:
`Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Office\ClickToRun\Configuration" -Name UpdatesEnabled -Value True `
# Aktifkan pembaruan untuk aplikasi yang disertakan lisensi pada pembuat gambar dengan Pembaruan Gambar Terkelola
Untuk mengaktifkan pembaruan untuk aplikasi yang disertakan lisensi pada pembuat gambar dengan Pembaruan Gambar Terkelola, ikuti langkah-langkah ini.
+ Gunakan Pembaruan Gambar Terkelola untuk menerima pembaruan pada aplikasi yang disertakan lisensi Microsoft. Untuk informasi selengkapnya, silakan lihat
[Memperbarui Gambar dengan Menggunakan Pembaruan Gambar WorkSpaces Aplikasi Terkelola](keep-image-updated-managed-image-updates.md).
# Impor Gambar
Anda dapat membuat gambar WorkSpaces Aplikasi dengan mengimpor kustomisasi EC2 AMIs Anda. Begini cara kerjanya:
1. Sesuaikan EC2 AMI Anda menggunakan metode apa pun yang disukai termasuk [EC2 Image Builder](https://docs.aws.amazon.com/imagebuilder/).
1. Impor AMI Anda yang disesuaikan ke WorkSpaces Aplikasi untuk membuat gambar WorkSpaces Aplikasi
1. Secara opsional, gunakan Image Builder untuk kustomisasi gambar tambahan
Gambar yang dibuat melalui impor AMI adalah dari`type = "custom"`, sedangkan gambar yang disediakan WorkSpaces Aplikasi adalah dari`type = "native"`.
Anda dapat menggunakan jenis instans stream.\$1 untuk gambar dengan. `type = "native"` Untuk menggunakan salah satu jenis instance berikut, Anda harus mengimpor AMI Anda dan membuat gambar dengan`type = "custom"`.
+ GeneralPurpose.\$1
+ MemoryOptimized.\$1
+ ComputeOptimized.\$1
+ Dipercepat. \$1
## Prasyarat untuk impor gambar
Semua prasyarat ini penting untuk eksekusi alur kerja yang sukses. Konfigurasi AMI yang didukung dan persyaratan wajib lainnya tercantum di bawah ini.
### Properti AMI yang Diperlukan
EBS
+ Kurang atau sama dengan ukuran 500GB
+ Anda dapat mengimpor AMI dengan < 200 GB, namun, gambar yang diimpor akan menggunakan minimum 200GB.
+ GP2
+ Anda dapat mengimpor AMI dengan tipe volume EBS gp2 atau gp3, namun gambar yang diimpor akan menggunakan gp2.
+ Satu volume per gambar
+ `/dev/sda1`Nama Perangkat Root
+ Tipe Gambar: Mesin
+ Arsitektur: x86\$164
+ Jenis Virtualisasi: HVM
+ Mode Boot: UEFI
+ Dukungan TPM: v2.0. Ini diperlukan, Lihat [https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/ami-windows-tpm.html\$1 untuk menemukan AMI yang diaktifkan ami-windows-tpm-find TPM](https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/ami-windows-tpm.html#ami-windows-tpm-find).
+ Dukungan ENA: benar
+ Platform: Windows
+ Detail Platform: Windows
### Properti Sistem Operasi
**Windows Server 2022/2025 Basis Penuh**
+ Windows Server **Core** tidak didukung
+ Windows dengan SQL Server tidak didukung
Agen
+ EC2 Luncurkan Versi V2 >= 2.1.1
+ Agen SSM diperlukan
Pengemudi
+ EC2 Versi Driver ENa>= 2.9.0
+ EC2 NVMe Versi Driver >= 1.6.0
Dukungan Perpustakaan
+ .NET Framework 4.8 atau lebih
+ Diinstal secara default di Windows Server 2022/2025
+ PowerShell 5.1 atau lebih
+ Diinstal secara default di Windows Server 2022/2025
+ Fitur Windows: Lisensi Layanan Desktop Jarak Jauh dan Host Sesi Layanan Desktop Jarak Jauh tidak boleh diinstal
+ Port: Port 8000, 8300, dan 8443 harus diblokir dan tidak dihuni
+ Mode Boot: UEFI
Jika Anda ingin menggunakan gambar dengan instance grafis seperti Accelerated.G4DN, Accelerated.G5, Accelerated.G6, atau Accelerated.G6E Anda banyak menginstal driver GRID yang tepat pada AMI Anda. Untuk lebih jelasnya, silakan merujuk ke [https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/nvidia-GRID-driver.html](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/nvidia-GRID-driver.html). Namun, jika driver tidak diatur dengan benar, streaming akan berfungsi, kartu grafis mungkin tidak tersedia.
**penting**
“Id Akun Pemilik” AMI harus berupa id AWS akun Anda. Anda tidak dapat mengimpor EC2 AMI publik.
Lakukan pembaruan Windows apa pun dan nonaktifkan pembaruan Windows otomatis sebelum mengimpor gambar.
Impor terenkripsi saat EC2 AMIs ini tidak didukung
### Persyaratan Peran IAM
**penting**
“Buat peran IAM dengan izin berikut untuk digunakan untuk impor gambar:
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "AllowModifyImageAttributeWithTagCondition",
"Effect": "Allow",
"Action": "ec2:ModifyImageAttribute",
"Resource": "*"
},
{
"Sid": "AllowDescribeImages",
"Effect": "Allow",
"Action": "ec2:DescribeImages",
"Resource": "*"
}
]
}
```
Tambahkan hubungan kepercayaan berikut untuk peran IAM ini
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "appstream.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
## Untuk mengimpor gambar
1. Buka konsol WorkSpaces Aplikasi di [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).
1. Di panel navigasi kiri, pilih **Gambar** dan kemudian pilih **Registri gambar**.
1. Pilih **Impor Gambar**.
1. **ID AMI** - Masukkan ID AMI untuk AMI yang ingin Anda impor ke WorkSpaces Aplikasi. Anda juga dapat mencari AMI Anda menggunakan bidang ini.
1. **Nama gambar** - Masukkan nama unik untuk gambar yang akan dibuat karena operasi impor.
1. **Nama tampilan** *(Opsional)* - Masukkan ke tampilan untuk gambar.
1. **Deskripsi** *(Opsional)* — Masukkan deskripsi untuk gambar.
1. **Peran IAM** - Pilih peran IAM yang telah Anda buat untuk impor gambar. Untuk lebih jelasnya lihat[Persyaratan Peran IAM](#iam-role-requirements).
1. **Agen Kelola WorkSpaces Aplikasi** — Pilih opsi ini jika Anda ingin selalu menggunakan versi agen WorkSpaces Aplikasi terbaru, instans streaming Anda diperbarui secara otomatis dengan fitur terbaru, peningkatan kinerja, dan pembaruan keamanan yang tersedia AWS sejak versi agen baru dirilis.
1. **Validasi runtime** *(Opsional)*: Pilih opsi ini dan layanan akan menyediakan instance dengan gambar yang diimpor dan menjalankan pengujian streaming.
+
**catatan**
Tes streaming ini akan dijalankan di latar belakang, Anda tidak dapat terhubung ke instance ini melalui klien WorkSpaces Aplikasi.
+ Sebaiknya gunakan opsi ini untuk mendapatkan kepercayaan diri yang lebih tinggi bahwa gambar Anda cocok untuk WorkSpaces Aplikasi.
+ Anda akan ditagih untuk harga per jam dari contoh itu.
+ Anda dapat menghindari menjalankan validasi runtime jika Anda mengimpor ulang AMI Anda setelah membuat perubahan kecil yang mungkin tidak memengaruhi pengujian streaming, dan jika validasi runtime berlalu terakhir kali, Anda mengimpor AMI ini.
+ **Pilih jenis instans** *(Opsional)*: Pilih keluarga instans, jenis, dan ukuran yang tepat untuk menjalankan pengujian streaming. Disarankan agar Anda menggunakan contoh yang sama yang Anda rencanakan untuk digunakan untuk pembuatan armada.
1. **Katalog aplikasi dan manifes kinerja peluncuran** *(Opsional)*: Berikan detail untuk membuat katalog aplikasi untuk pengguna akhir Anda dan meningkatkan kinerja peluncuran aplikasi Anda.
+ **Katalog aplikasi**: Untuk membuat katalog aplikasi, tentukan detail tentang aplikasi yang diinstal gambar Anda. Untuk setiap aplikasi yang Anda rencanakan untuk streaming, Anda dapat menentukan nama, nama tampilan, file yang dapat dieksekusi untuk diluncurkan, dan ikon yang akan ditampilkan.
+ **Kinerja peluncuran**: Menambahkan file ke manifes pengoptimalan aplikasi mengurangi waktu yang diperlukan aplikasi untuk diluncurkan untuk pertama kalinya pada instance armada baru. Manifes pengoptimalan adalah file teks yang dibatasi baris per aplikasi.
Untuk mempelajari lebih lanjut, lihat[Rincian Aplikasi](applications-details.md).
1. **Tag** *(Opsional)* - Pilih **Tambah Tag** dan ketik kunci dan nilai untuk tag. Untuk menambahkan lebih banyak tag, ulangi langkah ini. Untuk informasi selengkapnya, lihat [Menandai Sumber Daya WorkSpaces Aplikasi Amazon Anda](tagging-basic.md).
1. **Impor Gambar** - Tinjau semua informasi yang telah Anda masukkan dan pilih **Impor Gambar**. Layanan akan menjalankan pemeriksaan kompatibilitas untuk memastikan AMI kompatibel dengan WorkSpaces Aplikasi.
+ Jika pemeriksaan statis gagal, Anda akan langsung menerima kesalahan.
+ Jika pemeriksaan statis lulus, permintaan impor Anda akan dikirimkan dan tergantung pada opsi yang telah Anda pilih, dibutuhkan waktu 30-60 menit untuk membuat gambar WorkSpaces Aplikasi baru dengan `type = "custom"`
# Rincian Aplikasi
Detail aplikasi berisi informasi tentang manifes pra-hangat dan konfigurasi katalog aplikasi.
## PreWarm Manifestasi Aplikasi
Saat membuat gambar WorkSpaces Aplikasi, Anda dapat menentukan aplikasi yang akan tersedia bagi pengguna Anda. Untuk mempercepat waktu peluncuran aplikasi, Anda dapat menyiapkan PreWarm manifes. Ini pada dasarnya adalah katalog file yang perlu diluncurkan aplikasi Anda saat pengguna meluncurkan aplikasi Anda. Selama penyediaan instance, file-file ini akan disiapkan sebelum koneksi sesi untuk mempercepat waktu peluncuran aplikasi di sesi pengguna.
Manifes prewarm harus dibuat sebelumnya di AMI Anda sebelum diimpor ke lingkungan WorkSpaces Aplikasi. Anda dapat memilih untuk membuat satu file manifes Prewarm umum atau satu per setiap aplikasi. Ini mengubah cara Anda akan mengimpor AMI Anda nanti.
### Manifes Prewarm Umum
Untuk setiap aplikasi yang ingin Anda prewarm, luncurkan aplikasi dan lakukan interaksi awal apa pun yang mungkin dilakukan pengguna Anda. Kemudian, gunakan perintah berikut yang menargetkan direktori tempat data aplikasi Anda disimpan.
```
dir -path "C:\Path\To\Folder\To\Optimize" -Recurse -ErrorAction SilentlyContinue | %{$_.FullName} | Out-File "C:\ProgramData\Amazon\Photon\Prewarm\PrewarmManifest.txt" -encoding UTF8 -append
```
Ini akan menambahkan file untuk mengoptimalkan setiap aplikasi ke dalam `C:\\ProgramData\\Amazon\\Photon\\Prewarm\\PrewarmManifest.txt` file umum. Tidak ada tindakan tambahan yang diperlukan untuk melakukan pemanasan awal aplikasi. WorkSpaces Aplikasi akan mencari file prewarm di lokasi di atas dan menggunakannya jika ada.
Proses ini bersifat opsional dan seiring bertambahnya ukuran manifes prewarm, waktu penyediaan armada juga akan meningkat. Jadi berhati-hatilah untuk menyeimbangkan optimasi dengan penyediaan armada.
### Manifestasi Khusus Aplikasi
Selama impor gambar, Anda mungkin ingin menentukan file manifes aplikasi terpisah per aplikasi untuk memudahkan pelacakan aset prewarm per aplikasi. Untuk melakukan ini, lakukan langkah yang sama seperti di atas, tetapi alih-alih membuat `C:\\ProgramData\\Amazon\\Photon\\Prewarm\\PrewarmManifest.txt` file umum, buat file per aplikasi di AMI Anda.
Untuk setiap aplikasi yang ingin Anda prewarm, luncurkan aplikasi dan lakukan interaksi awal apa pun yang mungkin dilakukan pengguna Anda. Kemudian, gunakan perintah berikut yang menargetkan direktori tempat data aplikasi Anda disimpan.
```
dir -path "C:\Path\To\Folder\To\Optimize" -Recurse -ErrorAction SilentlyContinue | %{$_.FullName} | Out-File "C:\Path\To\My\PreWarm.txt" -encoding UTF8 -append
```
Kami akan menggunakan file prewarm aplikasi ini selama proses impor gambar. Sekali lagi ini sepenuhnya opsional. Anda dapat memilih untuk menggunakan metode ini, metode Common Prewarm Manifest, atau tidak ada manifes Prewarm sama sekali.
## Konfigurasi Katalog Aplikasi
`AppCatalogConfig`yang memungkinkan Anda menentukan aplikasi yang ingin Anda daftarkan ke gambar WorkSpaces Aplikasi Anda selama impor AMI. `AppCatalogConfig`Ini adalah daftar JSON objek konfigurasi Aplikasi dari struktur berikut.
```
[
{
"Name": "Rufus", //Required and must be unique among the list of applications
"DisplayName": "Rufus",
"AbsoluteAppPath": "Rufus", //Required
"AbsoluteIconPath": "Rufus",
"AbsoluteManifestPath": "Rufus",
"WorkingDirectory": "Rufus",
"LaunchParameters": "Rufus"
}
...
// Up to 50 applications total
]
```
Satu-satunya bidang yang diperlukan per aplikasi adalah `Name` dan`AbsoluteAppPath`. Rincian masing-masing bidang sebagai berikut:
Nama [**Diperlukan**]
+ Nama yang diberikan untuk aplikasi Anda untuk mengidentifikasinya
+ Antara 1 dan 100 karakter
+ Karakter yang diizinkan regex `^[a-zA-Z0-9][a-zA-Z0-9_.-]{0,99}$`
+ Harus unik dalam suatu AppCatalogConfig
DisplayName
+ Nama tampilan untuk aplikasi tertentu untuk ditampilkan kepada pengguna
+ Antara 0 dan 100 karakter
+ Karakter yang diizinkan regex `^[a-zA-Z0-9][a-zA-Z0-9_. -]{0,99}$`
AbsoluteAppPath [**Diperlukan**]
+ Jalur ke executable untuk meluncurkan aplikasi Anda
+ Ini adalah executable yang akan diluncurkan ketika pengguna memilih aplikasi Anda
+ Antara 1 dan 32767 karakter
+ Batas atas panjang karakter ini adalah untuk mendukung jalur file yang diperluas di Windows. Pastikan AMI dan aplikasi Anda dikonfigurasi dengan benar untuk mendukung jalur file Windows yang diperluas jika menggunakan jalur file yang lebih besar dari 260 karakter.
+ Gunakan string jalur file yang lolos seperti
+ `"C:\\Windows\\System32\\notepad.exe"`
AbsoluteManifestPath
+ Hanya berlaku jika Anda menggunakan [Manifestasi Khusus Aplikasi](#application-specific-manifests)
+ Jalur ke file manifes pemanasan awal untuk aplikasi ini
+ Antara 0 dan 32767 karakter
+ Batas atas panjang karakter ini adalah untuk mendukung jalur file yang diperluas di Windows. Pastikan AMI dan aplikasi Anda dikonfigurasi dengan benar untuk mendukung jalur file Windows yang diperluas jika menggunakan jalur file yang lebih besar dari 260 karakter.
+ Gunakan string jalur file yang lolos seperti
+ `"C:\\Path\\To\\PrewarmManifest.txt"`
AbsoluteIconPath
+ Jalur ke file ikon pada AMI yang akan digunakan untuk aplikasi.
+ Ikon ini akan ditampilkan kepada pengguna saat streaming ke gambar ini.
+ Jika tidak ada yang disediakan, ikon akan diturunkan dari executable itu sendiri.
+ Berhati-hatilah untuk memilih file ikon dengan transparansi latar belakang yang ditangani dengan tepat untuk pengalaman klien yang baik bagi pengguna Anda
+ Gunakan gambar PNG
+ Antara 1 dan 32767 karakter
+ Batas atas panjang karakter ini adalah untuk mendukung jalur file yang diperluas di Windows. Pastikan AMI dan aplikasi Anda dikonfigurasi dengan benar untuk mendukung jalur file Windows yang diperluas jika menggunakan jalur file yang lebih besar dari 260 karakter.
+ Gunakan string jalur file yang lolos seperti
+ `"C:\\Path\\To\\ApplicationIcon.png"`
WorkingDirectory
+ Direktori kerja untuk meluncurkan aplikasi Anda di
+ Antara 0 dan 32767 karakter
+ Batas atas panjang karakter ini adalah untuk mendukung jalur file yang diperluas di Windows. Pastikan AMI dan aplikasi Anda dikonfigurasi dengan benar untuk mendukung jalur file Windows yang diperluas jika menggunakan jalur file yang lebih besar dari 260 karakter.
+ Gunakan string jalur file yang lolos seperti
+ `"C:\\Path\\To\\Working\\Directory"`
LaunchParameters
+ String untuk digunakan sebagai parameter peluncuran untuk executable yang ditentukan dalam `AbsoluteAppPath`
+ Antara 0 dan 1024 karakter
+ Gunakan string yang diloloskan dengan daftar lengkap parameter peluncuran yang diperlukan seperti contoh berikut yang menunjukkan bagaimana Anda dapat menggunakan PowerShell skrip sebagai aplikasi Anda dengan menggunakan PowerShell executable sebagai aplikasi Anda dengan skrip yang disediakan dalam parameter peluncuran
+ AbsoluteAppPath
+ `"C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe"`
+ LaunchParameters
+ `"-File \"C:\\Path\\To\\App\\Script.ps1\""`
### Sampel AppCatalogConfig
Ini adalah contoh telanjang dari Notepad, Google Chrome, dan Mozilla Firefox AppCatalogConfig
```
[
{
"Name": "Notepad",
"DisplayName": "Notepad",
"AbsoluteAppPath": "C:\\Windows\\System32\\notepad.exe"
},
{
"Name": "Chrome",
"DisplayName": "Chrome",
"AbsoluteAppPath": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
"LaunchParameters": "https://www.amazon.com/"
},
{
"Name": "Firefox",
"DisplayName": "Firefox",
"AbsoluteAppPath": "C:\\Program Files\\Mozilla Firefox\\firefox.exe",
"LaunchParameters": "https://aws.amazon.com/"
}
]
```
# Ekspor Gambar
Anda dapat mengekspor gambar Anda untuk membuat EC2 AMIs. Nanti Anda bisa [Impor Gambar](import-image.md) AMIs kembali untuk membuat gambar WorkSpaces Aplikasi. Ini membantu Anda menggunakan alat kustomisasi AMI Anda sendiri untuk menyesuaikan gambar Anda.
**catatan**
Selama ekspor komponen berikut akan dihapus dari gambar Anda
WorkSpaces Agen aplikasi
Lisensi Microsoft termasuk aplikasi, yang ditambahkan menggunakan Image Builder
Hanya gambar Microsoft Windows Server 2022 dan 2025 yang dapat diekspor.
## Persyaratan Peran IAM
**penting**
Buat peran IAM dengan izin berikut untuk digunakan untuk impor ekspor:
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "AllowCopyImage",
"Effect": "Allow",
"Action": "ec2:CopyImage",
"Resource": "*"
},
{
"Sid": "AllowDescribeImages",
"Effect": "Allow",
"Action": "ec2:DescribeImages",
"Resource": "*"
},
{
"Sid": "AllowCreateTags",
"Effect": "Allow",
"Action": "ec2:CreateTags",
"Resource": "*"
}
]
}
```
Tambahkan hubungan kepercayaan berikut untuk peran IAM ini
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "appstream.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
## Untuk mengekspor gambar
1. Buka konsol WorkSpaces Applications di [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).
1. Di panel navigasi, pilih **Gambar**, **Registri Gambar**.
1. Dalam daftar gambar, pilih gambar pribadi yang ingin Anda ekspor.
1. Pilih **Tindakan**, **Ekspor**.
1. Di kotak dialog **Ekspor gambar**, ketikkan **nama AMI** yang unik dan opsional **Deskripsi AMI** untuk AMI.
1. **Peran IAM** - Pilih peran IAM yang telah Anda buat untuk ekspor gambar.
1. Anda secara opsional menyalin tag dari Gambar Anda ke AMI dengan mencentang kotak centang **Salin tag di ekspor**.
1. Pilih **Ekspor Gambar**.
# Buat Gambar WorkSpaces Aplikasi Amazon Anda Secara Terprogram dengan Menggunakan Operasi CLI Asisten Gambar
Anda dapat membuat gambar WorkSpaces Aplikasi Amazon dengan menghubungkan ke pembuat gambar dan menggunakan operasi antarmuka pengguna grafis Asisten Gambar (GUI) atau antarmuka baris perintah (CLI). Operasi CLI Asisten Gambar menyediakan fungsionalitas yang mirip dengan GUI Asisten Gambar. Dengan operasi ini, Anda dapat melakukan hal berikut secara terprogram:
+ Kelola aplikasi yang disertakan dalam gambar.
+ Simpan, perbarui, dan setel ulang pengaturan aplikasi default.
+ Aktifkan atau nonaktifkan kerangka WorkSpaces aplikasi dinamis Aplikasi.
+ Tentukan tag.
+ Buat gambar.
Anda dapat menggunakan operasi ini untuk mengintegrasikan pembuatan gambar WorkSpaces Aplikasi dengan integrasi berkelanjutan atau proses pengembangan perangkat lunak penyebaran Anda.
Untuk bekerja dengan operasi CLI Asisten Gambar, gunakan shell baris perintah pilihan Anda pada pembuat gambar. Misalnya, Anda dapat menggunakan prompt perintah Windows atau PowerShell.
**catatan**
Pembuat gambar harus menggunakan versi agen WorkSpaces Aplikasi yang dirilis pada atau setelah 26 Juli 2019. Jika Anda tidak memiliki pembuat gambar, Anda harus membuatnya. Untuk informasi selengkapnya, lihat [Luncurkan Image Builder untuk Menginstal dan Mengkonfigurasi Aplikasi Streaming](tutorial-image-builder-create.md).
**Topics**
+ [Membuat Aplikasi Default dan Pengaturan Windows dengan operasi CLI Asisten Gambar](create-default-app-windows-settings-image-assistant.md)
+ [Mengoptimalkan Kinerja Peluncuran Aplikasi Anda dengan Operasi CLI Asisten Gambar](optimize-app-launch-performance-image-assistant-cli.md)
+ [Ikhtisar Proses untuk Membuat Gambar Aplikasi Amazon WorkSpaces secara Terprogram](process-overview-creating-image-programmatically-image-assistant-cli.md)
+ [Operasi CLI Asisten Gambar untuk Membuat dan Mengelola Gambar Aplikasi Amazon WorkSpaces Anda](cli-operations-managing-creating-image-image-assistant.md)
# Membuat Aplikasi Default dan Pengaturan Windows dengan operasi CLI Asisten Gambar
Anda dapat membuat aplikasi default dan pengaturan Windows sehingga pengguna Anda dapat memulai dengan aplikasi mereka dengan cepat. Saat Anda membuat pengaturan ini, WorkSpaces Aplikasi menggantikan profil pengguna default Windows dengan profil yang Anda konfigurasikan. Profil pengguna default Windows kemudian digunakan untuk membuat pengaturan awal untuk pengguna dalam instance armada. Jika Anda membuat pengaturan ini dengan menggunakan operasi CLI Asisten Gambar, penginstal aplikasi Anda, atau otomatisasi, harus memodifikasi profil pengguna default Windows secara langsung.
Untuk menimpa profil pengguna default Windows dengan pengguna Windows lain, Anda juga dapat menggunakan operasi `update-default-profile` CLI Asisten Gambar.
Untuk informasi selengkapnya tentang mengonfigurasi aplikasi default dan pengaturan Windows, lihat *Membuat Aplikasi Default dan Pengaturan Windows untuk Pengguna WorkSpaces Aplikasi Anda* di[Pengaturan Aplikasi dan Windows Default dan Kinerja Peluncuran Aplikasi di WorkSpaces Aplikasi Amazon](customizing-appstream-images.md).
# Mengoptimalkan Kinerja Peluncuran Aplikasi Anda dengan Operasi CLI Asisten Gambar
WorkSpaces Aplikasi memungkinkan Anda mengoptimalkan kinerja peluncuran aplikasi Anda untuk sesi streaming pengguna Anda. Ketika Anda melakukannya dengan menggunakan operasi Image Assistant CLI, Anda dapat menentukan file yang akan dioptimalkan untuk peluncuran aplikasi Anda. Menambahkan file ke manifes pengoptimalan aplikasi mengurangi waktu yang diperlukan aplikasi untuk diluncurkan untuk pertama kalinya pada instance armada baru. Namun, ini juga meningkatkan waktu yang diperlukan agar instance armada tersedia bagi pengguna. Manifes pengoptimalan adalah file teks yang dibatasi baris per aplikasi.
**catatan**
Jika Anda melakukan onboard manifes pengoptimalan aplikasi dengan menggunakan operasi CLI Asisten Gambar dan GUI Asisten Gambar, manifes akan digabungkan.
Berikut ini adalah contoh file manifes pengoptimalan aplikasi:
```
C:\Program Files (x86)\Notepad++\autoCompletion
C:\Program Files (x86)\Notepad++\localization
C:\Program Files (x86)\Notepad++\plugins
C:\Program Files (x86)\Notepad++\themes
C:\Program Files (x86)\Notepad++\updater
C:\Program Files (x86)\Notepad++\userDefineLangs
C:\Program Files (x86)\Notepad++\change.log
C:\Program Files (x86)\Notepad++\config.xml
C:\Program Files (x86)\Notepad++\contextMenu.xml
C:\Program Files (x86)\Notepad++\doLocalConf.xml
C:\Program Files (x86)\Notepad++\functionList.xml
C:\Program Files (x86)\Notepad++\langs.model.xml
C:\Program Files (x86)\Notepad++\license.txt
C:\Program Files (x86)\Notepad++\notepad++.exe
C:\Program Files (x86)\Notepad++\readme.txt
C:\Program Files (x86)\Notepad++\SciLexer.dll
C:\Program Files (x86)\Notepad++\shortcuts.xml
C:\Program Files (x86)\Notepad++\stylers.model.xml
```
Untuk informasi selengkapnya tentang mengoptimalkan kinerja peluncuran aplikasi Anda, lihat *Mengoptimalkan Kinerja Peluncuran Aplikasi Anda* di. [Pengaturan Aplikasi dan Windows Default dan Kinerja Peluncuran Aplikasi di WorkSpaces Aplikasi Amazon](customizing-appstream-images.md)
# Ikhtisar Proses untuk Membuat Gambar Aplikasi Amazon WorkSpaces secara Terprogram
Anda dapat menggunakan operasi CLI Asisten Gambar dengan otomatisasi instalasi aplikasi Anda untuk membuat alur kerja pembuatan gambar WorkSpaces Aplikasi yang sepenuhnya terprogram. Setelah otomatisasi instalasi aplikasi Anda selesai, tetapi sebelum gambar dibuat, gunakan operasi CLI Asisten Gambar untuk menentukan hal berikut:
+ File yang dapat dieksekusi yang dapat diluncurkan pengguna Anda
+ Manifestasi pengoptimalan untuk aplikasi Anda
+ WorkSpaces Aplikasi lainnya metadata gambar
Ikhtisar tingkat tinggi berikut menjelaskan proses pembuatan gambar Aplikasi secara terprogram. WorkSpaces
1. Gunakan otomatisasi instalasi aplikasi Anda untuk menginstal aplikasi yang diperlukan pada pembuat gambar Anda. Instalasi ini dapat mencakup aplikasi yang akan diluncurkan pengguna Anda, dependensi apa pun, dan aplikasi latar belakang.
1. Tentukan file dan folder untuk dioptimalkan.
1. Jika berlaku, gunakan operasi `add-application` CLI Asisten Gambar untuk menentukan metadata aplikasi dan manifes pengoptimalan untuk gambar Aplikasi. WorkSpaces
1. Untuk menentukan aplikasi tambahan untuk gambar WorkSpaces Aplikasi, ulangi langkah 1 hingga 3 untuk setiap aplikasi sesuai kebutuhan.
1. Jika berlaku, gunakan operasi `update-default-profile` CLI Asisten Gambar untuk menimpa profil Windows default dan membuat aplikasi default dan pengaturan Windows untuk pengguna Anda.
1. Gunakan operasi Image Assistant `create-image` CLI untuk membuat gambar.
# Operasi CLI Asisten Gambar untuk Membuat dan Mengelola Gambar Aplikasi Amazon WorkSpaces Anda
Bagian ini menjelaskan operasi CLI Asisten Gambar yang dapat Anda gunakan untuk membuat dan mengelola gambar WorkSpaces Aplikasi Anda.
Pada pembuat gambar Windows, file yang dapat dieksekusi yang menyertakan antarmuka baris perintah terletak di: C:\$1Program Files\$1 Amazon\$1 Photon\$1\$1 Image-Assistant.exe. ConsoleImageBuilder Untuk kenyamanan Anda, file yang dapat dieksekusi ini disertakan dalam variabel Windows PATH. Ini memungkinkan Anda memanggil operasi CLI Asisten Gambar tanpa menentukan jalur absolut ke file yang dapat dieksekusi. Untuk memanggil operasi ini, ketik **image-assistant.exe** perintah.
Pada pembuat gambar Linux, alat asisten gambar terletak di/usr/local/appstream/image-assistant/AppStreamImageAssistant, with a symbolic link at /bin/AppStreamImageAssistant.
## Operasi `help`
Mengambil daftar semua operasi CLI Asisten Gambar. Untuk setiap operasi dalam daftar, deskripsi dan sintaks penggunaan disediakan. Untuk menampilkan bantuan untuk operasi tertentu, ketikkan nama operasi dan tentukan parameter **--help**. Contoh:
```
add-application --help
```
**Sinopsis**
```
help
```
**Keluaran**
Mencetak untuk standar daftar operasi yang tersedia dengan deskripsi fungsinya.
## Operasi `add-application`
Menambahkan aplikasi ke daftar aplikasi untuk pengguna WorkSpaces Aplikasi. Aplikasi dalam daftar ini termasuk dalam katalog aplikasi. Katalog aplikasi ditampilkan kepada pengguna saat mereka masuk ke sesi streaming WorkSpaces Aplikasi.
**catatan**
Jika Anda perlu membuat perubahan pada konfigurasi aplikasi, hapus aplikasi dan tambahkan aplikasi dengan pengaturan yang diperbarui.
**Sinopsis**
```
add-application
--name
--absolute-app-path
[--display-name ]
[--absolute-icon-path ]
[--working-directory ]
[--launch-parameters <""-escaped value>]
[--absolute-manifest-path ]
```
**Pilihan**
**`--name`(tali)**
Nama unik untuk aplikasi. Panjang maksimum adalah 256 karakter. Anda dapat menambahkan hingga 50 aplikasi. Anda tidak dapat menggunakan karakter spasi putih.
**`--absolute-app-path`(tali)**
Jalur absolut ke file yang dapat dieksekusi, file batch, atau skrip untuk aplikasi. Jalur harus menunjuk ke file yang valid.
**`--display-name`(tali)**
Nama yang akan ditampilkan untuk aplikasi dalam katalog aplikasi. Jika Anda tidak menentukan nama tampilan, WorkSpaces Aplikasi akan membuat nama yang berasal dari nama file yang dapat dieksekusi. Nama dibuat tanpa ekstensi file dan dengan garis bawah di tempat spasi. Panjang maksimum adalah 256 karakter.
**`--absolute-icon-path`(tali)**
Jalur absolut ke ikon untuk aplikasi. Jalur harus menunjuk ke file ikon yang valid yang merupakan salah satu dari jenis berikut: .jpg, .png, atau.bmp. Dimensi maksimumnya adalah: 256 px x 256 px. Jika Anda tidak menentukan jalur, ikon default untuk file yang dapat dieksekusi akan digunakan, jika tersedia. Jika ikon default tidak tersedia untuk file yang dapat dieksekusi, ikon WorkSpaces aplikasi Aplikasi default digunakan.
**`--working-directory`(tali)**
Direktori kerja awal untuk aplikasi saat aplikasi diluncurkan.
**`--absolute-manifest-path`(tali)**
Jalur ke file teks baru yang dibatasi baris. File menentukan jalur absolut file untuk dioptimalkan sebelum instance armada tersedia bagi pengguna untuk streaming. Jalur harus menunjuk ke file teks yang valid.
**Keluaran pesan**
| Kode keluar | Pesan dicetak ke standar | Deskripsi |
| --- | --- | --- |
| 0 | \$1"status”: 0, “message”: “Sukses"\$1 | Aplikasi berhasil ditambahkan. |
| 1 | \$1"status”: 1, “message”: “Hak istimewa administrator diperlukan untuk melakukan operasi ini"\$1 | Hak istimewa administrator diperlukan untuk menyelesaikan operasi. |
| 1 | \$1"status”: 1, “message”: “Tidak dapat menambahkan lebih dari 50 aplikasi ke katalog."\$1 | Aplikasi tidak dapat ditambahkan karena jumlah maksimum aplikasi yang dapat ditambahkan ke katalog WorkSpaces aplikasi Aplikasi adalah 50. |
| 1 | \$1"status”: 1, “message”: “Nama tidak unik"\$1 | Aplikasi dengan nama itu sudah ada di katalog WorkSpaces aplikasi Aplikasi. |
| 1 | \$1"status”: 1, “message”: “File tidak ditemukan (absolute-app-path)"\$1 | File yang ditentukan untuk tidak absolute-app-path dapat ditemukan. |
| 1 | \$1"status”: 1, “message”: “Ekstensi file yang tidak didukung"\$1 | Absolute-app-pathParameter hanya mendukung jenis file berikut: .exe dan .bat. |
| 1 | \$1"status”: 1, “message”: “Direktori tidak ditemukan (direktori kerja)” | Direktori yang ditentukan untuk tidak working-directory dapat ditemukan. |
| 1 | \$1"status”: 1, “message”: “Pengoptimalan-manifes tidak ditemukan: “\$1 | File yang ditentukan untuk tidak optimization-manifest dapat ditemukan. |
| 1 | \$1"status”: 1, “message”: “File tidak ditemukan: “\$1 | File yang ditentukan dalam manifes pengoptimalan tidak dapat ditemukan. |
| 255 | \$1"status”: 255, “pesan”:\$1 | Terjadi kesalahan tak terduga. Coba permintaannya lagi. Jika kesalahan berlanjut, hubungi AWS Dukungan untuk bantuan. Untuk informasi lebih lanjut, lihat [AWS Dukungan Pusat](https://console.aws.amazon.com/support/home#/). |
## Operasi `remove-application`
Menghapus aplikasi dari daftar aplikasi untuk gambar WorkSpaces Aplikasi. Aplikasi tidak dihapus atau dimodifikasi, tetapi pengguna tidak akan dapat meluncurkannya dari katalog WorkSpaces aplikasi Aplikasi.
**Sinopsis**
```
remove-application
--name
```
**Pilihan**
**`--name`(tali)**
Pengidentifikasi unik aplikasi yang akan dihapus.
**Keluaran pesan**
| Kode keluar | Pesan dicetak ke standar | Deskripsi |
| --- | --- | --- |
| 0 | \$1"status”: 0, “message”: “Sukses"\$1 | Aplikasi berhasil dihapus. |
| 1 | \$1"status”: 1, “message”: “Hak istimewa administrator diperlukan untuk melakukan operasi ini"\$1 | Hak istimewa administrator diperlukan untuk menyelesaikan operasi. |
| 1 | \$1"status”: 1, “message”: “Aplikasi tidak ditemukan"\$1 | Aplikasi yang ditentukan tidak dapat ditemukan di katalog WorkSpaces aplikasi Aplikasi. |
| 255 | \$1"status”: 255, “pesan”:\$1 | Terjadi kesalahan tak terduga. Coba permintaannya lagi. Jika kesalahan berlanjut, hubungi AWS Dukungan untuk bantuan. Untuk informasi lebih lanjut, lihat [AWS Dukungan Pusat](https://console.aws.amazon.com/support/home#/). |
## Operasi `list-applications`
Daftar semua aplikasi yang ditentukan dalam katalog aplikasi.
**Sinopsis**
```
list-applications
```
**Keluaran pesan**
| Kode keluar | Pesan dicetak ke standar | Deskripsi |
| --- | --- | --- |
| 0 | \$1"status”: 0, “message”: “Sukses”, “aplikasi”: [\$1.. app1..\$1, \$1.. app2..\$1]\$1 | Daftar aplikasi dalam katalog WorkSpaces aplikasi Aplikasi. |
| 255 | \$1"status”: 255, “pesan”:\$1 | Terjadi kesalahan tak terduga. Coba permintaannya lagi. Jika kesalahan berlanjut, hubungi AWS Dukungan untuk bantuan. Untuk informasi lebih lanjut, lihat [AWS Dukungan Pusat](https://console.aws.amazon.com/support/home#/). |
## Operasi `update-default-profile`
Menyalin profil pengguna Windows yang ditentukan ke profil pengguna default Windows. Pengguna baru yang melakukan streaming mewarisi pengaturan yang disimpan di profil yang ditentukan.
**catatan**
Operasi ini tidak didukung oleh alat CLI asisten gambar Linux.
**Sinopsis**
```
update-default-profile
[--profile ]
```
**Pilihan**
**`--profile`(tali)**
Nama pengguna yang profil Windowsnya akan disalin ke profil pengguna default Windows. Gunakan format berikut untuk nama:
“\$1”
Jika pembuat gambar Anda tidak bergabung dengan domain Microsoft Active Directory, masukkan titik “.” untuk domain tersebut. Jika Anda tidak menentukan pengguna, akun Pengguna Template WorkSpaces Aplikasi akan digunakan.
**Keluaran pesan**
| Kode keluar | Pesan dicetak ke standar | Deskripsi |
| --- | --- | --- |
| 0 | \$1"status”: 0, “message”: “Sukses"\$1 | Pengaturan pengguna berhasil disalin ke profil Windows default. |
| 1 | \$1"status”: 1, “message”: “Hak istimewa administrator diperlukan untuk melakukan operasi ini"\$1 | Hak istimewa administrator diperlukan untuk menyelesaikan operasi. |
| 1 | \$1"status”: 1, “message”: “Tidak dapat menyalin berkas atau folder:. “\$1 | Pengaturan pengguna tidak dapat disalin karena file atau folder tidak tersedia. |
| 1 | \$1"status”: 1, “message”: “Tidak dapat menyalin pengguna domain saat tidak bergabung ke domain""\$1 | Pengguna domain Microsoft Active Directory ditentukan, tetapi pembuat gambar tidak bergabung ke domain Active Directory. |
| 255 | \$1"status”: 255, “pesan”:\$1 | Terjadi kesalahan tak terduga. Coba permintaannya lagi. Jika kesalahan berlanjut, hubungi AWS Dukungan untuk bantuan. Untuk informasi lebih lanjut, lihat [AWS Dukungan Pusat](https://console.aws.amazon.com/support/home#/). |
## Operasi `reset-user-profile`
Menghapus profil pengguna Windows untuk pengguna yang ditentukan.
**catatan**
Operasi ini tidak didukung oleh alat CLI asisten gambar Linux.
**Sinopsis**
```
reset-user-profile
[--profile ]
```
**Pilihan**
**`--profile`(tali)**
Nama pengguna Windows yang profil Windowsnya akan dihapus. Gunakan format berikut untuk nama:
“\$1”
Jika pembuat gambar Anda tidak bergabung dengan domain Microsoft Active Directory, masukkan titik “.” untuk domain tersebut.
**Keluaran pesan**
| Kode keluar | Pesan dicetak ke standar | Deskripsi |
| --- | --- | --- |
| 0 | \$1"status”: 0, “message”: “Sukses"\$1 | Pengaturan pengguna yang ditentukan berhasil dihapus. |
| 1 | \$1"status”: 1, “message”: “Hak istimewa administrator diperlukan untuk melakukan operasi ini"\$1 | Hak istimewa administrator diperlukan untuk menyelesaikan operasi. |
| 1 | \$1"status”: 1, “message”: “Tidak dapat menyalin berkas atau folder:. “\$1 | Pengaturan pengguna tidak dapat diatur ulang karena file atau folder tidak tersedia. |
| 1 | \$1"status”: 1, “message”: “Tidak dapat menyalin pengguna domain saat tidak bergabung ke domain""\$1 | Pengguna domain Microsoft Active Directory ditentukan, tetapi pembuat gambar tidak bergabung ke domain Active Directory. |
| 255 | \$1"status”: 255, “pesan”:\$1 | Terjadi kesalahan tak terduga. Coba permintaannya lagi. Jika kesalahan berlanjut, hubungi AWS Dukungan untuk bantuan. Untuk informasi lebih lanjut, lihat [AWS Dukungan Pusat](https://console.aws.amazon.com/support/home#/). |
## Operasi `create-image`
Memulai alur kerja pembuatan gambar, menghasilkan gambar WorkSpaces Aplikasi yang dapat digunakan untuk armada WorkSpaces Aplikasi.
**Sinopsis**
```
create-image
--name
[--description ]
[--display-name ]
[--enable-dynamic-app-catalog] | [--no-enable-dynamic-app-catalog]
[--use-latest-agent-version] | [--no-use-latest-agent-version]
[--tags ]
[--dry-run]
```
**Pilihan**
**`--name`(tali)**
Nama untuk gambar WorkSpaces Aplikasi. Nama harus unik dalam akun Amazon Web Services dan AWS Wilayah. Panjang maksimum adalah 100 karakter. Karakter yang diizinkan adalah:
a-z, A-Z, 0-9, garis bawah (\$1), tanda hubung (-), dan periode (.)
Nama gambar tidak dapat dimulai dengan awalan berikut: 'aws', 'appstream', dan 'amazon'. Awalan ini dicadangkan untuk AWS digunakan.
**`--description`(tali)**
Deskripsi untuk ditampilkan untuk gambar. Panjang maksimum adalah 256 karakter.
**`--display-name`(tali)**
Nama yang akan ditampilkan untuk gambar. Panjang maksimum adalah 256 karakter.
**`--enable-dynamic-app-catalog` \$1 `--no-enable-dynamic-app-catalog`**
Mengaktifkan atau menonaktifkan dukungan untuk kerangka WorkSpaces aplikasi dinamis Aplikasi. Jika Anda tidak menentukan salah satu parameter, dukungan untuk kerangka kerja aplikasi dinamis tidak diaktifkan.
Kerangka kerja aplikasi dinamis menyediakan operasi dalam instance streaming WorkSpaces Aplikasi yang dapat Anda gunakan untuk membangun penyedia aplikasi dinamis. Penyedia aplikasi dinamis dapat menggunakan operasi ini untuk memodifikasi katalog aplikasi yang dapat diakses pengguna Anda secara real time. Untuk informasi selengkapnya, lihat [Menggunakan WorkSpaces Applications Dynamic Application Framework untuk Membangun Penyedia Aplikasi Dinamis](build-dynamic-app-provider.md).
**`--use-latest-agent-version` \$1 `--no-use-latest-agent-version`**
Menentukan apakah akan menyematkan gambar ke versi agen WorkSpaces Aplikasi yang saat ini diinstal, atau untuk selalu menggunakan versi agen terbaru. Jika Anda tidak menentukan salah satu parameter, gambar disematkan ke versi agen WorkSpaces Aplikasi yang saat ini diinstal. Untuk informasi selengkapnya, lihat [Kelola Versi Agen WorkSpaces Aplikasi](base-images-agent.md).
**`--tags`(tali)**
Tag untuk mengasosiasikan dengan gambar. Tanda merupakan pasangan nilai kunci. Gunakan format berikut:
--tags “mykey” “myval” “mykey2" “myval2"
Untuk informasi selengkapnya tentang tag, lihat [Menandai Sumber Daya WorkSpaces Aplikasi Amazon Anda](tagging-basic.md).
**`--dry-run`(tali)**
Melakukan validasi tanpa membuat gambar. Gunakan perintah ini untuk mengidentifikasi apakah gambar Anda memiliki masalah sebelum Anda membuatnya.
**Keluaran pesan**
| Kode keluar | Pesan dicetak ke standar | Deskripsi |
| --- | --- | --- |
| 0 | \$1"status”: 0, “message”: “Sukses"\$1 | Alur kerja untuk membuat gambar berhasil dimulai. |
| 1 | \$1"status”: 1, “message”: “Hak istimewa administrator diperlukan untuk melakukan operasi ini"\$1 | Hak istimewa administrator diperlukan untuk menyelesaikan operasi. |
| 1 | \$1"status”: 1, “message”: “Sebuah gambar dengan nama yang diberikan sudah ada"\$1 | Gambar dengan nama yang ditentukan sudah ada di akun Amazon Web Services. |
| 1 | \$1"status”: 1, “message”: “Nilai (tag) tidak valid"\$1 | Tag yang ditentukan tidak valid. |
| 255 | \$1"status”: 255, “pesan”:\$1 | Terjadi kesalahan tak terduga. Coba permintaannya lagi. Jika kesalahan berlanjut, hubungi AWS Dukungan untuk bantuan. Untuk informasi lebih lanjut, lihat [AWS Dukungan Pusat](https://console.aws.amazon.com/support/home#/). |
# Buat Gambar Berbasis Linux Anda
Anda dapat membuat gambar Aplikasi WorkSpaces Amazon berbasis Linux dengan menghubungkan ke pembuat gambar Linux, menginstal aplikasi yang Anda butuhkan, membuat pengaturan aplikasi default dan variabel lingkungan, dan menggunakan alat antarmuka baris perintah (CLI) atau alat Image Assistant (GUI) untuk menambahkan aplikasi ini ke katalog aplikasi. Untuk membuka alat GUI, cari **Asisten Gambar** dalam daftar aplikasi.
**Topics**
+ [Membuat Pengaturan Aplikasi Default untuk Pengguna Anda](create-default-app-settings.md)
+ [Membuat Variabel Lingkungan Default untuk Pengguna Linux Anda](create-default-variables-linux.md)
+ [Mengoptimalkan Kinerja Peluncuran Aplikasi Linux Anda](optimize-launch-performance.md)
+ [Membuat Skrip Sesi](create-session-scripts.md)
+ [Menggunakan Alat CLI Asisten Gambar untuk Linux](image-assistant-cli.md)
+ [Mengaktifkan dan Menonaktifkan Dukungan Webcam](webcam-support.md)
+ [Mengaktifkan dan Menonaktifkan Mode Sinkronisasi File Berat untuk Folder Rumah](heavy-file-sync.md)
+ [Tutorial: Buat Gambar Aplikasi Berbasis Linux WorkSpaces Kustom](tutorial-create-linux-image.md)
+ [Tutorial: Aktifkan Dukungan Jepang untuk Gambar Linux Anda](enable-japanese-support-linux.md)
# Membuat Pengaturan Aplikasi Default untuk Pengguna Anda
Ikuti langkah-langkah ini untuk membuat pengaturan aplikasi default untuk pengguna Anda.
**Topics**
+ [Langkah 1: Instal Aplikasi Linux pada Image Builder](#app-settings-image-install)
+ [Langkah 2: Buat TemplateUser Akun](#app-settings-template-user)
+ [Langkah 3: Buat Pengaturan Aplikasi Default](#app-settings-image-create-default-app-settings)
+ [Langkah 4: Simpan Pengaturan Aplikasi Default](#app-settings-image-save-default-app-settings)
+ [Langkah 5: Uji Pengaturan Aplikasi Default (opsional)](#app-settings-image-test-applications)
+ [Langkah 6: Bersihkan](#app-settings-image-finish)
## Langkah 1: Instal Aplikasi Linux pada Image Builder
Pada langkah ini, Anda menghubungkan pembuat gambar Linux dan menginstal aplikasi Anda pada pembuat gambar.
**Untuk menginstal aplikasi pada pembuat gambar**
1. Connect ke image builder dengan melakukan salah satu hal berikut:
+ [Gunakan konsol WorkSpaces Aplikasi](managing-image-builders-connect-console.md) (hanya untuk koneksi web)
+ [Buat URL streaming](managing-image-builders-connect-streaming-URL.md) (untuk koneksi klien web atau WorkSpaces Aplikasi)
**catatan**
Anda akan masuk sebagai ImageBuilderAdmin pengguna ke desktop Amazon Linux GNOME dan memiliki hak admin root.
1. Instal aplikasi yang Anda butuhkan. Misalnya, untuk menginstal browser Chromium dari repo yum publik, pertama buka aplikasi Terminal, lalu jalankan perintah berikut:
**[ImageBuilderAdmin]\$1 sudo yum update && sudo yum install chromium.x86\$164**
## Langkah 2: Buat TemplateUser Akun
Pada langkah ini, Anda membuat TemplateUser akun, yang membuat pengaturan aplikasi default untuk pengguna streaming Anda.
**Untuk membuat TemplateUser Akun**
1. Buat TemplateUser akun yang tidak memiliki izin root. Misalnya, di jendela Terminal, jalankan perintah berikut untuk membuat TemplateUser pada pembuat gambar:
**[ImageBuilderAdmin]\$1 sudo useradd -m TemplateUser**
**[ImageBuilderAdmin]\$1 echo -e '<*password*>\$1n<*password*>\$1n' \$1 sudo passwd TemplateUser**
1. Beralih ke TemplateUser akun:
**[ImageBuilderAdmin]\$1 su - TemplateUser**
## Langkah 3: Buat Pengaturan Aplikasi Default
Pada langkah ini, Anda membuat pengaturan aplikasi default untuk pengguna WorkSpaces Aplikasi Anda. Melakukan hal ini memungkinkan pengguna Anda untuk memulai dengan aplikasi dengan cepat selama sesi streaming WorkSpaces Aplikasi mereka, tanpa perlu membuat atau mengonfigurasi pengaturan ini sendiri.
**Untuk membuat pengaturan aplikasi default untuk pengguna Anda**
1. Luncurkan aplikasi yang ingin Anda buat pengaturan default. Misalnya, di jendela Terminal, jalankan perintah berikut untuk meluncurkan browser Chromium:
**[TemplateUser]\$1 chromium-browser**
1. Konfigurasikan pengaturan aplikasi. Misalnya, atur halaman beranda browser Chromium sebagai**https://aws.amazon.com**.
1. Tutup aplikasi.
1. Keluar:
**[TemplateUser]\$1 logout**
## Langkah 4: Simpan Pengaturan Aplikasi Default
Pada langkah ini, Anda menyalin pengaturan aplikasi default yang Anda tambahkan ke direktori **/etc/skel/**, dan membuatnya tersedia untuk pengguna streaming Anda.
**Untuk menyimpan pengaturan aplikasi default**
+ Jalankan perintah berikut di jendela Terminal untuk menyalin pengaturan aplikasi default untuk pengguna streaming Anda:
**[ImageBuilderAdmin]\$1 sudo cp -r -f /home/TemplateUser/. /etc/skel**
## Langkah 5: Uji Pengaturan Aplikasi Default (opsional)
Pada langkah ini, verifikasi bahwa aplikasi yang Anda tambahkan berjalan dengan benar, dan pengaturan aplikasi default berfungsi seperti yang diharapkan.
**Untuk menguji aplikasi dan pengaturan default pada pembuat gambar**
1. Buat pengguna uji yang tidak memiliki izin root. Misalnya, di jendela **Terminal**, jalankan perintah berikut untuk membuat **pengguna uji** pada pembuat gambar:
**[ImageBuilderAdmin]\$1 sudo useradd -m test-user**
**[ImageBuilderAdmin]\$1 echo -e '*password*>\$1n<*password*>\$1n' \$1 sudo passwd test-user**
1. Beralih ke pengguna uji:
**[ImageBuilderAdmin]\$1 su - test-user**
1. Luncurkan aplikasi (misalnya, Chromium) sebagai pengguna uji:
**[test-user]\$1 /usr/bin/chromium-browser**
1. Verifikasi bahwa pengaturan default tersedia untuk pengguna pengujian (misalnya, halaman beranda Chromium adalah https://aws.amazon.com/).
1. Keluar:
**[test-user]\$1 logout**
## Langkah 6: Bersihkan
Akhirnya, langkah terakhir Anda adalah membersihkan.
**Untuk membersihkan**
1. Hapus TemplateUser:
**[ImageBuilderAdmin]\$1 sudo killall -u TemplateUser**
**[ImageBuilderAdmin]\$1 sudo userdel -r TemplateUser**
1. Hapus test-user (tidak diperlukan jika Anda melewati langkah 5):
**[ImageBuilderAdmin]\$1 sudo killall -u test-user**
**ImageBuilderAdmin]\$1 sudo userdel -r test-user**
# Membuat Variabel Lingkungan Default untuk Pengguna Linux Anda
Anda dapat membuat variabel lingkungan pada instance Linux Image Builder. Membuat variabel lingkungan membuatnya tersedia pada instance streaming yang dibuat dari gambar itu.
**catatan**
Pada instance armada Linux, variabel lingkungan yang disetel menggunakan alat Image Assistant (GUI) dan variabel lingkungan sistem default diekspor melalui skrip/etc/profile.d/appstream\$1system\$1vars.sh script. To access these environment variables, you must explicitly source the /etc/profile.d/appstream\$1system\$1vars.sh di aplikasi Anda.
**Untuk membuat variabel lingkungan untuk pengguna Anda**
1. Jika folder `/etc/profile` tidak ada, jalankan perintah berikut untuk membuatnya:
**[ImageBuilderAdmin]\$1 sudo mkdir -p /etc/profile.d**
1. Untuk membuat file skrip shell baru (misalnya, my-environment.sh) di folder ini, jalankan perintah berikut:
**[ImageBuilderAdmin]\$1 vim my-environment.sh**
1. Pada baris pertama file skrip, tambahkan konten berikut:
**\$1\$1/bin/sh **
1. Untuk setiap baris berikutnya, tambahkan **export** perintah untuk mengatur variabel lingkungan untuk gambar Anda. Contoh berikut `$HOME/bin` menambah `PATH` variabel:
**export PATH=”\$1HOME/bin:\$1PATH”**
1. Tekan tombol **Esc** untuk kembali ke mode perintah di vim, lalu jalankan perintah berikut untuk menyimpan skrip Anda dan keluar dari vim:
**:x**
1. Jalankan perintah berikut untuk memungkinkan skrip berjalan sebagai program:
**[ImageBuilderAdmin]\$1 chmod \$1x my-environment.sh**
# Mengoptimalkan Kinerja Peluncuran Aplikasi Linux Anda
Jika Anda menggunakan alat GUI Asisten Gambar, alat ini mengoptimalkan kinerja peluncuran untuk aplikasi Anda secara otomatis.
Jika Anda menggunakan CLI Asisten Gambar, gunakan langkah-langkah berikut untuk mengoptimalkan kinerja peluncuran secara manual. Saat Anda membuat dan menambahkan file ke manifes pengoptimalan aplikasi, aplikasi akan diluncurkan lebih cepat saat pertama kali dimulai pada instance armada baru. Namun, ini juga meningkatkan waktu yang diperlukan agar instance armada tersedia bagi pengguna. Manifes pengoptimalan adalah satu file teks yang dibatasi baris untuk setiap aplikasi.
Anda dapat membuat file manifes (seperti < *your-app* >-manifest.txt) baik secara manual atau dengan mengikuti langkah-langkah di bawah ini.
**Untuk membuat file manifes**
1. Pastikan aplikasi yang Anda coba optimalkan diluncurkan dan dijalankan.
1. Dari terminal di pembuat gambar Linux, jalankan perintah berikut:
**ps -ef \$1 grep <*application-process-name*>**
1. Cari nomor PID terkecil dari output langkah terakhir. Ini adalah PID untuk proses induk root aplikasi.
1. Jaga agar aplikasi tetap berjalan dan pastikan untuk menggunakan komponen awal yang dibutuhkan oleh pengguna Anda. Ini memastikan bahwa komponen-komponen ini ditangkap oleh proses optimasi.
1. Buat file skrip (misalnya,`~/getfilestool.sh`) dengan konten berikut:
```
#!/bin/bash
## usage getfilestool.sh $pid
lsof -p $(pstree -p $1 | grep -o '([0-9]\+)' | grep -o '[0-9]\+' | tr '\012' ,)|grep REG | sed -n '1!p' | awk '{print $9}'|awk 'NF'
```
1. Pastikan bahwa file dapat dijalankan dengan perintah berikut:
**[ImageBuilderAdmin]\$1 chmod u\$1x \$1/getfilestool.sh**
1. Jalankan perintah berikut untuk menangkap semua file yang berjalan dari proses induk root yang ditemukan di langkah 3, dan simpan ke file manifes sementara.
**[ImageBuilderAdmin]\$1 sudo \$1/getfilestool.sh <*root-parent-pid*> > /tmp/-manifest.txt **
1. Verifikasi konten manifes pengoptimalan, yang merupakan file teks yang dibatasi baris untuk setiap aplikasi.
Anda dapat menentukan manifes pengoptimalan berdasarkan per aplikasi dengan menggunakan alat antarmuka baris perintah Image Assistant (CLI). Untuk informasi selengkapnya, lihat [Menggunakan Alat CLI Asisten Gambar untuk Linux](image-assistant-cli.md).
# Membuat Skrip Sesi
WorkSpaces Aplikasi menyediakan skrip sesi on-instance pada instance streaming berbasis Windows dan Linux. Untuk informasi selengkapnya tentang skrip sesi, lihat[Gunakan Skrip Sesi untuk Mengelola Pengalaman Streaming Pengguna WorkSpaces Aplikasi Amazon Anda](use-session-scripts.md).
Skrip sesi ditentukan dalam gambar WorkSpaces Aplikasi. Untuk menemukan file konfigurasi skrip sesi pada instance Linux, navigasikan ke`/opt/appstream/SessionScripts/config.json`. Kode berikut adalah `config.json` file contoh yang menentukan skrip awal sesi bernama “`test-session-start`” dan skrip akhir sesi bernama “`test-session-stop`” bersama dengan parameter runtime mereka. Pastikan skrip yang direferensikan `config.json` telah menjalankan izin dan penerjemah perintah ditentukan (misalnya, \$1\$1 /bin/bash).
```
{
"SessionStart": {
"Executables": [
{
"Context": "system",
"Filename": "/opt/appstream/SessionScripts/test-session-start",
"Arguments": "arg1",
"S3LogEnabled": true
}
],
"WaitingTime": 30
},
"SessionTermination": {
"Executables": [
{
"Context": "system",
"Filename": "/opt/appstream/SessionScripts/test-session-stop",
"Arguments": "arg2",
"S3LogEnabled": true
}
],
"WaitingTime": 30
}
}
```
# Menggunakan Alat CLI Asisten Gambar untuk Linux
Pada pembuat gambar berbasis Linux, Anda dapat menggunakan alat CLI Asisten Gambar **AppStreamImageAssistant**untuk membuat dan mengelola gambar Aplikasi Anda. WorkSpaces Alat ini terletak di `/usr/local/appstream/image-assistant/AppStreamImageAssistant` dengan tautan simbolis di. `/bin/AppStreamImageAssistant` Alat CLI untuk Linux ini mendukung banyak operasi yang sama dengan alat CLI Asisten Gambar untuk Windows. Untuk informasi lebih lanjut tentang operasi ini, lihat[Operasi CLI Asisten Gambar untuk Membuat dan Mengelola Gambar Aplikasi Amazon WorkSpaces Anda](cli-operations-managing-creating-image-image-assistant.md).
# Mengaktifkan dan Menonaktifkan Dukungan Webcam
WorkSpaces Aplikasi mendukung audio-video (AV) real-time dengan mengarahkan input video webcam lokal ke WorkSpaces sesi streaming Aplikasi. Kemampuan ini memungkinkan pengguna Anda untuk menggunakan webcam lokal mereka untuk konferensi video dan audio dalam sesi streaming WorkSpaces Aplikasi. Dengan AV real-time dan dukungan untuk audio real-time, pengguna Anda dapat berkolaborasi dengan menggunakan aplikasi konferensi video dan audio yang sudah dikenal tanpa harus meninggalkan sesi streaming WorkSpaces Aplikasi mereka.
Untuk menggunakan fitur ini, Anda harus menggunakan image WorkSpaces Aplikasi Linux yang menggunakan agen WorkSpaces Aplikasi Linux yang dirilis pada atau setelah 21 September 2022.
**catatan**
AV real-time tidak didukung untuk instans stream.standard.small yang didukung oleh Rocky Linux atau Red Hat Enterprise Linux. Pengguna tidak melihat ikon Kamera dan Mikrofon di toolbar klien.
Fitur AV real-time diaktifkan secara default untuk sesi streaming Linux. Untuk mengonfigurasi izin webcam untuk pengguna Anda di pembuat gambar Linux, buat `/etc/appstream/appstream.conf` dan tambahkan konten berikut:
**catatan**
Tentukan **1** untuk mengaktifkan webcam, atau **0** untuk menonaktifkan webcam.
```
[webcam]
permission = 1
```
# Mengaktifkan dan Menonaktifkan Mode Sinkronisasi File Berat untuk Folder Rumah
Anda dapat mengaktifkan opsi Folder Amazon Simple Storage Service Beranda untuk organisasi Anda. Saat Anda mengaktifkan Folder Beranda Amazon S3 untuk tumpukan WorkSpaces Aplikasi, pengguna tumpukan dapat mengakses folder penyimpanan persisten selama sesi streaming aplikasi mereka. Tidak diperlukan konfirmasi lebih lanjut bagi pengguna Anda untuk mengakses folder beranda mereka. Data yang disimpan oleh pengguna di folder beranda mereka secara otomatis dicadangkan ke bucket Amazon S3 di Anda Akun AWS, dan tersedia untuk pengguna tersebut di sesi berikutnya. Untuk informasi selengkapnya, lihat [Aktifkan dan Kelola Folder Home untuk Pengguna WorkSpaces Aplikasi Anda](home-folders.md).
Untuk memastikan pengalaman yang lancar dan mengatasi beberapa batasan yang ada, di mana sinkronisasi file yang tidak konsisten dapat diamati ketika pengguna menyimpan file teks besar dari instance streaming mereka ke Folder Beranda mereka, administrator WorkSpaces Aplikasi dapat mengaktifkan opsi konfigurasi **heavy\$1sync** jika file besar diunggah ke Amazon S3 adalah skenario pengguna umum saat menggunakan Aplikasi. WorkSpaces Mengaktifkan opsi ini berarti mungkin menambahkan beberapa latensi ke proses sinkronisasi file folder rumah, tetapi kelengkapan semua sinkronisasi ke Amazon S3 dijamin.
Fitur ini tersedia di semua gambar Red Hat Enterprise Linux, dan gambar WorkSpaces Aplikasi Linux yang menggunakan agen WorkSpaces Aplikasi Linux yang dirilis pada atau setelah 12 September 2024.
Fitur sinkronisasi berat dinonaktifkan secara default untuk sesi streaming Red Hat Enterprise Linux dan Amazon Linux. Untuk mengonfigurasi izin sinkronisasi berat bagi pengguna Anda di pembuat gambar Red Hat Enterprise Linux atau Amazon Linux, buat `/etc/appstream/appstream.conf` dan tambahkan konten berikut:
**catatan**
Tentukan **1** untuk mengaktifkan sinkronisasi berat, atau **0** untuk menonaktifkan sinkronisasi berat.
```
[storage]
heavy_sync = 1
```
# Tutorial: Buat Gambar Aplikasi Berbasis Linux WorkSpaces Kustom
Tutorial ini menjelaskan cara membuat gambar Aplikasi WorkSpaces Amazon berbasis Linux kustom yang berisi aplikasi yang dapat Anda streaming ke pengguna Anda.
**penting**
Jangan membuat pengguna bernama “as2-streaming-user” di pembuat gambar Anda. Ini adalah nama pengguna yang dicadangkan untuk Fleet. Jika Anda membuat nama pengguna ini di luar alur kerja WorkSpaces Aplikasi, Anda mungkin mengalami masalah streaming di Armada.
**Topics**
+ [Langkah 1: Instal Aplikasi Linux pada Image Builder](#tutorial-linux-image-install)
+ [Langkah 2: Hasilkan File Manifes Pengoptimalan Aplikasi](#tutorial-linux-image-manifest)
+ [Langkah 3: Buat Katalog WorkSpaces Aplikasi Aplikasi](#tutorial-linux-image-catalog)
+ [Langkah 4: Buat Pengaturan Aplikasi Default dan Variabel Lingkungan](#tutorial-linux-image-create-default-app-settings)
+ [Langkah 5: Uji Aplikasi dan Pengaturan](#tutorial-linux-image-test-applications)
+ [Langkah 6: Selesai Membuat Gambar Anda](#tutorial-linux-image-finish-create-image)
+ [Langkah 7 (Opsional): Tag dan Salin Gambar](#tutorial-linux-image-tag-copy)
+ [Langkah 8: Bersihkan](#tutorial-linux-image-finish)
## Langkah 1: Instal Aplikasi Linux pada Image Builder
Pada langkah ini, Anda menghubungkan pembuat gambar Linux dan menginstal aplikasi Anda pada pembuat gambar.
**Untuk menginstal aplikasi pada pembuat gambar**
1. Connect ke image builder dengan melakukan salah satu hal berikut:
+ [Gunakan konsol WorkSpaces Aplikasi](managing-image-builders-connect-console.md) (hanya untuk koneksi web)
+ [Buat URL streaming](managing-image-builders-connect-streaming-URL.md) (untuk koneksi klien web atau WorkSpaces Aplikasi)
**catatan**
Anda akan masuk sebagai ImageBuilderAdmin pengguna ke desktop Amazon Linux GNOME dan memiliki hak admin root.
1. Instal aplikasi yang Anda butuhkan. Misalnya, untuk menginstal browser Chromium dari repo yum publik, pertama buka aplikasi Terminal, lalu jalankan perintah berikut:
**[ImageBuilderAdmin]\$1 sudo yum update && sudo yum install chromium.x86\$164**
**catatan**
Unduh dan instal aplikasi hanya dari situs yang Anda percayai.
## Langkah 2: Hasilkan File Manifes Pengoptimalan Aplikasi
Pada langkah ini, Anda menghasilkan file manifes untuk setiap aplikasi yang Anda instal di langkah 1.
**Untuk menghasilkan file manifes untuk mengoptimalkan kinerja peluncuran aplikasi**
1. Pastikan aplikasi (misalnya, Chromium) yang Anda coba optimalkan diluncurkan dan dijalankan.
1. Di jendela Terminal, jalankan perintah berikut untuk membuat daftar proses yang terkait dengan aplikasi:
**[ImageBuilderAdmin]\$1 ps -ef \$1 grep chromium **
1. Temukan PID induk root dari output perintah di atas. Berikut ini adalah contoh output, dan induk root PID adalah 16712:
**Example**
```
[ImageBuilderAdmin]$ ps -ef | grep chromium
ImageBu+ 16712 4128 0 Aug26 ? 00:00:44 /usr/lib64/chromium- browser/chromium-browser --enable-plugins --enable-extensions -- enable-user- scripts --enable-printing --enable-gpu-rasterization -- enable-sync --auto-ssl- client-auth
ImageBu+ 16726 16712 0 Aug26 ? 00:00:00 /usr/lib64/chromium- browser/chromium-browser --type=zygote --no-zygote-sandbox ImageBu+ 16727 16712 0 Aug26 ? 00:00:00 /usr/lib64/chromium- browser/chromium- browser --type=zygote
ImageBu+ 16731 16727 0 Aug26 ? 00:00:00 /usr/lib64/chromium- browser/chromium-browser --type=zygot
```
1. Jaga agar aplikasi tetap berjalan dan pastikan untuk menggunakan komponen awal yang dibutuhkan oleh pengguna Anda. Ini memastikan bahwa komponen-komponen ini ditangkap oleh proses optimasi.
1. Buat file script (misalnya,`~/getfilestool.sh`) dengan konten berikut:
```
#!/bin/bash
## usage getfilestool.sh $pid
lsof -p $(pstree -p $1 | grep -o '([0-9]\+)' | grep -o '[0-9]\+' | tr '\012' ,)|grep REG | sed -n '1!p' | awk '{print $9}'|awk 'NF'
```
1. Verifikasi bahwa file dapat dijalankan dengan menjalankan perintah berikut:
**[ImageBuilderAdmin]\$1 chmod u\$1x \$1/getfilestool.sh**
1. Jalankan perintah berikut untuk menangkap semua file yang berjalan dari proses induk root yang ditemukan pada langkah 3 di atas, dan simpan ke file manifes sementara:
**[ImageBuilderAdmin]\$1 sudo \$1/getfilestool.sh 16712 > /tmp/chromium-manifest.txt **
1. Verifikasi konten manifes pengoptimalan, yang merupakan file teks yang dibatasi baris untuk setiap aplikasi.
## Langkah 3: Buat Katalog WorkSpaces Aplikasi Aplikasi
Pada langkah ini, Anda menggunakan alat CLI `AppStreamImageAssistant` pada pembuat gambar untuk membuat katalog WorkSpaces aplikasi Aplikasi dengan menentukan aplikasi untuk gambar Anda. Untuk setiap aplikasi yang Anda rencanakan untuk streaming, Anda dapat menentukan nama, nama tampilan, file yang dapat dieksekusi untuk diluncurkan, dan ikon yang akan ditampilkan.
**Untuk membuat katalog WorkSpaces aplikasi Aplikasi**
1. Dari desktop pembuat gambar, buka **Terminal** baik dari panel samping atau dengan membuka kisi aplikasi.
1. Jalankan **AppStreamImageAssistant --help** untuk melihat daftar perintah yang tersedia. Anda akan menggunakan perintah ini untuk menambahkan aplikasi dan membuat Gambar.
1. Jalankan perintah berikut untuk menambahkan aplikasi yang diinstal (misalnya, Chromium) ke daftar aplikasi untuk pengguna WorkSpaces Aplikasi:
```
AppStreamImageAssistant add-application \
--name Chromium \
--absolute-app-path /usr/lib64/chromium-browser/chromium-browser \
--display-name Chromium \
--absolute-icon-path /usr/share/icons/hicolor/256x256/apps/chromium-browser.png \
--absolute-manifest-path /tmp/chromium-manifest.txt
```
Atau, jalankan perintah berikut:
```
AppStreamImageAssistant add-application \
--name="Chromium" \
--absolute-app-path="/usr/lib64/chromium-browser/chromium-browser" \
--display-name="Chromium" \
--absolute-icon-path="/usr/share/icons/hicolor/256x256/apps/chromium-browser.png" \
--absolute-manifest-path="/tmp/chromium-manifest.txt"
```
1. Untuk menambahkan lebih banyak aplikasi, ulangi langkah 3 untuk setiap aplikasi tambahan.
1. Untuk melihat daftar aplikasi yang telah ditambahkan dalam katalog, bersama dengan metadata seperti jalur ikon dan parameter peluncuran, jalankan perintah berikut:
**AppStreamImageAssistant list-applications**
1. Untuk menghapus aplikasi dari katalog, jalankan perintah berikut:
**AppStreamImageAssistant remove-application –-name *application\$1name***
## Langkah 4: Buat Pengaturan Aplikasi Default dan Variabel Lingkungan
Pada langkah ini, Anda membuat pengaturan aplikasi default dan variabel lingkungan untuk pengguna WorkSpaces Aplikasi Anda. Melakukan hal ini memungkinkan pengguna Anda untuk memulai dengan aplikasi dengan cepat selama sesi streaming WorkSpaces Aplikasi mereka, tanpa perlu membuat atau mengonfigurasi pengaturan ini sendiri.
**Untuk membuat variabel aplikasi dan lingkungan default untuk pengguna Anda**
1. Luncurkan aplikasi yang Anda inginkan buat pengaturan default untuk. Misalnya, di jendela Terminal, jalankan perintah berikut untuk meluncurkan browser Chromium:
**[ImageBuilderAdmin]\$1 chromium-browser**
1. Konfigurasikan pengaturan aplikasi. Misalnya, atur halaman beranda browser Chromium sebagai**https://aws.amazon.com**.
1. **Pastikan aplikasi Chromium ditutup, lalu jalankan perintah berikut untuk menyalin konfigurasi Chromium ke/etc/skel:**
**[ImageBuilderAdmin]\$1 sudo mkdir /etc/skel/.config**
**[ImageBuilderAdmin]\$1 sudo cp -R \$1/.config/chromium /etc/skel/.config**
1. Mengatur variabel lingkungan dan menambahkannya ke file script. Misalnya, jalankan perintah berikut:
**[ImageBuilderAdmin]\$1 echo "export *FOO*=*BAR*" \$1 sudo tee -a /etc/profile.d/myenvvars.sh**
**[ImageBuilderAdmin]\$1 sudo chmod \$1x /etc/profile.d/myenvvars.sh**
## Langkah 5: Uji Aplikasi dan Pengaturan
Pada langkah ini, verifikasi bahwa aplikasi yang Anda tambahkan berjalan dengan benar, dan pengaturan aplikasi default dan variabel lingkungan berfungsi seperti yang diharapkan.
**Untuk menguji aplikasi dan pengaturan default pada pembuat gambar**
1. Buat pengguna uji yang tidak memiliki izin root. Misalnya, di jendela **Terminal**, jalankan perintah berikut untuk membuat **pengguna uji** pada pembuat gambar:
**[ImageBuilderAdmin]\$1 sudo useradd -m test-user**
**[ImageBuilderAdmin]\$1 echo -e 'Pa55w0rdas2\$1\$1\$1\$1nPa55w0rdas2\$1\$1\$1\$1n' \$1 sudo passwd test-user**
1. Beralih ke pengguna uji:
**[ImageBuilderAdmin]\$1 su - test-user**
1. Luncurkan aplikasi (misalnya, Chromium) sebagai pengguna uji:
**[test-user]\$1 /usr/bin/chromium-browser**
1. Verifikasi bahwa pengaturan default tersedia untuk pengguna pengujian (misalnya, halaman beranda Chromium adalah https://aws.amazon.com/).
1. Verifikasi bahwa variabel lingkungan tersedia untuk pengguna uji. Sebagai contoh, jalankan perintah berikut:
**[test-user]\$1 echo \$1*FOO***
Perintah ini harus menampilkan output ***BAR*** di terminal.
1. Jalankan perintah berikut untuk menghapus pengguna uji sebelum membuat gambar dari pembuat gambar ini:
**\$1 logout test user**
**[test-user]\$1 logout**
**\$1 kill test user's running processes**
**[ImageBuilderAdmin]\$1 sudo killall -u test-user**
**\$1 delete user**
**[ImageBuilderAdmin]\$1 sudo userdel -r test-user**
## Langkah 6: Selesai Membuat Gambar Anda
Pada langkah ini, pilih nama gambar dan selesaikan pembuatan gambar Anda.
**Untuk membuat gambar**
1. Di jendela **Terminal**, buat gambar dari Image Builder Anda dengan menjalankan**AppStreamImageAssistant create-image**. Gambar ini berisi aplikasi terinstal dan terdaftar Anda, ditambah skrip sesi dan pengaturan aplikasi default yang telah Anda konfigurasikan.
Untuk melihat daftar opsi yang tersedia, jalankan**AppStreamImageAssistant create-image --help**. Untuk informasi selengkapnya, lihat operasi **create-image** di. [Buat Gambar WorkSpaces Aplikasi Amazon Anda Secara Terprogram dengan Menggunakan Operasi CLI Asisten Gambar](programmatically-create-image.md)
1. Sesi jarak jauh terputus setelah beberapa saat. Ketika pesan **Konektivitas Hilang** muncul, tutup tab browser. Saat gambar dibuat, status pembuat gambar muncul sebagai **Snapshotting**. Anda tidak dapat terhubung ke pembuat gambar sampai proses ini selesai.
1. Kembali ke konsol dan arahkan ke **Images**, **Image Registry**. Verifikasi bahwa gambar baru Anda muncul dalam daftar.
Saat gambar Anda sedang dibuat, status gambar di registri gambar konsol muncul sebagai **Pending**. Anda tidak dapat terhubung ke gambar yang berada dalam status **Tertunda**.
1. Pilih ikon **Refresh** untuk memperbarui status. Setelah gambar Anda dibuat, status gambar berubah menjadi **Tersedia** dan pembuat gambar dihentikan secara otomatis.
Untuk terus membuat gambar, mulai pembuat gambar dan sambungkan dari konsol, atau buat pembuat gambar baru.
## Langkah 7 (Opsional): Tag dan Salin Gambar
Anda dapat menambahkan satu atau beberapa tag ke gambar selama pembuatan gambar atau setelah Anda membuat gambar. Anda juga dapat menyalin gambar dalam Wilayah yang sama atau ke Wilayah baru dalam akun Amazon Web Services yang sama. Menyalin gambar sumber menghasilkan gambar tujuan yang identik tetapi berbeda. AWS Namun, tidak menyalin tag yang ditentukan pengguna. Selain itu, Anda hanya dapat menyalin gambar khusus yang Anda buat, bukan gambar dasar yang disediakan oleh AWS.
**catatan**
Anda dapat menyalin hingga dua gambar sekaligus ke tujuan. Jika tujuan Anda menyalin gambar berada pada batas gambar, Anda menerima kesalahan. Untuk menyalin gambar dalam hal ini, Anda harus terlebih dahulu menghapus gambar dari tujuan. Setelah tujuan berada di bawah kuota gambar (disebut juga limit), mulailah salinan gambar dari daerah sumber. Untuk informasi selengkapnya, lihat [Service Quotas WorkSpaces Aplikasi Amazon](limits.md).
**Untuk menambahkan tag ke gambar yang ada**
1. Di panel navigasi, pilih **Gambar**, **Registri Gambar**.
1. Dalam daftar gambar, pilih gambar yang ingin Anda tambahkan tag.
1. Pilih **Tag**, pilih **Tambah/Edit Tag**, lalu pilih **Tambah** Tag. Tentukan kunci dan nilai untuk tag, lalu pilih **Simpan**.
Untuk informasi selengkapnya, lihat [Menandai Sumber Daya WorkSpaces Aplikasi Amazon Anda](tagging-basic.md).
**Untuk menyalin gambar**
Menyalin gambar di wilayah yang beragam secara geografis memungkinkan Anda melakukan streaming aplikasi dari beberapa wilayah berdasarkan gambar yang sama. Dengan streaming aplikasi Anda di dekat pengguna Anda, Anda dapat meningkatkan pengalaman pengguna Anda streaming aplikasi dengan WorkSpaces Aplikasi.
1. Di panel navigasi, pilih **Gambar**, **Registri Gambar**.
1. Dalam daftar gambar, pilih gambar yang ingin Anda salin.
1. Pilih **Tindakan**, **Salin**.
1. Dalam **Salin Gambar** kotak dialog, tentukan informasi berikut, lalu pilih **Salin Gambar**:
+ Untuk **wilayah Tujuan**, pilih wilayah untuk menyalin gambar baru.
+ Untuk **Nama**, tentukan nama yang akan dimiliki gambar saat disalin ke tujuan.
+ Untuk **Deskripsi** (opsional), tentukan deskripsi yang akan dimiliki gambar saat disalin ke tujuan.
1. Untuk memeriksa kemajuan operasi penyalinan, kembali ke konsol dan arahkan ke **Gambar**, **Registri Gambar**. Gunakan bilah navigasi untuk beralih ke wilayah tujuan (jika ada), dan konfirmasikan bahwa gambar baru Anda muncul dalam daftar gambar.
Gambar baru pertama kali muncul dengan status **Menyalin** di registri gambar konsol Anda. Setelah gambar berhasil dibuat, status gambar berubah menjadi **Tersedia**, yang berarti Anda dapat menggunakan gambar untuk meluncurkan tumpukan dan streaming aplikasi Anda.
## Langkah 8: Bersihkan
Terakhir, Anda dapat menghentikan pembuat gambar yang sedang berjalan untuk membebaskan sumber daya dan menghindari biaya yang tidak diinginkan ke akun Anda. Kami merekomendasikan untuk menghentikan pembuat gambar yang tidak terpakai dan berjalan. Untuk informasi selengkapnya, lihat [Harga WorkSpaces Aplikasi](https://aws.amazon.com/appstream2/pricing/).
**Untuk menghentikan pembuat gambar yang sedang berjalan**
1. Di panel navigasi, pilih **Gambar**, **Pembuat Gambar**, dan pilih instance pembuat gambar yang sedang berjalan.
1. Pilih **Tindakan**, **Berhenti**.
# Tutorial: Aktifkan Dukungan Jepang untuk Gambar Linux Anda
Tutorial ini menjelaskan cara mengaktifkan dukungan Jepang untuk gambar Linux. Ini memungkinkan aplikasi pada gambar untuk menampilkan karakter Jepang, dan pengguna streaming untuk menggunakan metode input Jepang dalam sesi streaming dari gambar.
**Topics**
+ [Langkah 1: Instal Font Jepang dan Metode Input](#tutorial-japanese-font)
+ [Langkah 2: Atur Zona Waktu Sistem](#tutorial-japanese-zone)
+ [Langkah 3: Atur Sistem Lokal dan Bahasa Tampilan](#tutorial-japanese-locale)
+ [Langkah 4: Konfigurasikan Metode Input](#tutorial-japanese-input)
+ [Langkah 5: Atur Tata Letak Keyboard](#tutorial-japense-keyboard)
+ [Langkah 6: Verifikasi pada Image Builder](#tutorial-japense-verify)
+ [Langkah 7: Buat Gambar](#tutorial-japanese-create)
## Langkah 1: Instal Font Jepang dan Metode Input
Pada langkah ini, Anda menghubungkan pembuat gambar Linux dan menginstal paket font dan metode input pilihan Anda.
**Untuk menginstal font Jepang dan metode input**
1. Connect ke image builder dengan melakukan salah satu hal berikut:
+ [Gunakan konsol WorkSpaces Aplikasi](managing-image-builders-connect-console.md) (hanya untuk koneksi web)
+ [Buat URL streaming](managing-image-builders-connect-streaming-URL.md) (untuk koneksi klien web atau WorkSpaces Aplikasi)
**catatan**
Anda akan masuk sebagai ImageBuilderAdmin pengguna ke desktop Amazon Linux GNOME dan memiliki hak admin root.
1. Instal font dan metode input yang Anda butuhkan. Untuk melakukan ini, buka aplikasi Terminal, lalu jalankan perintah berikut:
**sudo yum install vlgothic-p-fonts.noarch**
**sudo yum install ibus-kkc.x86\$164**
1. Selain perintah di atas, untuk Rocky Linux dan Red Hat Enterprise Linux, jalankan perintah berikut:
**sudo yum install glibc-langpack-ja**
## Langkah 2: Atur Zona Waktu Sistem
Untuk mengatur zona waktu sistem, jalankan perintah berikut:
**sudo timedatectl set-timezone "Asia/Tokyo"**
## Langkah 3: Atur Sistem Lokal dan Bahasa Tampilan
Untuk mengatur lokal sistem dan bahasa tampilan, jalankan perintah berikut.
**Untuk mengatur lokal sistem dan bahasa tampilan**
1. Perbarui `cloud-init config` file dengan menjalankan perintah**sudo vim /etc/cloud/cloud.cfg**, dan ubah **lokal ke lokal****: JA\$1JP.UTF8**, lalu simpan dan tutup file.
1. Perbarui pengaturan sistem dengan menjalankan**sudo localectl set-locale LANG=ja\$1JP.utf8**.
1. Perbarui pengaturan shell Gnome dengan menjalankan**sudo gsettings set org.gnome.system.locale region "ja\$1JP.utf8"**.
## Langkah 4: Konfigurasikan Metode Input
Konfigurasikan metode input untuk aplikasi yang ingin Anda tambahkan ke gambar. Untuk informasi selengkapnya tentang cara menginstal aplikasi, menghasilkan file manifes, dan membuat pengaturan default, lihat[Tutorial: Buat Gambar Aplikasi Berbasis Linux WorkSpaces Kustom](tutorial-create-linux-image.md). Pada langkah ini, kami berasumsi bahwa Anda telah menginstal aplikasi Firefox, yang terletak di`/usr/local/firefox/firefox`.
**Untuk mengkonfigurasi metode input**
1. Buat skrip dengan menjalankan perintah**sudo vim /usr/local/bin/update-input-method.sh**, dan tambahkan konten berikut ke skrip:
```
#!/bin/bash
function start_process()
{
command=$1
process_name=$2
process_count=$(pgrep $process_name -c)
echo "$(date) current $process_name count: $process_count"
while [ $process_count -lt 1 ]
do
echo "$(date) starting $process_name"
eval $command
sleep 1
process_count=$(pgrep $process_name -c)
done
echo "$(date) $process_name started"
}
start_process "ibus-daemon --xim &" "ibus-daemon"
start_process "/usr/libexec/ibus-engine-kkc --ibus &" "ibus-engine-kkc"
gsettings set org.gnome.desktop.input-sources sources "[('ibus','kkc'), ('xkb', 'us')]"
gsettings set org.gnome.desktop.wm.keybindings switch-input-source "['space']"
gsettings set org.gnome.desktop.wm.keybindings switch-input-source-backward "['space']"
echo "$(date) updated input source and switch shortcut"
```
Dalam skrip di atas, sumber input pertama ('ibus', 'kkc') adalah metode input default. Anda dapat mengubah metode input default dengan mengubah urutan sumber input. Selain itu, “Control\$1Space” dan “Shift\$1Control\$1Space” ditentukan sebagai kombinasi tombol pintas untuk beralih antar metode input. Anda dapat menentukan kombinasi tombol Anda sendiri yang dapat digunakan pengguna Anda untuk beralih metode input selama sesi streaming.
1. Buat skrip untuk meluncurkan aplikasi (Firefox) yang akan Anda tambahkan ke gambar. Untuk melakukan ini, jalankan perintah**sudo vim /usr/local/bin/firefox-jp.sh**, lalu tambahkan konten berikut ke skrip:
```
#!/bin/bash
# Gather required environment variables from the GNOME shell session
while IFS= read -r -d $'\0' env_var; do
case "$env_var" in
DBUS_SESSION_BUS_ADDRESS=*|\
GTK_IM_MODULE=*|\
QT_IM_MODULE=*|\
XMODIFIERS=*|\
XAUTHORITY=*)
echo "$env_var"
export "$env_var"
;;
esac
done < "/proc/$(pgrep -u as2-streaming-user gnome-shell | head -n1)/environ"
/usr/local/bin/update-input-method.sh > /var/tmp/update-input-method.log 2>&1 &
/usr/local/firefox/firefox &
```
1. Tambahkan izin jalankan ke kedua skrip dengan menjalankan perintah berikut:
**sudo chmod \$1x /usr/local/bin/update-input-method.sh**
**sudo chmod \$1x /usr/local/bin/firefox-jp.sh**
1. Jika Anda sudah membuat file manifes optimasi untuk aplikasi, jalankan perintah berikut untuk menambahkan skrip peluncuran aplikasi ke katalog aplikasi:
```
sudo AppStreamImageAssistant add-application \
--name firefox \
--absolute-app-path /usr/local/bin/firefox-jp.sh \
--display-name firefox \
--absolute-icon-path /usr/local/firefox/browser/chrome/icons/default/default128.png \
--absolute-manifest-path /tmp/firefox-manifest.txt
```
Atau, Anda juga dapat mengkonfigurasi metode input dengan menambahkan script update-input-method .sh sebagai aplikasi terpisah ke katalog aplikasi untuk gambar. Selama sesi streaming, pengguna Anda dapat meluncurkan aplikasi ini untuk mengaktifkan input bahasa Jepang, dan beralih di antara metode input dengan tombol pintas yang ditentukan dalam sesi yang sama.
## Langkah 5: Atur Tata Letak Keyboard
Atur tata letak keyboard agar sesuai dengan keyboard yang akan digunakan pengguna Anda selama sesi streaming. Anda dapat menggunakan perintah **localectl list-keymaps** untuk membuat daftar semua keymap yang tersedia, dan menggunakan perintah **sudo localectl set-keymap jp106** untuk mengatur keymap ke keyboard Jepang dari 106 tombol, misalnya.
## Langkah 6: Verifikasi pada Image Builder
Untuk memverifikasi pembuat gambar, pertama-tama reboot pembuat gambar dengan menjalankan perintah**sudo shutdown -r now**. Setelah reboot, sambungkan ke pembuat gambar lagi, dan verifikasi bahwa semuanya, termasuk zona waktu, lokal, bahasa, dan metode input, berfungsi seperti yang diharapkan.
## Langkah 7: Buat Gambar
Buat gambar pada pembuat gambar. Untuk informasi selengkapnya, lihat [Tutorial: Buat Gambar Aplikasi Berbasis Linux WorkSpaces Kustom](tutorial-create-linux-image.md). Pastikan untuk membuat pengaturan aplikasi default, termasuk pengaturan regional yang baru saja Anda konfigurasikan. Untuk informasi selengkapnya, lihat “Membuat Pengaturan Aplikasi Default untuk Pengguna Anda” di[Buat Gambar Berbasis Linux Anda](create-linux-based-images.md).
Semua instance armada Linux yang dibuat dari gambar ini akan memiliki pengaturan zona waktu, lokal, bahasa, dan metode input default yang sama dengan yang Anda konfigurasikan untuk gambar.
# Gunakan Skrip Sesi untuk Mengelola Pengalaman Streaming Pengguna WorkSpaces Aplikasi Amazon Anda
WorkSpaces Aplikasi menyediakan skrip sesi on-instance. Anda dapat menggunakan skrip ini untuk menjalankan skrip kustom Anda sendiri ketika peristiwa tertentu terjadi dalam sesi streaming pengguna. Misalnya, Anda dapat menggunakan skrip khusus untuk mempersiapkan lingkungan WorkSpaces Aplikasi Anda sebelum sesi streaming pengguna dimulai. Anda juga dapat menggunakan skrip khusus untuk membersihkan instance streaming setelah pengguna menyelesaikan sesi streaming mereka.
Skrip sesi ditentukan dalam gambar WorkSpaces Aplikasi. Skrip ini dijalankan dalam konteks pengguna atau konteks sistem. Jika skrip sesi Anda menggunakan standar keluar untuk menulis informasi, kesalahan, atau men-debug pesan, skrip ini dapat disimpan secara opsional ke bucket Amazon S3 dalam akun Amazon Web Services Anda.
**Topics**
+ [Jalankan Skrip Sebelum Sesi Streaming Dimulai](run-scripts-before-streaming-sessions-begin.md)
+ [Jalankan Skrip Setelah Sesi Streaming Berakhir](run-scripts-after-streaming-sessions-end.md)
+ [Buat dan Tentukan Skrip Sesi](create-specify-session-scripts.md)
+ [File Konfigurasi Skrip Sesi](session-script-configuration-file.md)
+ [Menggunakan PowerShell File Windows](using-powershell-files-with-session-scripts.md)
+ [Keluaran Skrip Sesi Pencatatan](logging-session-output.md)
+ [Gunakan Konektor Penyimpanan dengan Skrip Sesi](use-storage-connectors-with-session-scripts.md)
+ [Aktifkan Penyimpanan Bucket Amazon S3 untuk Log Skrip Sesi](enable-S3-bucket-storage-session-script-logs.md)
+ [Gunakan Skrip Sesi pada Armada Multi-Sesi](session-scripts-multi-session-fleets.md)
# Jalankan Skrip Sebelum Sesi Streaming Dimulai
Anda dapat mengonfigurasi skrip agar berjalan maksimal 60 detik sebelum aplikasi pengguna diluncurkan dan sesi streaming mereka dimulai. Melakukannya memungkinkan Anda untuk menyesuaikan lingkungan WorkSpaces Aplikasi sebelum pengguna mulai streaming aplikasi mereka. Saat skrip sesi berjalan, spinner pemuatan akan ditampilkan untuk pengguna Anda. Ketika skrip Anda berhasil diselesaikan atau waktu tunggu maksimum berlalu, sesi streaming pengguna Anda akan dimulai. Jika skrip Anda tidak berhasil diselesaikan, pesan kesalahan akan ditampilkan untuk pengguna Anda. Namun, pengguna Anda tidak dicegah menggunakan sesi streaming mereka.
Saat Anda menentukan nama file pada instance Windows, Anda harus menggunakan garis miring terbalik ganda. Contoh:
C:\$1\$1 Skrip\$1\$1 Myscript.bat
Jika Anda tidak menggunakan garis miring terbalik ganda, kesalahan akan ditampilkan untuk memberi tahu Anda bahwa file.json salah diformat.
**catatan**
Ketika skrip Anda berhasil diselesaikan, mereka harus mengembalikan nilai 0. Jika skrip Anda mengembalikan nilai selain 0, WorkSpaces Aplikasi menampilkan pesan kesalahan kepada pengguna.
Ketika Anda menjalankan skrip sebelum sesi streaming dimulai dan kerangka WorkSpaces aplikasi dinamis Aplikasi tidak diaktifkan, proses berikut terjadi:
![\[WorkSpaces Applications workflow diagram showing connection, application selection, and session launch steps.\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/images/session-scripts-without-DAF-non-domain-joined2.png)
1. Pengguna Anda terhubung ke instance armada WorkSpaces Aplikasi yang tidak bergabung dengan domain. Mereka terhubung dengan menggunakan salah satu metode akses berikut:
+ WorkSpaces Kolam pengguna aplikasi
+ SAML 2.0
+ WorkSpaces Aplikasi API
1. Katalog aplikasi ditampilkan di portal WorkSpaces Aplikasi, dan pengguna Anda memilih aplikasi untuk diluncurkan.
1. Salah satu hal berikut terjadi:
+ Jika persistensi pengaturan aplikasi diaktifkan untuk pengguna Anda, file pengaturan aplikasi Virtual Hard Disk (VHD) yang menyimpan penyesuaian pengguna Anda dan pengaturan Windows diunduh dan dipasang. Login pengguna Windows diperlukan dalam kasus ini.
Untuk informasi tentang persistensi setelan aplikasi, lihat[Aktifkan Persistensi Pengaturan Aplikasi untuk Pengguna WorkSpaces Aplikasi Anda](app-settings-persistence.md).
+ Jika persistensi pengaturan aplikasi tidak diaktifkan, pengguna Windows sudah masuk.
1. Skrip sesi Anda dimulai. Jika penyimpanan persisten diaktifkan untuk pengguna Anda, pemasangan konektor penyimpanan juga dimulai. Untuk informasi tentang penyimpanan persisten, lihat[Aktifkan dan Kelola Penyimpanan Persisten untuk Pengguna WorkSpaces Aplikasi Anda](persistent-storage.md).
**catatan**
Pemasangan konektor penyimpanan tidak perlu diselesaikan agar sesi streaming dimulai. Jika skrip sesi selesai sebelum pemasangan konektor penyimpanan selesai, sesi streaming dimulai.
Untuk informasi tentang memantau status pemasangan konektor penyimpanan, lihat[Gunakan Konektor Penyimpanan dengan Skrip Sesi](use-storage-connectors-with-session-scripts.md).
1. Skrip sesi Anda selesai atau habis waktu.
1. Sesi streaming pengguna dimulai.
1. Aplikasi yang dipilih pengguna Anda diluncurkan.
Untuk informasi tentang kerangka WorkSpaces aplikasi dinamis Aplikasi, lihat[Menggunakan WorkSpaces Applications Dynamic Application Framework untuk Membangun Penyedia Aplikasi Dinamis](build-dynamic-app-provider.md).
Ketika Anda menjalankan skrip sebelum sesi streaming dimulai dan kerangka WorkSpaces aplikasi dinamis Aplikasi diaktifkan, proses berikut terjadi:
![\[WorkSpaces Applications workflow from user login to application launch, including SAML authentication and session scripts.\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/images/session-scripts-with-DAF-domain-joined2.png)
1. Pengguna Anda mengunjungi portal aplikasi SAMP 2.0 untuk organisasi Anda, dan mereka memilih tumpukan WorkSpaces Aplikasi.
1. Mereka terhubung ke instance armada WorkSpaces Aplikasi yang bergabung dengan domain.
1. Jika persistensi pengaturan aplikasi diaktifkan untuk pengguna Anda, file VHD pengaturan aplikasi yang menyimpan penyesuaian pengguna Anda dan pengaturan Windows diunduh dan dipasang.
1. Logon pengguna Windows terjadi.
1. Katalog aplikasi ditampilkan di portal WorkSpaces Aplikasi dan pengguna Anda memilih aplikasi untuk diluncurkan.
1. Skrip sesi Anda dimulai. Jika penyimpanan persisten diaktifkan untuk pengguna Anda, pemasangan konektor penyimpanan juga dimulai.
**catatan**
Pemasangan konektor penyimpanan tidak perlu diselesaikan agar sesi streaming dimulai. Jika skrip sesi selesai sebelum pemasangan konektor penyimpanan selesai, sesi streaming dimulai.
Untuk informasi tentang memantau status pemasangan konektor penyimpanan, lihat[Gunakan Konektor Penyimpanan dengan Skrip Sesi](use-storage-connectors-with-session-scripts.md).
1. Skrip sesi Anda selesai atau habis waktu.
1. Sesi streaming pengguna dimulai.
1. Aplikasi yang dipilih pengguna Anda diluncurkan.
# Jalankan Skrip Setelah Sesi Streaming Berakhir
Anda juga dapat mengonfigurasi skrip agar berjalan setelah sesi streaming pengguna berakhir. Misalnya, Anda dapat menjalankan skrip saat pengguna memilih **Akhir Sesi** dari toolbar WorkSpaces Aplikasi, atau ketika mereka mencapai durasi maksimum yang diizinkan untuk sesi tersebut. Anda juga dapat menggunakan skrip sesi ini untuk membersihkan lingkungan WorkSpaces Aplikasi Anda sebelum instance streaming dihentikan. Misalnya, Anda dapat menggunakan skrip untuk melepaskan kunci file atau mengunggah file log. Saat Anda menjalankan skrip setelah sesi streaming berakhir, proses berikut terjadi:
![\[Flowchart showing WorkSpaces Applications session termination process with scripts and storage actions.\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/images/session-scripts-termination.png)
1. Sesi streaming WorkSpaces Aplikasi pengguna Anda berakhir.
1. Skrip penghentian sesi Anda dimulai.
1. Skrip penghentian sesi selesai atau habis waktu.
1. Terjadi logout pengguna Windows.
1. Salah satu atau kedua hal berikut terjadi secara paralel, jika berlaku:
+ Jika persistensi pengaturan aplikasi diaktifkan untuk pengguna Anda, file VHD pengaturan aplikasi yang menyimpan penyesuaian dan pengaturan Windows pengguna Anda dilepas dan diunggah ke bucket Amazon S3 di akun Anda.
+ Jika penyimpanan persisten diaktifkan untuk pengguna Anda, konektor penyimpanan menyelesaikan sinkronisasi akhir dan dilepas.
1. Instance armada dihentikan.
# Buat dan Tentukan Skrip Sesi
Anda dapat mengonfigurasi dan menentukan skrip sesi untuk armada Always-on, On-Demand, dan Elastic.
**Untuk mengonfigurasi dan menentukan skrip sesi untuk armada Always-on dan On-Demand**
1. Buka konsol WorkSpaces Aplikasi di [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).
1. Di panel navigasi, pilih **Images**, **Image Builder**.
1. Pilih pembuat gambar yang berada dalam status **Running**, dan pilih **Connect**.
1. Saat diminta, pilih **Administrator**.
1. Arahkan ke`C:\AppStream\SessionScripts`, dan buka file `config.json` konfigurasi.
Untuk informasi tentang parameter skrip sesi, lihat[File Konfigurasi Skrip Sesi](session-script-configuration-file.md).
1. Setelah Anda selesai membuat perubahan, simpan dan tutup `config.json` file.
1. Pada desktop pembuat gambar, buka **Asisten Gambar**.
1. (Opsional) Tentukan aplikasi tambahan apa pun yang ingin Anda sertakan dalam gambar.
1. Ikuti langkah-langkah yang diperlukan di Image Assistant untuk menyelesaikan pembuatan gambar Anda.
**Jika konfigurasi skrip sesi tidak dapat divalidasi (misalnya, jika file.json tidak diformat dengan benar), Anda akan diberi tahu saat memilih Putuskan sambungan dan buat gambar.**
**catatan**
Untuk menemukan file konfigurasi skrip sesi untuk pembuat gambar berbasis Linux, navigasikan ke. `/opt/appstream/SessionScripts/config.json`
**Untuk mengkonfigurasi dan menentukan skrip sesi untuk armada Elastis**
1. Buat file zip yang berisi skrip sesi dan file config.json. File skrip akan disalin ke lokasi berikut. Anda harus menggunakan lokasi ini untuk config.json Anda.
+ Untuk Windows, gunakan`C:\AppStream\SessionScripts\SessionScript`.
+ Untuk Linux, gunakan`/opt/appstream/SessionScripts/SessionScript`.
**catatan**
Untuk menjalankan file skrip sesi, pastikan bahwa file.zip hanya berisi skrip sesi dan `config.json` file, dan bukan folder yang berisi. Untuk informasi selengkapnya, lihat [File Konfigurasi Skrip Sesi](session-script-configuration-file.md).
1. Unggah file zip ke bucket Amazon S3 di akun Anda.
**catatan**
VPC Anda harus menyediakan akses ke bucket Amazon S3. Untuk informasi selengkapnya, lihat [Menggunakan Endpoint Amazon S3 VPC untuk Fitur Aplikasi WorkSpaces](managing-network-vpce-iam-policy.md).
Anda harus memiliki bucket S3 dan armada WorkSpaces Aplikasi yang sama Wilayah AWS.
Anda harus memiliki izin IAM untuk melakukan `S3:GetObject` tindakan pada objek skrip sesi di bucket Amazon S3. Untuk mempelajari selengkapnya tentang menyimpan skrip sesi di bucket Amazon S3, lihat. [Simpan Ikon Aplikasi, Skrip Pengaturan, Skrip Sesi, dan VHD dalam Bucket S3](store-s3-bucket.md)
1. Buka konsol WorkSpaces Aplikasi di [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).
1. Di panel navigasi, pilih **Armada.**
1. Pilih armada Elastic yang ingin Anda perbarui, lalu pilih **Lihat Detail**.
1. Pada tab **Pengaturan skrip sesi**, pilih **Edit**.
1. Untuk **objek skrip Sesi di S3**, masukkan URI S3 yang mewakili objek skrip sesi, atau pilih **Browse S3 untuk menavigasi ke bucket S3** Anda dan temukan objek skrip sesi.
1. Setelah Anda selesai membuat perubahan, pilih **Simpan Perubahan**.
1. Pada titik ini, skrip sesi tersedia untuk semua instance armada yang diluncurkan.
**catatan**
Anda juga dapat mengonfigurasi skrip sesi saat membuat armada Elastis baru.
# File Konfigurasi Skrip Sesi
Untuk menemukan file konfigurasi skrip sesi dalam instance Windows, navigasikan ke C:\$1\$1 AppStreamSessionScripts\$1 config.json. Pada instance Linux, navigasikan ke/opt/appstream/SessionScripts/config.json. File diformat sebagai berikut.
**catatan**
File konfigurasi dalam format.json. Verifikasi bahwa teks apa pun yang Anda ketik dalam file ini dalam format.json yang valid.
```
{
"SessionStart": {
"executables": [
{
"context": "system",
"filename": "",
"arguments": "",
"s3LogEnabled": true
},
{
"context": "user",
"filename": "",
"arguments": "",
"s3LogEnabled": true
}
],
"waitingTime": 30
},
"SessionTermination": {
"executables": [
{
"context": "system",
"filename": "",
"arguments": "",
"s3LogEnabled": true
},
{
"context": "user",
"filename": "",
"arguments": "",
"s3LogEnabled": true
}
],
"waitingTime": 30
}
}
```
Anda dapat menggunakan parameter berikut dalam file konfigurasi skrip sesi.
***SessionStart/SessionTermination ***
Skrip sesi untuk dijalankan dalam acara sesi yang sesuai berdasarkan nama objek.
**Tipe**: String
**Wajib**: Tidak
**Nilai yang diizinkan:****SessionStart**, **SessionTermination**
***WaitingTime***
Durasi maksimum skrip sesi dalam hitungan detik.
**Tipe**: Integer
**Wajib**: Tidak
**Kendala:** Durasi maksimum adalah 60 detik. Jika skrip sesi tidak selesai dalam durasi ini, skrip tersebut akan dihentikan. Jika Anda memerlukan skrip untuk terus berjalan, luncurkan sebagai proses terpisah.
***Executables***
Detail untuk menjalankan skrip sesi.
**Tipe**: String
**Wajib**: Ya
**Kendala:** Jumlah maksimum skrip yang dapat dijalankan per acara sesi adalah 2 (satu untuk konteks pengguna, satu untuk konteks sistem).
***Context***
Konteks di mana untuk menjalankan skrip sesi.
**Tipe**: String
**Wajib**: Ya
**Nilai yang diizinkan:****user**, **system**
***Filename***
Jalur lengkap ke skrip sesi untuk dijalankan. Jika parameter ini tidak ditentukan, skrip sesi tidak dijalankan.
**Tipe**: String
**Wajib**: Tidak
**Kendala:** Panjang maksimum untuk nama file dan jalur lengkap adalah 1.000 karakter.
**Nilai yang diizinkan:****.bat**,**.exe**, **.sh**
Anda juga dapat menggunakan PowerShell file Windows. Untuk informasi selengkapnya, lihat [Menggunakan PowerShell File Windows](using-powershell-files-with-session-scripts.md).
***Arguments***
Argumen untuk skrip sesi Anda atau file yang dapat dieksekusi.
**Tipe**: String
**Wajib**: Tidak
**Kendala panjang:** Panjang maksimum adalah 1.000 karakter.
***S3LogEnabled***
Ketika nilai untuk parameter ini disetel ke**True**, bucket S3 dibuat dalam akun Amazon Web Services Anda untuk menyimpan log yang dibuat oleh skrip sesi. Secara default, nilai ini diatur ke **True**. Untuk informasi selengkapnya, lihat bagian *Keluaran Skrip Sesi Pencatatan* nanti dalam topik ini.
**Tipe**: Boolean
**Wajib**: Tidak
**Nilai yang diizinkan:****True**, **False**
# Menggunakan PowerShell File Windows
Untuk menggunakan PowerShell file Windows, tentukan jalur lengkap ke PowerShell file dalam **filename** parameter:
```
"filename":
"C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe",
```
Kemudian tentukan skrip sesi Anda di **arguments** parameter:
```
"arguments": "-File \"C:\\path\\to\\session\\script.ps1\"",
```
Terakhir, verifikasi bahwa Kebijakan PowerShell Eksekusi memungkinkan PowerShell file Anda berjalan.
# Keluaran Skrip Sesi Pencatatan
Ketika opsi ini diaktifkan dalam file konfigurasi, WorkSpaces Aplikasi secara otomatis menangkap output dari skrip sesi yang ditulis ke standar keluar. Output ini diunggah ke bucket Amazon S3 di akun Anda. Anda dapat meninjau file log untuk tujuan pemecahan masalah atau debugging.
**catatan**
File log diunggah saat skrip sesi mengembalikan nilai, atau nilai yang ditetapkan **WaitingTime** telah berlalu, mana yang lebih dulu.
# Gunakan Konektor Penyimpanan dengan Skrip Sesi
Saat konektor penyimpanan WorkSpaces Aplikasi diaktifkan, konektor mulai dipasang saat skrip mulai sesi berjalan. Jika skrip Anda bergantung pada konektor penyimpanan yang dipasang, Anda dapat menunggu konektor tersedia. WorkSpaces Aplikasi mempertahankan status pemasangan konektor penyimpanan di registri Windows pada instance Windows, pada tombol berikut:
HKEY\$1LOCAL\$1MACHINE\$1 PERANGKAT LUNAK\$1 Amazon\$1\$1 Penyimpanan\$1\$1 AppStream
Nilai kunci registri adalah sebagai berikut:
+ Nama pengguna yang disediakan — ID pengguna yang disediakan melalui mode akses. Mode akses dan nilai untuk setiap mode adalah sebagai berikut:
+ User Pool — Alamat email untuk pengguna
+ URL Streaming — UserID
+ SAMP — NameID. Jika nama pengguna menyertakan garis miring (misalnya, SAMAccount Nama pengguna domain), garis miring diganti dengan karakter “-”.
+ Konektor penyimpanan — Konektor untuk opsi penyimpanan persisten yang diaktifkan untuk pengguna. Nilai konektor penyimpanan adalah sebagai berikut:
+ HomeFolder
+ GoogleDrive
+ OneDrive
Setiap kunci registri konektor penyimpanan berisi nilai **MountStatus**DWORD. Tabel berikut mencantumkan nilai yang mungkin untuk **MountStatus**.
**catatan**
Untuk melihat kunci registri ini, Anda harus memiliki Microsoft .NET Framework versi 4.7.2 atau yang lebih baru diinstal pada gambar Anda.
| Nilai | Deskripsi |
| --- | --- |
| 0 | Konektor penyimpanan tidak diaktifkan untuk pengguna ini |
| 1 | Pemasangan konektor penyimpanan sedang berlangsung |
| 2 | Konektor penyimpanan berhasil dipasang |
| 3 | Pemasangan konektor penyimpanan gagal |
| 4 | Pemasangan konektor penyimpanan diaktifkan, tetapi belum dipasang |
Pada instance Linux, Anda dapat memeriksa status pemasangan folder rumah dengan melihat nilai appstream\$1home\$1folder\$1mount\$1status dalam file \$1/. config/appstream-home-folder/appstream-home-folder-mount-status.
| Nilai | Deskripsi |
| --- | --- |
| True | Folder rumah berhasil dipasang |
| False | Folder rumah belum terpasang |
# Aktifkan Penyimpanan Bucket Amazon S3 untuk Log Skrip Sesi
Saat Anda mengaktifkan pencatatan Amazon S3 dalam konfigurasi skrip sesi, WorkSpaces Aplikasi menangkap output standar dari skrip sesi Anda. Output diunggah secara berkala ke bucket S3 dalam akun Amazon Web Services Anda. Untuk setiap AWS Wilayah, WorkSpaces Aplikasi membuat bucket di akun Anda yang unik untuk akun Anda dan Wilayah.
Anda tidak perlu melakukan tugas konfigurasi apa pun untuk mengelola bucket S3 ini. Mereka sepenuhnya dikelola oleh layanan WorkSpaces Aplikasi. File log yang disimpan di setiap bucket dienkripsi saat transit menggunakan titik akhir SSL Amazon S3 dan diam menggunakan kunci enkripsi yang dikelola Amazon S3. Ember diberi nama dalam format tertentu sebagai berikut:
```
appstream-logs-region-code-account-id-without-hyphens-random-identifier
```
***region-code***
Ini adalah kode AWS Wilayah tempat tumpukan dibuat dengan penyimpanan bucket Amazon S3 yang diaktifkan untuk log skrip sesi.
***account-id-without-hyphens***
Pengenal akun Amazon Web Services Anda. ID acak memastikan bahwa tidak ada konflik dengan bucket lain di Wilayah itu. Bagian pertama dari nama bucket,`appstream-logs`, tidak berubah di seluruh akun atau Wilayah.
Misalnya, jika Anda menentukan skrip sesi dalam gambar di Wilayah AS Barat (Oregon) (us-west-2) pada nomor akun 123456789012, Aplikasi akan WorkSpaces membuat bucket Amazon S3 dalam akun Anda di Wilayah tersebut dengan nama yang ditampilkan. Hanya administrator dengan izin yang cukup yang dapat menghapus bucket ini.
```
appstream-logs-us-west-2-1234567890123-abcdefg
```
Menonaktifkan skrip sesi tidak menghapus file log apa pun yang disimpan di bucket S3. Untuk menghapus file log secara permanen, Anda atau administrator lain dengan izin yang memadai harus melakukannya dengan menggunakan konsol Amazon S3 atau API. WorkSpaces Aplikasi menambahkan kebijakan bucket yang mencegah penghapusan bucket secara tidak sengaja. Untuk informasi selengkapnya, lihat *Kebijakan IAM dan Bucket Amazon S3 untuk Ketekunan Setelan Aplikasi* di. [Identity and Access Management untuk WorkSpaces Aplikasi Amazon](controlling-access.md)
Saat skrip sesi diaktifkan, folder unik dibuat untuk setiap sesi streaming yang dimulai.
Jalur untuk folder tempat file log disimpan di bucket S3 di akun Anda menggunakan struktur berikut:
```
bucket-name/stack-name/fleet-name/access-mode/user-id-SHA-256-hash/session-id/SessionScriptsLogs/session-event
```
***bucket-name***
Nama bucket S3 tempat skrip sesi disimpan. Format nama dijelaskan sebelumnya di bagian ini.
***stack-name***
Nama tumpukan sesi berasal.
***fleet-name***
Nama armada tempat skrip sesi berjalan.
***access-mode***
Metode identitas pengguna: `custom` untuk WorkSpaces Applications API atau CLI, `federated` untuk SALL, dan `userpool` untuk pengguna di kumpulan pengguna.
***user-id-SHA-256-hash***
Nama folder khusus pengguna. Nama ini dibuat menggunakan string heksadesimal hash SHA-256 huruf kecil yang dihasilkan dari pengenal pengguna.
***session-id***
Pengidentifikasi sesi streaming pengguna. Setiap sesi streaming pengguna menghasilkan ID unik.
***session-event***
Peristiwa yang menghasilkan log skrip sesi. Nilai-nilai acara adalah: `SessionStart` dan`SessionTermination`.
Struktur folder contoh berikut berlaku untuk sesi streaming yang dimulai dari test-stack dan test-fleet. Sesi ini menggunakan API ID pengguna`testuser@mydomain.com`, dari Akun AWS ID dari`123456789012`, dan grup pengaturan `test-stack` di Wilayah AS Barat (Oregon) (us-west-2):
```
appstream-logs-us-west-2-1234567890123-abcdefg/test-stack/test-fleet/custom/a0bcb1da11f480d9b5b3e90f91243143eac04cfccfbdc777e740fab628a1cd13/05yd1391-4805-3da6-f498-76f5x6746016/SessionScriptsLogs/SessionStart/
```
Struktur folder contoh ini berisi satu file log untuk skrip awal sesi konteks pengguna, dan satu file log untuk skrip awal sesi konteks sistem, jika berlaku.
# Gunakan Skrip Sesi pada Armada Multi-Sesi
Saat menggunakan skrip sesi pada armada multi-sesi, ada persyaratan dan pertimbangan tambahan untuk memastikan kinerja dan keamanan yang optimal.
## Persyaratan
Pada armada satu sesi, untuk contoh tertentu, **SessionStart**dan **SessionTermination**kait dijamin hanya berjalan satu kali. Ini karena ada pemetaan sesi 1:1 ke instance. Saat menggunakan armada multi-sesi, ada pemetaan sesi N:M ke instance, di mana setiap sesi berjalan sendiri dan mengaitkannya. **SessionStart**SessionTermination**** Ini berarti bahwa **SessionStart**dan **SessionTermination**kait dapat dijalankan berkali-kali pada contoh tertentu, dan dalam banyak urutan yang berbeda. Untuk pengalaman terbaik, berikut ini harus berlaku untuk skrip sesi Anda saat digunakan pada armada multi-sesi:
+ Skrip adalah idempoten.
Ketika suatu tindakan telah dilakukan, skrip harus menangani lebih dari satu eksekusi pada instance yang sama dengan penanganan yang anggun.
+ Skrip bersifat independen.
Karena skrip berjalan per sesi, jika satu sesi berjalan **SessionTermination**sementara yang lain sedang berjalan **SessionStart**, mereka tidak boleh saling mengganggu, atau dengan pengalaman sesi lainnya.
+ Skrip berkinerja.
Pada instance multi-sesi, beberapa sesi dapat disediakan secara bersamaan. Ini berarti bahwa mungkin ada beberapa eksekusi bersamaan dari skrip sesi. Skrip harus efisien, tidak mengkonsumsi sumber daya yang berlebihan, dan tidak memengaruhi pengalaman pengguna lain pada instance atau stabilitas sesi.
Banyak dari persyaratan ini dapat dipenuhi dengan menjaga logika skrip sesi terfokus pada sesi pengguna tertentu yang menjalankan skrip.
## Pertimbangan Keamanan
WorkSpaces Gambar aplikasi tidak boleh dikonfigurasi untuk memungkinkan izin menulis ke file skrip sesi oleh pengguna mana pun. Ini memperkenalkan vektor serangan kritis untuk pengguna jahat, di mana mereka dapat memodifikasi file skrip. File-file ini kemudian dapat dijalankan sebagai SYSTEM atau pengguna lain, tergantung pada konfigurasi Anda.
**penting**
Adalah tanggung jawab Anda untuk memastikan bahwa gambar WorkSpaces Aplikasi Anda dikonfigurasi dengan aman. Ini sangat penting untuk instance multi-sesi, di mana banyak pengguna menggunakan instance yang sama. Jika gambar tidak dikonfigurasi dengan aman, ada risiko keamanan untuk semua pengguna instance tersebut.
Berikut ini harus benar dari gambar dan file skrip sesi Anda:
+ Pengguna tidak memiliki izin untuk memodifikasi file skrip sesi.
+ Pengguna tidak memiliki izin untuk memodifikasi skrip sesi config.json. Perilaku default pada gambar membatasi akses ke administrator.
Skrip sesi yang dapat dieksekusi harus disimpan di lokasi yang aman di mana mereka aman dari modifikasi saat runtime.
Jika layanan mendeteksi bahwa skrip sesi yang dapat dieksekusi telah dimodifikasi, itu akan gagal setiap eksekusi berikutnya dari hook itu pada instance itu, unggah file log ke Amazon S3 (jika pencatatan Amazon S3 diaktifkan), dan Anda akan melihat pesan berikut:
**Skrip sesi tidak dijalankan karena executable dimodifikasi setelah penyediaan instance. Eksekusi dilewati untuk keamanan.**
Jika kasus penggunaan Anda memerlukan modifikasi skrip sesi yang dapat dieksekusi pada waktu berjalan (misalnya, jika Anda menunjuk ke file EXE yang dimodifikasi oleh proses pembaruan otomatis saat runtime), ini akan gagal dalam pemeriksaan di atas. Dalam hal ini, gunakan skrip untuk mengarahkan eksekusi ke executable yang dimodifikasi. Biarkan skrip tidak dimodifikasi saat runtime saat layanan melakukan pemeriksaan keamanan.
Jika file skrip sesi Anda terlalu besar (lebih dari 100 MB), ini dapat menyebabkan penundaan dalam penyediaan instance dan sesi, dan pemeriksaan keamanan akan memakan waktu tambahan (tergantung pada jenis instans dan sumber daya yang tersedia). Jika kasus penggunaan Anda memerlukan skrip sesi besar, pertimbangkan untuk menggunakan skrip yang lebih kecil untuk mengarahkan eksekusi. Ini akan meningkatkan pengalaman penyediaan instance dan sesi.
Perhatikan bahwa layanan hanya memeriksa executable yang ditentukan dalam skrip sesi config.json, dan ini hanya mekanisme upaya. fallback/best Adalah tanggung jawab Anda untuk memastikan bahwa semua jalur kode dalam skrip sesi yang dapat dieksekusi aman dan tidak dapat dimodifikasi oleh pengguna akhir.