기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 자습서: Linux 이미지에 일본어 지원 활성화
<a name="enable-japanese-support-linux"></a>

이 자습서에서는 Linux 이미지에 대한 일본어 지원을 활성화하는 방법을 설명합니다. 이를 통해 이미지의 애플리케이션은 일본어 문자를 표시할 수 있고 스트리밍 사용자는 이미지의 스트리밍 세션에서 일본어 입력 방법을 사용할 수 있습니다.

**Topics**
+ [1단계: 일본어 글꼴 및 입력 방법 설치](#tutorial-japanese-font)
+ [2단계: 시스템 시간대 설정](#tutorial-japanese-zone)
+ [3단계: 시스템 로캘 및 표시 언어 설정](#tutorial-japanese-locale)
+ [4단계: 입력 방법 구성](#tutorial-japanese-input)
+ [5단계: 키보드 레이아웃 설정](#tutorial-japense-keyboard)
+ [6단계: 이미지 빌더에서 확인](#tutorial-japense-verify)
+ [7단계: 이미지 생성](#tutorial-japanese-create)

## 1단계: 일본어 글꼴 및 입력 방법 설치
<a name="tutorial-japanese-font"></a>

이 단계에서는 Linux 이미지 빌더를 연결하고 원하는 글꼴 및 입력 방법 패키지를 설치합니다.

**일본어 글꼴 및 입력 방법을 설치하는 방법**

1. 다음 중 하나를 수행하여 이미지 빌더에 연결합니다.
   + [WorkSpaces 애플리케이션 콘솔 사용](managing-image-builders-connect-console.md)(웹 연결에만 해당)
   + [스트리밍 URL 생성](managing-image-builders-connect-streaming-URL.md)(웹 또는 WorkSpaces 애플리케이션 클라이언트 연결용)
**참고**  
Linux GNOME 데스크톱에 ImageBuilderAdmin 사용자로 로그인하고 루트 관리자 권한을 갖게 됩니다.

1. 필요한 글꼴 및 입력 방법을 설치합니다. 이렇게 하려면 터미널 애플리케이션을 열고 다음 명령을 실행합니다.

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

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

1. 위의 명령 외에도 Rocky Linux 및 Red Hat Enterprise Linux의 경우 다음 명령을 실행합니다.

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

## 2단계: 시스템 시간대 설정
<a name="tutorial-japanese-zone"></a>

시스템 시간대를 설정하려면 다음 명령을 실행합니다.

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

## 3단계: 시스템 로캘 및 표시 언어 설정
<a name="tutorial-japanese-locale"></a>

시스템 로캘과 표시 언어를 설정하려면 다음 명령을 실행합니다.

**시스템 로캘 및 표시 언어를 설정하는 방법**

1. **sudo vim /etc/cloud/cloud.cfg** 명령을 실행하여 `cloud-init config` 파일을 업데이트하고 **로캘**을 **locale: ja\$1JP.utf8**로 변경한 다음 파일을 저장하고 닫습니다.

1. **sudo localectl set-locale LANG=ja\$1JP.utf8**을 실행하여 시스템 설정을 업데이트합니다.

1. **sudo gsettings set org.gnome.system.locale region "ja\$1JP.utf8"**을 실행하여 Gnome 쉘 설정을 업데이트합니다.

## 4단계: 입력 방법 구성
<a name="tutorial-japanese-input"></a>

이미지에 추가하려는 애플리케이션의 입력 방법을 구성합니다. 애플리케이션 설치, 매니페스트 파일 생성 및 기본 설정 생성 방법에 대한 자세한 내용은 [자습서: 사용자 지정 Linux 기반 WorkSpaces 애플리케이션 이미지 생성](tutorial-create-linux-image.md) 섹션을 참조하세요. 이 단계에서는 `/usr/local/firefox/firefox`에 위치한 Firefox 애플리케이션을 이미 설치했다고 가정합니다.

**입력 방법을 구성하는 방법**

1. **sudo vim /usr/local/bin/update-input-method.sh** 명령을 실행하여 스크립트를 만들고 스크립트에 다음 내용을 추가합니다.

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

   위 스크립트에서는 첫 번째 입력 소스('ibus', 'kkc')가 기본 입력 방법입니다. 입력 소스의 순서를 변경하여 기본 입력 방법을 변경할 수 있습니다. 또한 입력 방법 간 전환을 위한 단축키 조합으로 'Control\$1Space'와 'Shift\$1Control\$1Space'가 지정되어 있습니다. 스트리밍 세션 중에 사용자가 입력 방법을 전환하는 데 사용할 수 있는 고유한 키 조합을 지정할 수 있습니다.

1. 이미지에 추가할 애플리케이션(Firefox)을 시작하기 위한 스크립트를 만듭니다. 이렇게 하려면 명령을 실행**sudo vim /usr/local/bin/firefox-jp.sh**한 다음 스크립트에 다음 콘텐츠를 추가합니다.

   ```
   #!/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. 다음 명령을 실행하여 두 스크립트에 실행 권한을 추가합니다.

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

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

1. 애플리케이션에 대한 최적화 매니페스트 파일을 이미 생성한 경우 다음 명령을 실행하여 애플리케이션 카탈로그에 애플리케이션 실행 스크립트를 추가하세요.

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

또는 update-input-method.sh 스크립트를 이미지의 애플리케이션 카탈로그에 별도의 애플리케이션으로 추가하여 입력 방법을 구성할 수도 있습니다. 스트리밍 세션 중에 사용자는 이 애플리케이션을 실행하여 일본어 입력을 활성화하고 동일한 세션 내에서 지정된 단축키를 사용하여 입력 방법을 전환할 수 있습니다.

## 5단계: 키보드 레이아웃 설정
<a name="tutorial-japense-keyboard"></a>

사용자가 스트리밍 세션 중에 사용할 키보드와 일치하도록 키보드 레이아웃을 설정합니다. 예를 들어 **localectl list-keymaps** 명령을 사용하여 사용 가능한 모든 키맵을 나열하고 **sudo localectl set-keymap jp106** 명령을 사용하여 키맵을 106개 키의 일본어 키보드로 설정할 수 있습니다.

## 6단계: 이미지 빌더에서 확인
<a name="tutorial-japense-verify"></a>

이미지 빌더에서 확인하려면 먼저 **sudo shutdown -r now** 명령을 실행하여 이미지 빌더를 재부팅합니다. 재부팅한 후 이미지 빌더에 다시 연결하고 시간대, 로캘, 언어, 입력 방법 등 모든 항목이 예상대로 작동하는지 확인합니다.

## 7단계: 이미지 생성
<a name="tutorial-japanese-create"></a>

이미지 빌더에서 이미지를 생성합니다. 자세한 내용은 [자습서: 사용자 지정 Linux 기반 WorkSpaces 애플리케이션 이미지 생성](tutorial-create-linux-image.md) 단원을 참조하십시오. 방금 구성한 리전별 설정을 포함하여 기본 애플리케이션 설정을 생성해야 합니다. 자세한 내용은 [Linux 기반 이미지 만들기](create-linux-based-images.md)에서 '사용자를 위한 기본 애플리케이션 설정 만들기'를 참조하세요.

이 이미지에서 생성된 모든 Linux 플릿 인스턴스는 이미지에 구성한 것과 동일한 기본 시간대, 로캘, 언어 및 입력 방법 설정을 갖게 됩니다.