Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# 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/"
}
]
```