

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Buat Gambar Berbasis Linux Anda
<a name="create-linux-based-images"></a>

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
<a name="create-default-app-settings"></a>

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
<a name="app-settings-image-install"></a>

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
<a name="app-settings-template-user"></a>

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
<a name="app-settings-image-create-default-app-settings"></a>

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
<a name="app-settings-image-save-default-app-settings"></a>

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)
<a name="app-settings-image-test-applications"></a>

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
<a name="app-settings-image-finish"></a>

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
<a name="create-default-variables-linux"></a>

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
<a name="optimize-launch-performance"></a>

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/<y*our-app*>-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
<a name="create-session-scripts"></a>

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
<a name="image-assistant-cli"></a>

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
<a name="webcam-support"></a>

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
<a name="heavy-file-sync"></a>

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
<a name="tutorial-create-linux-image"></a>

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
<a name="tutorial-linux-image-install"></a>

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
<a name="tutorial-linux-image-manifest"></a>

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
<a name="tutorial-linux-image-catalog"></a>

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
<a name="tutorial-linux-image-create-default-app-settings"></a>

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
<a name="tutorial-linux-image-test-applications"></a>

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
<a name="tutorial-linux-image-finish-create-image"></a>

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
<a name="tutorial-linux-image-tag-copy"></a>

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
<a name="tutorial-linux-image-finish"></a>

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
<a name="enable-japanese-support-linux"></a>

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
<a name="tutorial-japanese-font"></a>

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
<a name="tutorial-japanese-zone"></a>

Untuk mengatur zona waktu sistem, jalankan perintah berikut:

**sudo timedatectl set-timezone "Asia/Tokyo"**

## Langkah 3: Atur Sistem Lokal dan Bahasa Tampilan
<a name="tutorial-japanese-locale"></a>

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
<a name="tutorial-japanese-input"></a>

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 "['<Control>space']"
   gsettings set org.gnome.desktop.wm.keybindings switch-input-source-backward "['<Shift><Control>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
<a name="tutorial-japense-keyboard"></a>

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
<a name="tutorial-japense-verify"></a>

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
<a name="tutorial-japanese-create"></a>

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.