Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Blok Aplikasi Kustom
Instans streaming armada elastis menggunakan aplikasi yang diinstal pada file hard disk virtual (VHD) yang disimpan dalam bucket Amazon S3 di akun Anda. Blok aplikasi dengan kemasan khusus memberi Anda fleksibilitas untuk membuat file VHD Anda sendiri, dan mengunggahnya ke bucket Amazon S3 di dalam akun Anda.
**Topics**
+ [Buat VHD](create-vhd.md)
+ [Buat Skrip Pengaturan untuk VHD di Aplikasi Amazon WorkSpaces](create-setup-script.md)
+ [Membuat Blok Aplikasi Kustom](create-app-block.md)
+ [Perbarui App Block, VHD, dan Setup Script](update-app-block.md)
# Buat VHD
VHD adalah file tunggal yang ketika dipasang ke sistem operasi diperlakukan seperti hard disk. VHD dapat dipasang sebagai huruf drive, ke jalur folder, atau keduanya. Ketika VHD dipasang, Anda dapat memperlakukannya seperti halnya hard disk lainnya, termasuk menginstal aplikasi Anda atau menyalin file ke sana yang dibutuhkan pengguna Anda.
Untuk membuat blok aplikasi, Anda harus membuat VHD, menginstal aplikasi Anda ke sana, lalu melepaskannya. Setelah terlepas, Anda dapat menguji VHD Anda di PC lain, instans EC2, atau pembuat gambar WorkSpaces Aplikasi untuk memvalidasi aplikasi berfungsi seperti yang diharapkan. Setelah selesai, unggah ke bucket Amazon S3 di akun Anda dan buat blok aplikasi.
**catatan**
Halaman ini menjelaskan penggunaan VHD untuk mengirimkan aplikasi Anda; Namun, instance streaming WorkSpaces Aplikasi akan mengunduh objek apa pun dari Amazon S3. Objek yang Anda simpan di Amazon S3 juga dapat berupa file zip, penginstal aplikasi, atau aplikasi yang dapat dieksekusi itu sendiri. Anda dapat menggunakan skrip pengaturan untuk mengonfigurasinya dengan benar pada instance streaming sebelum pengguna meluncurkan aplikasinya.
Instans streaming WorkSpaces Aplikasi menunggu hingga 120 detik untuk VHD menyelesaikan pengunduhan sebelum skrip pengaturan berjalan. Jika VHD tidak menyelesaikan pengunduhan dalam durasi ini, unduhan berhenti, dan skrip pengaturan tidak akan berjalan.
Kami merekomendasikan ukuran maksimum 1, 5 gigabyte untuk VHD. Anda mungkin dapat mengurangi ukuran VHD dengan mengompresi. Anda harus menggunakan skrip pengaturan untuk mendekompresnya sebelum memasangnya, karena file harus diunduh sepenuhnya dari Amazon S3 sebelum dapat dipasang dan aplikasi diluncurkan. Lebih besar VHDs meningkatkan waktu yang dibutuhkan aplikasi untuk diluncurkan dan sesi streaming dimulai.
**Untuk membuat VHD untuk Microsoft Windows**
1. Dari PC Windows atau Windows Amazon Elastic Compute Cloud (Amazon EC2) instance, buka prompt perintah dengan hak administratif.
1. Luncurkan **diskpart** utilitas Microsoft dengan memasukkan perintah berikut:
**diskpart**
1. Buat file VHD yang tidak diformat dan tidak diinisialisasi dengan memasukkan perintah berikut, di mana ** ukuran file VHD, dalam MB:
**create vdisk file=C:\$1path\$1to\$1new\$1file.vhdx maximum=** type=expandable **
1. Pilih VHD yang baru dibuat dengan memasukkan perintah berikut:
**select vdisk file=C:\$1path\$1to\$1new\$1file.vhdx**
1. Lampirkan VHD yang baru dibuat dengan memasukkan perintah berikut:
**attach vdisk**
1. Inisialisasi VHD yang baru dibuat dengan memasukkan perintah berikut:
**convert mbr**
1. Buat partisi utama yang mencakup seluruh VHD dengan memasukkan perintah berikut:
**create partition primary**
1. Format partisi yang baru dibuat dengan memasukkan perintah berikut:
**format fs=ntfs quick**
1. Anda dapat memasang VHD yang baru dibuat ke huruf drive yang tidak digunakan, jalur folder pada volume root, atau keduanya.
Untuk memasang huruf drive, masukkan: **assign letter=****
Untuk memasang folder, masukkan: **assign mount=*C:\$1path\$1to\$1empty\$1folder\$1to\$1mount\$1***
**catatan**
Untuk me-mount ke jalur folder, folder harus sudah ada dan harus kosong.
1. Anda sekarang dapat menginstal aplikasi Anda ke VHD, menggunakan huruf drive atau jalur pemasangan folder yang dipilih pada langkah 9.
Setelah Anda selesai menginstal aplikasi Anda ke VHD, Anda harus melepaskannya sebelum Anda dapat mengunggahnya dengan aman ke bucket Amazon S3.
**Untuk melepaskan VHD untuk Microsoft Windows**
1. Luncurkan utilitas Microsoft diskpart dengan memasukkan perintah berikut:
**diskpart**
1. Pilih VHD dengan memasukkan perintah berikut:
**select vdisk file=*C:\$1path\$1to\$1new\$1file.vhdx***
1. Lepaskan VHD dengan memasukkan perintah berikut:
**detach vdisk**
1. VHD sekarang telah terlepas, dan dapat diuji pada PC Windows lain, instans Amazon EC2, atau pembuat WorkSpaces gambar Aplikasi.
**Untuk membuat VHD untuk Linux**
1. Buka terminal:
+ Untuk Amazon Linux 2: Gunakan instans EC2, pembuat gambar WorkSpaces Aplikasi, atau WorkSpaces didukung oleh Amazon Linux 2
+ Untuk Ubuntu Pro 24.04 LTS: Gunakan instans EC2, atau WorkSpaces didukung oleh Ubuntu Pro
1. Buat file VHD yang belum diformat dan tidak diinisialisasi:
**dd if=/dev/zero of=** bs=** count=1**
1. Tambahkan sistem file ke VHD yang dibuat dengan memasukkan perintah berikut:
**sudo mkfs -t ext4 ****
**catatan**
Anda mungkin melihat pesan yang menyatakan bahwa file tersebut bukan perangkat khusus blok. Anda dapat memilih untuk melanjutkan pula.
1. Buat folder kosong yang akan digunakan untuk titik pemasangan dengan memasukkan perintah berikut:
**sudo mkdir */path/to/mount/point***
1. Pasang VHD yang baru dibuat ke jalur sistem file dengan menjalankan perintah berikut:
**sudo mount -t auto -o loop ** */path/to/mount/point***
1. Anda sekarang dapat menginstal aplikasi Anda ke VHD menggunakan jalur pemasangan folder yang dipilih pada langkah 4.
**catatan**
Izin default untuk file dan folder yang dibuat pada VHD dapat mencegah pengguna non-administrator meluncurkan aplikasi atau membaca file. Validasi izin dan ubah, jika perlu.
Setelah Anda selesai menginstal aplikasi Anda ke VHD, Anda harus melepaskannya sebelum Anda dapat mengunggahnya dengan aman ke bucket Amazon S3.
**Untuk melepaskan VHD untuk Linux**
1. Buka sesi terminal, dan masukkan perintah berikut:
**sudo umount */path/to/mount/point***
1. VHD sekarang telah terlepas, dan dapat diuji pada instans Amazon Linux 2/Ubuntu Pro 24.04 LTS Amazon EC2 lainnya, pembuat gambar Amazon Linux 2 WorkSpaces Applications, atau Amazon Linux 2/Ubuntu Personal. WorkSpaces
# Buat Skrip Pengaturan untuk VHD di Aplikasi Amazon WorkSpaces
WorkSpaces Aplikasi menggunakan skrip pengaturan yang Anda berikan untuk me-mount VHD sebelum aplikasi diluncurkan. Anda juga dapat menggunakan skrip pengaturan untuk menyelesaikan tugas lain yang diperlukan untuk membuat aplikasi Anda berfungsi. Misalnya, Anda dapat mengonfigurasi kunci registri, mendaftar DLLs, mengelola prasyarat, atau memodifikasi profil pengguna dari skrip pengaturan. WorkSpaces Aplikasi menyediakan contoh skrip yang dapat Anda gunakan untuk me-mount VHD Anda. Anda perlu memodifikasi skrip ini untuk kebutuhan VHD dan aplikasi Anda.
**catatan**
Skrip penyiapan tidak diperlukan untuk blok aplikasi dengan kemasan WorkSpaces Aplikasi. Namun, Anda dapat memberikan skrip pasca-pengaturan opsional untuk menyesuaikan instalasi aplikasi.
Gunakan tautan berikut untuk mengunduh skrip contoh:
+ [Skrip bash Ubuntu Pro 24.04 LTS dan Amazon Linux 2](samples/Linux-mount-vhd-script2.zip)
+ [Skrip Microsoft Windows Powershell](samples/Windows-mount-vhd-script3.zip)
**catatan**
WorkSpaces Aplikasi dan sistem operasi Microsoft Windows mencadangkan huruf drive A hingga E. Jangan memasang VHDs atau berbagi jaringan ke huruf drive ini.
WorkSpaces Aplikasi mengunduh skrip pengaturan dan VHD ke direktori pada instance streaming armada, lalu menjalankan skrip pengaturan. Skrip pengaturan berjalan pada sistem operasi dengan hak administrator penuh. Skrip pengaturan berjalan dalam `SYSTEM` konteks pada Microsoft Windows, dan sebagai `root` pengguna di Amazon Linux 2 atau Ubuntu Pro 24.04 LTS.
Lokasi sistem file untuk VHD dan skrip pengaturan:
+ Ubuntu Pro 24.04 LTS:
`/opt/appstream/AppBlocks/appblock-name/`
**`appblock-name` **
Nama blok aplikasi yang sesuai dengan skrip VHD dan pengaturan.
+ Amazon Linux 2:
`/opt/appstream/AppBlocks/appblock-name/`
**`appblock-name` **
Nama blok aplikasi yang sesuai dengan skrip VHD dan pengaturan.
+ Microsoft Windows:
`C:\AppStream\AppBlocks\appblock-name\`
**`appblock-name` **
Nama blok aplikasi yang sesuai dengan skrip VHD dan pengaturan.
WorkSpaces Aplikasi mempertahankan nama file seperti pada objek. Misalnya, jika blok aplikasi Anda diberi nama`MyApps`, dengan nama VHD `apps.vhd` dan skrip penyiapan bernama`mount-apps.ps1`, maka jalur lengkap pada instance streaming Windows adalah:
+ VHD
`C:\AppStream\AppBlocks\MyApps\apps.vhd`
+ Skrip pengaturan
`C:\AppStream\AppBlocks\MyApps\mount-apps.ps1`
WorkSpaces Aplikasi menangkap kesalahan standar dan output standar dari skrip penyiapan Anda saat dijalankan pada instance streaming armada dan mengunggah output ke bucket Amazon S3 di dalam akun Anda. Anda dapat menggunakan log ini untuk mengidentifikasi dan menyelesaikan masalah yang mungkin Anda miliki dengan skrip penyiapan Anda. 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 di mana armada elastis dibuat di dalamnya.
**`account-id-without-hyphens` **
Pengenal AWS akun 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 membuat armada elastis di Wilayah AS Barat (Oregon) (us-west-2) pada nomor akun 123456789012 WorkSpaces , Aplikasi 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
```
Jalur untuk folder tempat file log disimpan di bucket S3 di akun Anda menggunakan struktur berikut:
```
bucket-name/fleet-name/instance-id/appblock-name/
```
**`bucket-name` **
Nama bucket Amazon S3 tempat log skrip penyiapan disimpan. Format nama dijelaskan sebelumnya di bagian ini.
**`Instance-id` **
Pengidentifikasi unik untuk instance streaming tempat skrip penyiapan dijalankan
**`appblock-name` **
Nama appblock yang sesuai dengan skrip pengaturan.
Struktur folder contoh berikut berlaku untuk sesi streaming dimulai dari`test-fleet`. Sesi ini berasal dari Akun AWS ID 123456789012, dan nama appblock adalah testappblock di Wilayah AS Barat (Oregon) (us-west-2):
`appstream-logs-us-west-2-1234567890123-abcdefg/test-fleet/i-084427ab4a1cff7f5/testappblock/`
Struktur folder contoh ini berisi satu file log untuk output standar, dan satu file log untuk kesalahan standar.
**Topics**
+ [Eksekusi skrip penyiapan blok aplikasi di WorkSpaces Aplikasi Amazon](script-execution.md)
# Eksekusi skrip penyiapan blok aplikasi di WorkSpaces Aplikasi Amazon
Diagram berikut menunjukkan di mana dalam proses skrip penyiapan berjalan. Urutan run tergantung pada apakah Persistensi Pengaturan Aplikasi diaktifkan pada tumpukan yang terkait dengan armada elastis.
**catatan**
WorkSpaces Aplikasi menggunakan detail VPC Anda untuk mengunduh skrip VHD dan pengaturan dari bucket Amazon S3. 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).
Pengaturan Aplikasi Persistensi diaktifkan:
![\[Pengaturan Aplikasi Persistensi diaktifkan.\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/images/app-settings-enabled.png)
Pengaturan Aplikasi Persistensi dinonaktifkan:
![\[Pengaturan Aplikasi Persistensi dinonaktifkan.\]](http://docs.aws.amazon.com/id_id/appstream2/latest/developerguide/images/app-settings-disabled.png)
# Membuat Blok Aplikasi Kustom
Anda dapat menggunakan konsol WorkSpaces Aplikasi untuk membuat sumber daya blok aplikasi setelah VHD dan skrip penyiapan dibuat dan diunggah ke bucket S3 di dalamnya. Akun AWS Untuk mempelajari selengkapnya tentang menyimpan VHD dan skrip penyiapan di bucket Amazon S3, lihat. [Simpan Ikon Aplikasi, Skrip Pengaturan, Skrip Sesi, dan VHD dalam Bucket S3](store-s3-bucket.md)
**catatan**
Anda harus memiliki izin IAM untuk melakukan `S3:GetObject` tindakan pada VHD dan mengatur objek skrip di bucket Amazon S3 untuk membuat sumber daya blok aplikasi.
**Untuk membuat sumber daya blok aplikasi**
1. Buka konsol WorkSpaces Applications di [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).
1. Dari menu navigasi sebelah kiri, pilih **Aplikasi, Blok aplikasi****, dan Buat blok** **aplikasi**.
1. Untuk kemasan blok aplikasi, pilih **Kustom**.
1. Untuk **detail pemblokiran Aplikasi**, ketik pengenal nama unik untuk blok aplikasi. Anda juga dapat menentukan pilihan berikut:
+ **Nama tampilan** - Nama yang ramah untuk blok aplikasi.
+ **Deskripsi** — Deskripsi untuk blok aplikasi.
1. Untuk **objek hard disk virtual di S3** di bawah **pengaturan Script**, masukkan URI S3 yang mewakili objek VHD, atau pilih **Browse S3 untuk menavigasi ke bucket S3** Anda dan menemukan objek VHD.
1. Untuk **objek skrip Setup di S3** di bawah **Pengaturan skrip**, masukkan URI S3 yang mewakili objek skrip pengaturan, atau pilih **Browse S3** untuk menavigasi ke bucket S3 Anda dan menemukan objek skrip pengaturan.
1. Untuk **skrip Pengaturan yang dapat dieksekusi** di bawah **Pengaturan skrip**, masukkan executable yang diperlukan untuk skrip pengaturan Anda.
**catatan**
Jika skrip penyiapan Anda dapat dijalankan secara langsung, masukkan nama file skrip pengaturan. Jika skrip penyiapan Anda bergantung pada executable lain (misalnya, Microsoft PowerShell) untuk mengeksekusi, masukkan path ke executable tersebut.
Jalur ke Microsoft PowerShell di Microsoft Windows:
`C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe`
1. Secara opsional, untuk **argumen yang dapat dieksekusi skrip Setup** di bawah **Pengaturan skrip**, masukkan argumen yang perlu diberikan ke skrip penyiapan yang dapat dieksekusi untuk menjalankan skrip penyiapan Anda.
**catatan**
Jika Anda menggunakan PowerShell skrip Microsoft, Anda harus menentukan parameter “-File” dengan nama skrip pengaturan Anda sebagai argumen yang dapat dieksekusi. Selain itu, pastikan bahwa Kebijakan Eksekusi memungkinkan skrip Anda dijalankan. [Untuk mempelajari lebih lanjut, lihat [About\$1Execution\$1Policies](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies?view=powershell-7.2) dan Apa itu? PowerShell](https://docs.microsoft.com/en-us/powershell/scripting/overview?view=powershell-7.2) .
1. Untuk **Durasi eksekusi dalam hitungan detik** di bawah **Pengaturan skrip**, masukkan durasi batas waktu untuk skrip penyiapan Anda.
**catatan**
Durasi eksekusi dalam hitungan detik adalah berapa lama WorkSpaces Aplikasi menunggu skrip penyiapan berjalan sebelum melanjutkan. Jika skrip penyiapan Anda tidak selesai dalam durasi ini, kesalahan akan ditampilkan kepada pengguna Anda dan aplikasi akan mencoba untuk meluncurkan. Skrip pengaturan dihentikan setelah durasi eksekusi telah berlalu.
1. (Opsional) Untuk **Tag**, buat tag untuk sumber daya blok aplikasi
1. Tinjau informasi yang Anda masukkan, dan pilih **Buat**.
1. Jika blok aplikasi berhasil dibuat, Anda akan melihat pesan sukses di bagian atas konsol. Jika terjadi kesalahan, Anda akan melihat pesan kesalahan deskriptif dan perlu mencoba membuat blok aplikasi lagi.
# Perbarui App Block, VHD, dan Setup Script
Sumber daya blok aplikasi tidak dapat diubah dan tidak memungkinkan Anda mengubahnya setelah dibuat. Jika Anda perlu membuat pembaruan yang kompatibel ke belakang ke VHD atau skrip pengaturan, Anda disarankan untuk mengunggah versi baru file ke bucket Amazon S3, menimpa versi saat ini. Sesi streaming armada Elastic baru akan mengunduh versi terbaru dari objek, dan menggunakannya.
Jika Anda perlu membuat pembaruan mundur yang tidak kompatibel ke VHD atau skrip penyiapan, Anda disarankan untuk mengunggahnya sebagai objek baru ke bucket Amazon S3, dan membuat blok aplikasi dan sumber daya aplikasi baru. Anda kemudian dapat mengelola penyebaran ke pengguna Anda sebagai bagian dari jendela perubahan atau pemadaman lainnya.