

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Creazione delle immagini basate su Linux
<a name="create-linux-based-images"></a>

Puoi creare immagini WorkSpaces Amazon Applications basate su Linux connettendoti a un generatore di immagini Linux, installando le applicazioni necessarie, creando impostazioni applicative e variabili di ambiente predefinite e utilizzando uno strumento di interfaccia a riga di comando (CLI) o uno strumento Image Assistant (GUI) per aggiungere queste applicazioni al catalogo delle applicazioni. Per aprire lo strumento GUI, cerca **Image Assistant** nell'elenco delle applicazioni.

**Topics**
+ [Creazione di impostazioni predefinite delle applicazioni per gli utenti](create-default-app-settings.md)
+ [Creazione di variabili di ambiente predefinite per gli utenti Linux](create-default-variables-linux.md)
+ [Ottimizzazione delle prestazioni di avvio delle applicazioni Linux](optimize-launch-performance.md)
+ [Creazione di script di sessione](create-session-scripts.md)
+ [Utilizzo dello strumento CLI di Image Assistant per Linux](image-assistant-cli.md)
+ [Abilitazione e disattivazione del supporto per webcam](webcam-support.md)
+ [Abilitazione e disabilitazione della modalità Heavy File Sync per le cartelle Home](heavy-file-sync.md)
+ [Tutorial: creazione di un'immagine personalizzata di applicazioni basate su Linux WorkSpaces](tutorial-create-linux-image.md)
+ [Tutorial: abilitare il supporto per la lingua giapponese per le immagini Linux](enable-japanese-support-linux.md)

# Creazione di impostazioni predefinite delle applicazioni per gli utenti
<a name="create-default-app-settings"></a>

Segui questi passaggi per creare impostazioni predefinite delle applicazioni per i tuoi utenti.

**Topics**
+ [Fase 1: installazione delle applicazioni sull'Image Builder](#app-settings-image-install)
+ [Fase 2: Crea un account TemplateUser](#app-settings-template-user)
+ [Fase 3: creazione di impostazioni predefinite delle applicazioni](#app-settings-image-create-default-app-settings)
+ [Fase 4: salvataggio delle impostazioni predefinite delle applicazioni](#app-settings-image-save-default-app-settings)
+ [Fase 5: Verifica delle impostazioni predefinite dell'applicazione (facoltativo)](#app-settings-image-test-applications)
+ [Passaggio 6: Pulizia](#app-settings-image-finish)

## Fase 1: installazione delle applicazioni sull'Image Builder
<a name="app-settings-image-install"></a>

In questa fase, connetti un Image Builder Linux e installi le applicazioni sull'Image Builder.

**Installare le applicazioni sull'Image Builder**

1. Connetti l'Image Builder in uno dei seguenti modi: 
   + [Utilizza la console WorkSpaces Applicazioni](managing-image-builders-connect-console.md) (solo per connessioni Web)
   + [Crea un URL di streaming](managing-image-builders-connect-streaming-URL.md) (per connessioni client Web o WorkSpaces Applicazioni)
**Nota**  
Accederai come ImageBuilderAdmin utente al desktop Amazon Linux GNOME e disporrai dei privilegi di amministratore root.

1. Installa le applicazioni necessarie. Ad esempio, per installare un browser Chromium da un repository yum pubblico, apri prima l'applicazione Terminale, quindi esegui il seguente comando:

   **[ImageBuilderAdmin]\$1 sudo yum update && sudo yum install chromium.x86\$164** 

## Fase 2: Crea un account TemplateUser
<a name="app-settings-template-user"></a>

In questo passaggio, crei un TemplateUser account, che crea le impostazioni predefinite dell'applicazione per gli utenti di streaming.

**Per creare un TemplateUser account**

1. Crea un TemplateUser account senza permessi di root. Ad esempio, in una finestra del Terminale, esegui i seguenti comandi da creare TemplateUser sul generatore di immagini:

   **[ImageBuilderAdmin]\$1 sudo useradd -m TemplateUser** 

   **[ImageBuilderAdmin]\$1 echo -e '<*password*>\$1n<*password*>\$1n' \$1 sudo passwd TemplateUser**

1. Passa all' TemplateUser account:

   **[ImageBuilderAdmin]\$1 su - TemplateUser** 

## Fase 3: creazione di impostazioni predefinite delle applicazioni
<a name="app-settings-image-create-default-app-settings"></a>

In questo passaggio, crei le impostazioni predefinite delle applicazioni per gli utenti WorkSpaces delle Applicazioni. In questo modo gli utenti possono iniziare rapidamente a usare le applicazioni durante le sessioni di streaming WorkSpaces delle Applicazioni, senza la necessità di creare o configurare queste impostazioni da soli.

**Per creare impostazioni di applicazioni e Windows predefinite per gli utenti**

1. Avvia l'applicazione per cui creare le impostazioni predefinite. Ad esempio, in una finestra del Terminale, esegui il seguente comando per avviare il browser Chromium:

    **[TemplateUser]\$1 chromium-browser**

1. Configurazione delle impostazioni delle applicazioni. Ad esempio, imposta la home page del browser Chromium come. **https://aws.amazon.com**.

1. Chiudi le applicazioni.

1. Effettua la disconnessione:

   **[TemplateUser]\$1 logout** 

## Fase 4: salvataggio delle impostazioni predefinite delle applicazioni
<a name="app-settings-image-save-default-app-settings"></a>

In questa fase, copia le impostazioni predefinite dell'applicazione che hai aggiunto alla directory **/etc/skel/** e rendile disponibili agli utenti di streaming.

**Per salvare le impostazioni predefinite delle applicazioni**
+ Per copiare le impostazioni predefinite dell'applicazione per gli utenti di streaming, esegui il seguente comando in una finestra del Terminale:

   **[ImageBuilderAdmin]\$1 sudo cp -r -f /home/TemplateUser/. /etc/skel**

## Fase 5: Verifica delle impostazioni predefinite dell'applicazione (facoltativo)
<a name="app-settings-image-test-applications"></a>

In questa fase, verifica che le applicazioni che hai aggiunto funzionino correttamente e che le impostazioni predefinite dell'applicazione funzionino come previsto. 

**Test delle applicazioni e delle impostazioni predefinite su un Image Builder**

1. Crea un utente di test senza autorizzazioni root. Ad esempio, in una finestra di **Terminale**, esegui i seguenti comandi per creare **test-user** sull'Image Builder:

   **[ImageBuilderAdmin]\$1 sudo useradd -m test-user**

   **[ImageBuilderAdmin]\$1 echo -e '*password*>\$1n<*password*>\$1n' \$1 sudo passwd test-user** 

1. Passa all'utente di test:

   **[ImageBuilderAdmin]\$1 su - test-user**

1. Avvia l'applicazione (ad esempio, Chromium) come utente di test:

   **[test-user]\$1 /usr/bin/chromium-browser** 

1. Verifica che le impostazioni predefinite siano disponibili per l'utente di test (ad esempio, la home page di Chromium è https://aws.amazon.com/).

1. Effettua la disconnessione:

   **[test-user]\$1 logout**

## Passaggio 6: Pulizia
<a name="app-settings-image-finish"></a>

Infine, l'ultima fase è quella della pulizia.

**Per eliminare**

1. Elimina: TemplateUser

   **[ImageBuilderAdmin]\$1 sudo killall -u TemplateUser**

   **[ImageBuilderAdmin]\$1 sudo userdel -r TemplateUser**

1. Elimina test-user (non richiesto se hai saltato il passaggio 5):

   **[ImageBuilderAdmin]\$1 sudo killall -u test-user**

   **ImageBuilderAdmin]\$1 sudo userdel -r test-user**

# Creazione di variabili di ambiente predefinite per gli utenti Linux
<a name="create-default-variables-linux"></a>

Puoi creare variabili di ambiente su un'istanza dell'Image Builder Linux. La creazione di variabili di ambiente le rende disponibili su istanze di streaming create da quell'immagine. 

**Nota**  
Nelle istanze Linux fleet, le variabili di ambiente impostate utilizzando lo strumento Image Assistant (GUI) e le variabili di ambiente di sistema predefinite vengono esportate tramite lo script/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 nelle applicazioni.

**Per creare variabili di ambiente per gli utenti**

1. Se la cartella `/etc/profile` non esiste, per crearla esegui il comando seguente:

   **[ImageBuilderAdmin]\$1 sudo mkdir -p /etc/profile.d** 

1. Per creare un nuovo file di script di shell (ad esempio, my-environment.sh) in questa cartella, esegui il comando seguente:

   **[ImageBuilderAdmin]\$1 vim my-environment.sh**

1. Nella prima riga del file di script, aggiungi i seguenti contenuti: 

   **\$1\$1/bin/sh **

1. Per ogni riga successiva, aggiungi un comando **export** per impostare le variabili di ambiente per l'immagine. Nell'esempio seguente viene aggiunto `$HOME/bin` alla variabile `PATH`: 

   **export PATH=”\$1HOME/bin:\$1PATH”**

1. Premi il tasto **Esc** per tornare alla modalità di comando in vim, quindi esegui il seguente comando per salvare lo script ed uscire da vim: 

   **:x**

1. Esegui il comando seguente per consentire l'esecuzione dello script come programma: 

   **[ImageBuilderAdmin]\$1 chmod \$1x my-environment.sh**

# Ottimizzazione delle prestazioni di avvio delle applicazioni Linux
<a name="optimize-launch-performance"></a>

Se utilizzi lo strumento GUI di Image Assistant, questo ottimizza automaticamente le prestazioni di avvio delle applicazioni.

Se utilizzi la CLI di Image Assistant, utilizza la procedura seguente per ottimizzare manualmente le prestazioni di avvio. Quando creano e si aggiungono file a un manifesto di ottimizzazione dell'applicazione, l'applicazione si avvia più velocemente quando viene avviata per la prima volta su una nuova istanza del parco istanze. Tuttavia, ciò aumenta anche il tempo necessario per consentire al parco istanze di essere disponibile agli utenti. Il manifesto di ottimizzazione è un file di testo delimitato da tabulazioni per ciascuna applicazione.

È possibile creare un file manifest (ad esempio < *your-app* >-manifest.txt) manualmente o seguendo i passaggi seguenti.

**Per creare un file manifest**

1. Assicurati che l'applicazione che stai cercando di ottimizzare sia avviata e in esecuzione.

1. Da un terminale dell'Image Builder di Linux, esegui il comando seguente: 

   **ps -ef \$1 grep <*application-process-name*>**

1. Cerca il numero PID più piccolo dall'output dell'ultima fase. Questo è il PID per il processo principale dell'applicazione.

1. Mantieni l'applicazione in esecuzione e assicurati di utilizzare i componenti iniziali richiesti dagli utenti. In questo modo, i componenti vengono acquisiti dal processo di ottimizzazione. 

1. Crea un file script (ad esempio, `~/getfilestool.sh`) con i seguenti contenuti:

   ```
   #!/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. Assicurati che il file possa essere eseguito con il seguente comando:

   **[ImageBuilderAdmin]\$1 chmod u\$1x \$1/getfilestool.sh**

1. Esegui il comando seguente per acquisire tutti i file in esecuzione dal processo principale individuato nella fase 3 e salvali in un file manifesto temporaneo.

   **[ImageBuilderAdmin]\$1 sudo \$1/getfilestool.sh <*root-parent-pid*> > /tmp/<y*our-app*>-manifest.txt **

1. Verifica il contenuto del manifesto di ottimizzazione, che è un file di testo delimitato da righe per ogni applicazione.

In alternativa, puoi specificare il manifesto di ottimizzazione in base all'applicazione utilizzando le operazioni dell'interfaccia della linea di comando (CLI) di Image Assistant. Per ulteriori informazioni, consulta [Utilizzo dello strumento CLI di Image Assistant per Linux](image-assistant-cli.md).

# Creazione di script di sessione
<a name="create-session-scripts"></a>

WorkSpaces Applications fornisce script di sessione su istanze di streaming basate su Windows e Linux. Per ulteriori informazioni sugli script di sessione, consulta [Usa gli script di sessione per gestire l'esperienza di streaming degli utenti di Amazon WorkSpaces Applications](use-session-scripts.md).

Gli script di sessione sono specificati all'interno di un'immagine Applications. WorkSpaces Per individuare il file di configurazione degli script di sessione su un'istanza Linux, accedi a `/opt/appstream/SessionScripts/config.json`. Il codice seguente è un file `config.json` di esempio che specifica uno script di inizio sessione denominato "`test-session-start`" e uno script di fine sessione denominato "`test-session-stop`" insieme ai relativi parametri di runtime. Assicurati che gli script a cui si fa riferimento in `config.json` dispongano delle autorizzazioni di esecuzione e che sia definito un interprete dei comandi (ad esempio, \$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
     }
}
```

# Utilizzo dello strumento CLI di Image Assistant per Linux
<a name="image-assistant-cli"></a>

Su un generatore di immagini basato su Linux, è possibile utilizzare lo strumento CLI Image Assistant **AppStreamImageAssistant**per creare e gestire l'immagine delle applicazioni. WorkSpaces Lo strumento si trova all'indirizzo `/usr/local/appstream/image-assistant/AppStreamImageAssistant` con un collegamento simbolico all'indirizzo `/bin/AppStreamImageAssistant`. Questo strumento CLI per Linux supporta molte delle stesse operazioni dello strumento CLI di Image Assistant per Windows. Per ulteriori informazioni su queste operazioni, consulta [Operazioni CLI di Image Assistant per la creazione e la gestione dell'immagine delle applicazioni Amazon WorkSpaces](cli-operations-managing-creating-image-image-assistant.md).

# Abilitazione e disattivazione del supporto per webcam
<a name="webcam-support"></a>

WorkSpaces Le applicazioni supportano audio-video (AV) in tempo reale reindirizzando l'input video della webcam locale alle sessioni di streaming delle applicazioni. WorkSpaces Questa funzionalità consente agli utenti di utilizzare la webcam locale per conferenze video e audio all'interno di una sessione di streaming delle Applicazioni. WorkSpaces Grazie all'AV in tempo reale e al supporto per l'audio in tempo reale, gli utenti possono collaborare utilizzando applicazioni di videoconferenza e audio familiari senza dover abbandonare la sessione di streaming delle WorkSpaces Applicazioni.

Per utilizzare questa funzionalità, è necessario utilizzare un'immagine WorkSpaces delle applicazioni Linux che utilizzi un agente WorkSpaces delle applicazioni Linux rilasciato il o dopo il 21 settembre 2022.

**Nota**  
L'AV in tempo reale non è supportato per le istanze stream.standard.small basate su Rocky Linux o Red Hat Enterprise Linux. Gli utenti non vedono le icone Fotocamera e Microfono sulla barra degli strumenti del client. 

La funzionalità AV in tempo reale è abilitata per impostazione predefinita per le sessioni di streaming di Linux. Per configurare le autorizzazioni della webcam per glii utenti su un Image Builder Linux, crea `/etc/appstream/appstream.conf` e aggiungi i seguenti contenuti:

**Nota**  
Specifica **1** per abilitare la webcam o **0** per disabilitarla.

```
[webcam]
permission = 1
```

# Abilitazione e disabilitazione della modalità Heavy File Sync per le cartelle Home
<a name="heavy-file-sync"></a>

È possibile abilitare le opzioni Amazon Simple Storage Service Home Folders per l'organizzazione. Quando abiliti Amazon S3 Home Folders per uno stack WorkSpaces Applications, gli utenti dello stack possono accedere a una cartella di storage persistente durante le sessioni di streaming delle applicazioni. Gli utenti non devono eseguire ulteriori configurazioni per accedere alla home directory. I dati archiviati dagli utenti nella loro cartella home vengono automaticamente sottoposti a backup in un bucket Amazon S3 nel tuo Account AWS e sono resi disponibili a tali utenti nelle sessioni successive. Per ulteriori informazioni, consulta [Abilita e amministra le cartelle Home per gli utenti delle tue applicazioni WorkSpaces](home-folders.md).

Per garantire un'esperienza fluida e risolvere alcune limitazioni esistenti, in cui potrebbe verificarsi una sincronizzazione incoerente dei file quando gli utenti salvano file di testo di grandi dimensioni dalle loro istanze di streaming nelle loro cartelle Home, gli amministratori WorkSpaces delle applicazioni possono attivare l'opzione di configurazione **heavy\$1sync** se il caricamento di file di grandi dimensioni su Amazon S3 è uno scenario utente comune durante l'utilizzo delle Applicazioni. WorkSpaces L'attivazione di questa opzione significa che potrebbe aggiungere una certa latenza al processo di sincronizzazione dei file della cartella principale, ma la completezza di tutte le sincronizzazioni con Amazon S3 è garantita.

Questa funzionalità è disponibile su tutte le immagini Red Hat Enterprise Linux e sulle immagini WorkSpaces delle applicazioni Linux che utilizzano un agente Linux WorkSpaces Applications rilasciato il o dopo il 12 settembre 2024.

La funzionalità di heavy sync è disabilitata per impostazione predefinita per le sessioni di streaming di Red Hat Enterprise Linux e Amazon Linux. Per configurare le autorizzazioni di sincronizzazione avanzata per i tuoi utenti su un generatore di immagini Red Hat Enterprise Linux o Amazon Linux, crea `/etc/appstream/appstream.conf` e aggiungi i seguenti contenuti:

**Nota**  
Specificate **1** di abilitare la sincronizzazione pesante o di **0** disabilitare la sincronizzazione pesante.

```
[storage]
heavy_sync = 1
```

# Tutorial: creazione di un'immagine personalizzata di applicazioni basate su Linux WorkSpaces
<a name="tutorial-create-linux-image"></a>

Questo tutorial descrive come creare un'immagine WorkSpaces Amazon Applications personalizzata basata su Linux che contenga applicazioni che puoi trasmettere in streaming ai tuoi utenti.

**Importante**  
Non creare un utente chiamato «as2-streaming-user» nel tuo generatore di immagini. Questo è un nome utente riservato per Fleet. Se crei questo nome utente al di fuori del flusso di lavoro delle WorkSpaces Applicazioni, potresti riscontrare problemi di streaming in Fleets.

**Topics**
+ [Fase 1: installazione delle applicazioni sull'Image Builder](#tutorial-linux-image-install)
+ [Fase 2: Generazione del file manifesto per l'ottimizzazione delle applicazioni](#tutorial-linux-image-manifest)
+ [Fase 3: Creare un catalogo di applicazioni WorkSpaces](#tutorial-linux-image-catalog)
+ [Fase 4: Creazione delle impostazioni predefinite dell'applicazione e delle variabili di ambiente](#tutorial-linux-image-create-default-app-settings)
+ [Fase 5: Test delle applicazioni e delle impostazioni](#tutorial-linux-image-test-applications)
+ [Fase 6: terminare la creazione dell'immagine](#tutorial-linux-image-finish-create-image)
+ [Fase 7 (facoltativa): applicare tag e copiare un'immagine](#tutorial-linux-image-tag-copy)
+ [Fase 8: elimina](#tutorial-linux-image-finish)

## Fase 1: installazione delle applicazioni sull'Image Builder
<a name="tutorial-linux-image-install"></a>

In questa fase, connetti un Image Builder Linux e installi le applicazioni sull'Image Builder.

**Installare le applicazioni sull'Image Builder**

1. Connetti l'Image Builder in uno dei seguenti modi: 
   + [Utilizza la console WorkSpaces Applicazioni](managing-image-builders-connect-console.md) (solo per le connessioni Web)
   + [Crea un URL di streaming](managing-image-builders-connect-streaming-URL.md) (per connessioni client Web o WorkSpaces Applicazioni)
**Nota**  
Accederai come ImageBuilderAdmin utente al desktop Amazon Linux GNOME e disporrai dei privilegi di amministratore root.

1. Installa le applicazioni necessarie. Ad esempio, per installare un browser Chromium da un repository yum pubblico, apri prima l'applicazione Terminale, quindi esegui il seguente comando:

   **[ImageBuilderAdmin]\$1 sudo yum update && sudo yum install chromium.x86\$164** 
**Nota**  
Scaricare e installare le applicazioni solo dai siti fidati.

## Fase 2: Generazione del file manifesto per l'ottimizzazione delle applicazioni
<a name="tutorial-linux-image-manifest"></a>

In questa fase, generati un file manifesto per ogni applicazione installata nella fase 1.

**Generazione di un file manifesto per ottimizzare le prestazioni di avvio di un'applicazione**

1. Assicurati che l'applicazione (ad esempio, Chromium) che stai cercando di ottimizzare sia avviata e in esecuzione.

1. In una finestra di Terminale, esegui il comando seguente per elencare i processi relativi all'applicazione:

   **[ImageBuilderAdmin]\$1 ps -ef \$1 grep chromium **

1. Trova il PID principale dall'output del comando precedente. Di seguito è riportato un esempio di output e il PID principale è 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. Mantieni l'applicazione in esecuzione e assicurati di utilizzare i componenti iniziali richiesti dagli utenti. In questo modo, i componenti vengono acquisiti dal processo di ottimizzazione. 

1. Crea un file script (ad esempio, `~/getfilestool.sh`) con i seguenti contenuti:

   ```
   #!/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. Verifica che il file possa essere eseguito eseguendo il seguente comando:

   **[ImageBuilderAdmin]\$1 chmod u\$1x \$1/getfilestool.sh** 

1. Esegui il comando seguente per acquisire tutti i file in esecuzione dal processo principale individuato nella fase 3 precedente e salvali in un file manifesto temporaneo:

   **[ImageBuilderAdmin]\$1 sudo \$1/getfilestool.sh 16712 > /tmp/chromium-manifest.txt **

1. Verifica il contenuto del manifesto di ottimizzazione, che è un file di testo delimitato da righe per ogni applicazione.

## Fase 3: Creare un catalogo di applicazioni WorkSpaces
<a name="tutorial-linux-image-catalog"></a>

In questo passaggio, si utilizza lo strumento CLI `AppStreamImageAssistant` sul generatore di immagini per creare un catalogo di WorkSpaces applicazioni delle applicazioni specificando le applicazioni per l'immagine. Per ogni applicazione per cui prevedi di effettuare lo streaming, puoi specificare il nome, il nome visualizzato, il file eseguibile da avviare e l'icona da visualizzare.

**Per creare un catalogo di applicazioni WorkSpaces Applicazioni**

1. Dal desktop dell'Image Builder, apri **Terminale** dal pannello laterale o aprendo la griglia dell'app.

1. Esegui **AppStreamImageAssistant --help** per visualizzare l'elenco dei comandi disponibili. Utilizzerai questi comandi per aggiungere applicazioni e creare un'immagine. 

1. Esegui il comando seguente per aggiungere un'applicazione installata (ad esempio, Chromium) all'elenco delle WorkSpaces applicazioni per gli utenti delle Applicazioni:

   ```
   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
   ```

   In alternativa, esegui il seguente comando:

   ```
   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. Per aggiungere altre applicazioni, ripeti la fase 3 per ogni applicazione aggiuntiva.

1. Per visualizzare l'elenco delle applicazioni che sono state aggiunte al catalogo, insieme ai metadati come i percorsi delle icone e i parametri di avvio, esegui il comando seguente:

   **AppStreamImageAssistant list-applications**

1. Per rimuovere le applicazioni dal catalogo, esegui il comando seguente:

   **AppStreamImageAssistant remove-application –-name *application\$1name***

## Fase 4: Creazione delle impostazioni predefinite dell'applicazione e delle variabili di ambiente
<a name="tutorial-linux-image-create-default-app-settings"></a>

In questo passaggio, crei le impostazioni predefinite dell'applicazione e le variabili di ambiente per gli utenti delle WorkSpaces Applicazioni. In questo modo gli utenti possono iniziare rapidamente a usare le applicazioni durante le sessioni di streaming WorkSpaces delle Applicazioni, senza la necessità di creare o configurare queste impostazioni da soli.

**Per creare applicazioni predefinite e variabili di ambiente per gli utenti**

1. Avvia l'applicazione per cui creare le impostazioni predefinite. Ad esempio, in una finestra del Terminale, esegui il seguente comando per avviare il browser Chromium:

    **[ImageBuilderAdmin]\$1 chromium-browser**

1. Configurazione delle impostazioni delle applicazioni. Ad esempio, imposta la home page del browser Chromium come. **https://aws.amazon.com**.

1. **Assicurati che l'applicazione Chromium sia chiusa, quindi esegui i seguenti comandi per copiare la configurazione di Chromium in /etc/skel:**

   **[ImageBuilderAdmin]\$1 sudo mkdir /etc/skel/.config**

   **[ImageBuilderAdmin]\$1 sudo cp -R \$1/.config/chromium /etc/skel/.config** 

1. Imposta le variabili di ambiente e aggiungile al file di script. Ad esempio, esegui i comandi seguenti:

   **[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** 

## Fase 5: Test delle applicazioni e delle impostazioni
<a name="tutorial-linux-image-test-applications"></a>

In questa fase, verifica che le applicazioni che hai aggiunto funzionino correttamente e che le impostazioni predefinite dell'applicazione e le variabili di ambiente funzionino come previsto. 

**Per testare le applicazioni e le impostazioni predefinite su un Image Builder**

1. Crea un utente di test senza autorizzazioni root. Ad esempio, in una finestra di **Terminale**, esegui i seguenti comandi per creare **test-user** sull'Image Builder:

   **[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. Passa all'utente di test:

   **[ImageBuilderAdmin]\$1 su - test-user**

1. Avvia l'applicazione (ad esempio, Chromium) come utente di test:

   **[test-user]\$1 /usr/bin/chromium-browser** 

1. Verifica che le impostazioni predefinite siano disponibili per l'utente di test (ad esempio, la home page di Chromium è/). https://aws.amazon.com

1. Verifica che le variabili di ambiente siano disponibili per l'utente di test. Ad esempio, esegui il comando seguente:

   **[test-user]\$1 echo \$1*FOO***

   Questo comando dovrebbe visualizzare nel terminale l'output ***BAR***.

1. Esegui i seguenti comandi per eliminare l'utente di test prima di creare un'immagine da questo Image Builder: 

   **\$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**

## Fase 6: terminare la creazione dell'immagine
<a name="tutorial-linux-image-finish-create-image"></a>

In questa fase, scegliere un nome dell'immagine e terminare la creazione dell'immagine. 

**Creare l'immagine**

1. In una finestra del **Terminale**, crea un'immagine dall'Image Builder eseguendo **AppStreamImageAssistant create-image**. Questa immagine contiene le applicazioni installate e registrate, oltre agli script di sessione e alle impostazioni predefinite delle applicazioni che hai configurato.

   Esegui **AppStreamImageAssistant create-image --help** per visualizzare l'elenco delle opzioni disponibili. Per ulteriori informazioni, consulta l'operazione **create-image** in [Crea l'immagine WorkSpaces delle tue applicazioni Amazon in modo programmatico utilizzando le operazioni CLI di Image Assistant](programmatically-create-image.md).

1. La sessione remota si disconnette dopo pochi istanti. Quando viene visualizzato il messaggio **Lost Connectivity (Connessione persa)**, chiudere la scheda del browser. Durante la creazione dell'immagine, lo stato dell'Image Builder viene visualizzato come **Snapshotting (Creazione di snapshot)**. Non è possibile connettersi all'Image Builder fino al termine del processo. 

1. Tornare alla console e passare a **Images (Immagini)**, **Image Registry (Registro immagine)**. Verificare che la nuova immagine venga visualizzata nell'elenco.

   Durante la creazione dell'immagine, lo stato dell'immagine nel registro immagini della console viene visualizzato come **In sospeso**. Non puoi connetterti a immagini con stato **In sospeso**. 

1. Scegli l'icona **Aggiorna** per aggiornare lo stato. Durante la creazione dell'immagine, lo stato dell'immagine viene modificata in **Available (Disponibile)** e l'Image Builder viene automaticamente arrestato.

   Per continuare la creazione di immagini, avviare l'Image Builder e connettersi dalla console o creare un nuovo Image Builder.

## Fase 7 (facoltativa): applicare tag e copiare un'immagine
<a name="tutorial-linux-image-tag-copy"></a>

È possibile aggiungere uno o più tag a un'immagine durante la creazione dell'immagine o dopo aver creato un'immagine. È anche possibile copiare l'immagine all'interno della stessa regione o in una nuova regione all'interno dello stesso account Amazon Web Services. La copia di un'immagine sorgente produce un'immagine di destinazione identica ma distinta. AWS tuttavia, non copia alcun tag definito dall'utente. Inoltre, è possibile copiare solo immagini personalizzate che sono state create, non le immagini di base fornite da AWS. 

**Nota**  
È possibile copiare fino a due immagini in una destinazione nello stesso momento. Se la destinazione in cui si desidera copiare un'immagine è al limite dell'immagine, viene restituito un errore. Per copiare l'immagine in questo caso, è necessario prima rimuovere le immagini dalla destinazione. Dopo che la destinazione è inferiore alla quota immagine (definita anche limite), avviare la copia dell'immagine dalla regione di origine. Per ulteriori informazioni, consulta [Amazon WorkSpaces Applications Service Quotas](limits.md).

**Per aggiungere tag a un'immagine esistente**

1. Nel riquadro di navigazione, scegliere **Images (Immagini)**, **Image Registry (Registro immagini)**. 

1. Nell'elenco di immagini, selezionare l'immagine a cui si desidera aggiungere tag.

1. Scegli **Tag**, **Aggiungi/Modifica tag**, quindi scegli **Aggiungi tag**. Specifica la chiave e il valore del tag, quindi scegli **Salva**.

Per ulteriori informazioni, consulta [Etichettatura delle risorse WorkSpaces delle applicazioni Amazon](tagging-basic.md).

**Copiare un'immagine**

La copia di un'immagine su più regioni geograficamente diverse consente di effettuare lo streaming di applicazioni da più regioni in base alla stessa immagine. Effettuando lo streaming delle applicazioni in prossimità degli utenti, è possibile migliorare l'esperienza degli utenti durante lo streaming delle applicazioni con WorkSpaces Applications.

1. Nel riquadro di navigazione, scegliere **Images (Immagini)**, **Image Registry (Registro immagini)**. 

1. Nell'elenco di immagini, selezionare l'immagine da copiare.

1. Selezionare **Actions (Operazioni)**, **Copy (Copia)**.

1. Nella finestra di dialogo **Copy Image (Copia immagine)**, specificare le informazioni seguenti, quindi scegli **Copy Image (Copia immagine):**
   + Per **Destination Region (Regione di destinazione)** scegliere la regione in cui copiare la nuova immagine. 
   + Per **Name (Nome)**, specificare un nome che avrà l'immagine quando verrà copiata nella destinazione. 
   + Per **Description (Descrizione)** (facoltativo), specificare una descrizione che avrà l'immagine quando verrà copiata nella destinazione. 

1. Per controllare il progresso dell'operazione di copia, tornare alla console e passare a **Images (Immagini)**, **Image Registry (Registro immagine)**. Utilizzare la barra di navigazione per passare alla regione di destinazione (se applicabile) e confermare che la nuova immagine viene visualizzata nell'elenco di immagini.

   La nuova immagine viene visualizzata prima con stato **Copying (Copia)** nel registro immagine della console. Dopo che l'immagine è stata creata con successo, lo stato dell'immagine viene modificato in **Available (Disponibile)**, che significa che è possibile utilizzare l'immagine per avviare uno stack ed effettuare lo streaming delle applicazioni. 

## Fase 8: elimina
<a name="tutorial-linux-image-finish"></a>

Infine, puoi arrestare gli Image Builder in esecuzione per liberare le risorse ed evitare addebiti indesiderati per l'account. Consigliamo di arrestare qualsiasi Image Builder inutilizzato in esecuzione. Per ulteriori informazioni, consulta i [prezzi WorkSpaces delle applicazioni](https://aws.amazon.com/appstream2/pricing/).

**Arrestare un Image Builder in esecuzione**

1. Nel riquadro di navigazione, scegliere **Images (Immagini)**, **Image Builders (Image Builder)** e selezionare l'istanza dell'Image Builder in esecuzione.

1. Scegliere **Actions (Operazioni)**, **Stop (Arresta)**.

# Tutorial: abilitare il supporto per la lingua giapponese per le immagini Linux
<a name="enable-japanese-support-linux"></a>

Questo tutorial descrive come abilitare il supporto in lingua giapponese per un'immagine Linux. Ciò consente alle applicazioni sull'immagine di visualizzare caratteri giapponesi e agli utenti di streaming di utilizzare il metodo di input giapponese nelle sessioni di streaming dall'immagine.

**Topics**
+ [Fase 1: installazione del font giapponese e del metodo di input](#tutorial-japanese-font)
+ [Fase 2: impostazione del fuso orario del sistema](#tutorial-japanese-zone)
+ [Fase 3: impostazione delle impostazioni locali del sistema e della lingua di visualizzazione](#tutorial-japanese-locale)
+ [Fase 4: configurazione dei metodi di input](#tutorial-japanese-input)
+ [Fase 5: impostazione del layout della tastiera](#tutorial-japense-keyboard)
+ [Fase 6: Verifica su Image Builder](#tutorial-japense-verify)
+ [Fase 7: Creazione dell'immagine](#tutorial-japanese-create)

## Fase 1: installazione del font giapponese e del metodo di input
<a name="tutorial-japanese-font"></a>

In questa fase, colleghi un Image Builder Linux e installi i pacchetti di font e metodi di input di tua scelta.

**Installazione del font giapponese e del metodo di input**

1. Connetti l'Image Builder in uno dei seguenti modi: 
   + [Usa la console WorkSpaces Applicazioni](managing-image-builders-connect-console.md) (solo per connessioni Web)
   + [Crea un URL di streaming](managing-image-builders-connect-streaming-URL.md) (per connessioni client Web o WorkSpaces Applicazioni)
**Nota**  
Accederai come ImageBuilderAdmin utente al desktop Amazon Linux GNOME e disporrai dei privilegi di amministratore root.

1. Installa il font e il metodo di input necessari. Per fare ciò, apri l'applicazione Terminale, quindi esegui i seguenti comandi:

   **sudo yum install vlgothic-p-fonts.noarch**

   **sudo yum install ibus-kkc.x86\$164**

1. Oltre ai comandi precedenti, per Rocky Linux e Red Hat Enterprise Linux, esegui il seguente comando:

   **sudo yum install glibc-langpack-ja**

## Fase 2: impostazione del fuso orario del sistema
<a name="tutorial-japanese-zone"></a>

Per impostare il fuso orario del sistema, esegui il seguente comando:

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

## Fase 3: impostazione delle impostazioni locali del sistema e della lingua di visualizzazione
<a name="tutorial-japanese-locale"></a>

Per impostare le impostazioni locali del sistema e la lingua di visualizzazione, esegui i seguenti comandi. 

**Per impostare le impostazioni locali del sistema e la lingua di visualizzazione**

1. Aggiorna il file `cloud-init config` eseguendo il comando **sudo vim /etc/cloud/cloud.cfg** e modifica **Impostazioni locali** in **Impostazioni locali: ja\$1JP.utf8**, quindi salva e chiudi il file.

1. Aggiorna le impostazioni di sistema eseguendo **sudo localectl set-locale LANG=ja\$1JP.utf8**.

1. Aggiorna le impostazioni della shell Gnome eseguendo **sudo gsettings set org.gnome.system.locale region "ja\$1JP.utf8"**.

## Fase 4: configurazione dei metodi di input
<a name="tutorial-japanese-input"></a>

Configura i metodi di input per l'applicazione che desideri aggiungere all'immagine. Per ulteriori informazioni su come installare un'applicazione, generare un file manifesto e creare impostazioni predefinite, consulta [Tutorial: creazione di un'immagine personalizzata di applicazioni basate su Linux WorkSpaces](tutorial-create-linux-image.md). In questa fase, supponiamo che tu abbia già installato l'applicazione Firefox, che si trova in `/usr/local/firefox/firefox`.

**Per configurare i metodi di input**

1. Crea uno script eseguendo il comando **sudo vim /usr/local/bin/update-input-method.sh** e aggiungi il seguente contenuto allo script:

   ```
   #!/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"
   ```

   Nello script precedente, la prima origine di input ('ibus', 'kkc') è il metodo di input predefinito. Puoi modificare il metodo di input predefinito modificando l'ordine delle origini di input. Inoltre, "Ctrl\$1Spazio" e "Maiusc\$1Ctrl\$1Spazio" sono specificati come combinazioni di tasti di scelta rapida per passare da un metodo di input all'altro. Puoi specificare combinazioni di tasti personalizzate che gli utenti possono utilizzare per cambiare metodo di input durante le sessioni di streaming.

1. Crea lo script per avviare l'applicazione (Firefox) da aggiungere all'immagine. A tale scopo, esegui il comando**sudo vim /usr/local/bin/firefox-jp.sh**, quindi aggiungi il seguente contenuto allo script:

   ```
   #!/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. Aggiungi l'autorizzazione per l'esecuzione a entrambi gli script eseguendo i seguenti comandi:

   **sudo chmod \$1x /usr/local/bin/update-input-method.sh**

   **sudo chmod \$1x /usr/local/bin/firefox-jp.sh**

1. Se hai già creato il file manifesto di ottimizzazione per l'applicazione, esegui i seguenti comandi per aggiungere lo script di avvio dell'applicazione al catalogo delle applicazioni:

   ```
   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
   ```

In alternativa, potete anche configurare i metodi di input aggiungendo lo script update-input-method .sh come applicazione separata al catalogo delle applicazioni per l'immagine. Durante le sessioni di streaming, gli utenti possono avviare questa applicazione per abilitare l'input in lingua giapponese e passare da un metodo di input all'altro con tasti di scelta rapida specificati all'interno della stessa sessione.

## Fase 5: impostazione del layout della tastiera
<a name="tutorial-japense-keyboard"></a>

Imposta il layout della tastiera in modo che corrisponda alle tastiere che gli utenti useranno durante le sessioni di streaming. Puoi utilizzare il comando **localectl list-keymaps** per elencare tutte le mappe di tasti disponibili e, ad esempio, utilizzare il comando **sudo localectl set-keymap jp106** per impostare la mappa dei tasti sulla tastiera giapponese a 106 tasti.

## Fase 6: Verifica su Image Builder
<a name="tutorial-japense-verify"></a>

Per eseguire la verifica su Image Builder, prima riavvialo eseguendo il comando **sudo shutdown -r now**. Dopo il riavvio, collegati nuovamente all'Image Builder e verifica che tutto, incluso il fuso orario, le impostazioni locali, la lingua e il metodo di input, funzioni come previsto.

## Fase 7: Creazione dell'immagine
<a name="tutorial-japanese-create"></a>

Crea l'immagine nell'Image Builder. Per ulteriori informazioni, consulta [Tutorial: creazione di un'immagine personalizzata di applicazioni basate su Linux WorkSpaces](tutorial-create-linux-image.md). Assicurati di creare le impostazioni predefinite dell'applicazione, incluse le impostazioni regionali che hai appena configurato. Per ulteriori informazioni, consulta "Creazione di impostazioni predefinite delle applicazioni per gli utenti" in [Creazione delle immagini basate su Linux](create-linux-based-images.md).

Tutte le istanze del parco istanze Linux create da questa immagine avranno le stesse impostazioni predefinite di fuso orario, impostazioni locali, lingua e metodo di input configurate per l'immagine.