RHEL Lightspeed を搭載したコマンドラインアシスタントとの対話

手順

1. 現在のターミナルセッションのターミナルキャプチャーを有効にします。

   $ c shell --enable-capture

   Copy to Clipboard Toggle word wrap
2. 以前のコマンドを参照する前に、少なくとも 1 つのコマンドを実行します。

3. 以前実行したコマンドの出力を参照します。たとえば、直近のコマンドを参照するには、次のコマンドを実行します。

   $ c -w 1 "what_is_this"

   Copy to Clipboard Toggle word wrap

   • 2 つ前のコマンドを参照するには、次のコマンドを実行します。

     $ c -w 2 "what_is_this"

     Copy to Clipboard Toggle word wrap
4. ターミナルキャプチャーを停止するには、キーボードで Ctrl + D キーを押します。

手順

1. Red Hat Container Registry に認証します。

   $ podman login registry.redhat.io

   Copy to Clipboard Toggle word wrap

2. installer コンテナーを実行します。このコマンドは、必要なイメージをダウンロードし、オフラインの RHEL コマンドラインアシスタントをシステムにインストールします。

   $ podman run -u : --rm \
   -v $HOME/.config:/config:Z \
   -v $HOME/.local/bin:/config/.local/bin:Z \
   registry.redhat.io/rhel-cla/installer:latest

   Copy to Clipboard Toggle word wrap

3. オプション: システムが起動するたびにオフラインの RHEL コマンドラインアシスタントコンテナーを自動的に起動させるには、podman run コマンドに install-systemd 引数を追加します。

   $ podman run -u : --rm \
   -v $HOME/.config:/config:Z \
   -v $HOME/.local/bin:/config/.local/bin:Z \
   registry.redhat.io/rhel-cla/installer:latest install-systemd

   Copy to Clipboard Toggle word wrap

4. コンテナーが実行中であることを確認します。

   $ podman ps
   CONTAINER ID   IMAGE         COMMAND     CREATED          STATUS
   ba655e5efdcd   installer-rh… /sbin/init  30 seconds ago   Up 29 seconds

   Copy to Clipboard Toggle word wrap

5. RHEL システムに RHEL command-line-assistant client パッケージをインストールします。

   # sudo dnf install command-line-assistant

   Copy to Clipboard Toggle word wrap

6. endpoint 設定オプションを更新します。

   1. テキストエディターで /etc/xdg/command-line-assistant/config.toml ファイルを開きます。

   2. endpoint 変数を見つけて、その値を、オフラインの RHEL コマンドラインアシスタントコンテナーをホストしているシステムのアドレスに変更します。たとえば、ローカルシステムに接続するには、次のようにします。

      endpoint = "http://127.0.0.1:8000/"

      Copy to Clipboard Toggle word wrap

7. clad サービスを再起動して新しい設定を適用します。

   $ sudo systemctl restart clad

   Copy to Clipboard Toggle word wrap

   インストールが完了したら、rhel-lightspeed コマンドを使用して、オフラインの RHEL コマンドラインアシスタントの起動、停止、アンインストール、およびステータス確認を実行できます。

検証

1. オフラインの RHEL コマンドラインアシスタントが実行されているかどうかを確認します。

   $ rhel-lightspeed start

   Copy to Clipboard Toggle word wrap

2. 次の質問をして、クライアントが正しく設定されているかどうかを確認します。

   $ c "what is an immutable file?"
   
   + Asking Red Hat Lightspeed
   This feature uses AI technology. Do not include any personal information or other sensitive information in your input. Interactions may be used to improve Red Hat's products or services.

   Copy to Clipboard Toggle word wrap

手順

1. テキストエディターで ~/.config/rhel-lightspeed/.env ファイルを開きます。以下に例を示します。

   $ vi ~/.config/rhel-lightspeed/.env

   Copy to Clipboard Toggle word wrap

2. container image 変数を設定します。

   1. LLAMACPP_IMAGE 変数を見つけて、お使いの GPU ハードウェアに対応する ramalama コンテナーに設定します。以下に例を示します。

      LLAMACPP_IMAGE="registry.redhat.io/rhel-cla/ramalama-rhel10-nvidia:latest"

      Copy to Clipboard Toggle word wrap

3. host device 変数を設定します。

   1. お使いの GPU デバイスの HOST_DEVICE 変数を見つけます。以下に例を示します。

      # For AMD GPUs
      HOST_DEVICE="/dev/dri"
      # For NVIDIA GPUs
      HOST_DEVICE="/dev/nvidia0"

      Copy to Clipboard Toggle word wrap

4. オプション: NVIDIA 固有の変数を設定します。

   1. NVIDIA 固有の変数を見つけて設定します。

5. アシスタントを再起動して変更を適用します。

   $ rhel-lightspeed stop
   $ rhel-lightspeed start

   Copy to Clipboard Toggle word wrap

手順

1. SSHD のステータスを確認し、再起動します。

   $ sudo systemctl status ssh
   $ sudo systemctl restart ssh

   Copy to Clipboard Toggle word wrap

2. コマンドラインアシスタントのオプションのターミナルキャプチャー機能を有効にします。

   $ c shell --enable-capture

   Copy to Clipboard Toggle word wrap

3. 最後に実行したコマンドの出力を含めるように指定するには、-w 1 "your_question" オプションを使用します。

   $ c -w 1 "what_is_this"

   Copy to Clipboard Toggle word wrap
   • 数字 2 を指定すると、最後から 2 番目のコマンドの出力が参照されます。他の数字を指定した場合も、同様に出力が参照されます。

   • また、実行するプロンプトをコマンドと一緒に指定し、“help me understand the output” (出力を説明してください) と尋ねて、エラーを含む出力を参照することもできます。これにより、コマンドアシスタントは、ユーザーがエラーの詳細を尋ねていることを理解します。

     コマンドラインアシスタントによって要求が処理され、いくつかの可能な解決策が提供されます。この例では、提案に従って journalctl -xeu sshd.service コマンドを実行すると、ログファイルを確認できます。

4. journalctl コマンドを実行し、ログファイルをチェックして潜在的な問題を特定します。

   $ journalctl -xeu sshd.service

   Copy to Clipboard Toggle word wrap

5. コマンドラインアシスタントに、この入力エラーを修正するためのコマンドを生成するよう求めます。

   $ c "what is the command that I can use to change 'Porrt' to 'Port' in the /etc/ssh/sshd_config file?"

   Copy to Clipboard Toggle word wrap

6. コマンドラインアシスタントによって提案されたコマンドを sudo ユーザーとして実行します。以下に例を示します。

   $ sudo sed -i s/Porrt/Port/g /etc/ssh/sshd_config

   Copy to Clipboard Toggle word wrap

手順

1. ターミナルで次のコマンドを入力して、システムにインストールされている httpd パッケージのバージョンをリスト表示します。

   $ sudo rpm -qa httpd
   httpd-2.4.62-2.fc40.x86_64

   Copy to Clipboard Toggle word wrap

2. すべての httpd パッケージを検索します。

   $ sudo rpm -qa httpd

   Copy to Clipboard Toggle word wrap

3. Web サーバーが着信リクエストを受け入れるポートを特定します。

   $ cat /etc/httpd/conf/httpd.conf | grep Listen
   # Listen: Allows you to bind Apache to specific IP addresses and/or
   # Change this to Listen on a specific IP address, but note that if
   #Listen 12.34.56.78:80
   Listen 80

   Copy to Clipboard Toggle word wrap

4. httpd サービスを再起動します。

   $ systemctl restart httpd
   
   Job for httpd. Service failed because the control process exited with error code.
   See "systemctl status httpd.service" and "journalctl -xeu httpd.service" for details.

   Copy to Clipboard Toggle word wrap

   1. journalctl コマンドを実行して、失敗したサービスの詳細を確認します。

      $ sudo journalctl -xeu httpd.service

      Copy to Clipboard Toggle word wrap

5. コマンドラインアシスタントを使用して問題のトラブルシューティングを行い、サービスが失敗する理由を質問します。

   $ sudo c "why did httpd fail to start"

   Copy to Clipboard Toggle word wrap

   1. コマンドラインアシスタントに selinux httpd ポートについて質問します。

      $ c "selinux httpd port"

      Copy to Clipboard Toggle word wrap

      アシスタントが、次のように sestatus コマンドを使用して、現在の SELinux ステータスと httpd サービスの内容を確認することを提案します。

      $ sudo sestatus
      
      SELinux status:                 enabled
      SELinuxfs mount:                /sys/fs/selinux
      SELinux root directory:         /etc/selinux
      Loaded policy name:             targeted
      Current mode:                   enforcing
      Mode from config file:          enforcing
      Policy MLS status:              enabled
      Policy deny_unknown status:     allowed
      Memory protection checking:     actual (secure)
      Max kernel policy version:      33

      Copy to Clipboard Toggle word wrap

   2. 次のコマンドを実行して、httpd サービスの特定の SELinux ポリシーを表示します。

      $ sudo cat /usr/share/selinux/targeted/contexts/httpd_var_run_t
      No such file or directory

      Copy to Clipboard Toggle word wrap

   3. コマンドラインアシスタントにコンテキストについて質問します。

      $ c "i don't have a httpd_var_run_t contexts"

      Copy to Clipboard Toggle word wrap

      コマンドラインアシスタントが要求を処理するまでに、しばらく時間がかります。処理が終わると、提案がいくつか提供されます。

   4. コンテキストがない可能性があるため、次のコマンドでコンテキストを設定する必要があるという指示が表示されます。

      $ sudo chcon -R -t httpd_var_run_t

      Copy to Clipboard Toggle word wrap

   5. コマンドラインアシスタント (CLA) にポートについて質問します。

      $ c "selinux won't let httpd listen on port 12345"

      Copy to Clipboard Toggle word wrap

   6. 次の提案を試して、コマンドを実行します。

      $ sudo semanage port -a -t httpd_port_t -p tcp 12345
      ValueError: Type httpd_port_t is invalid, must be a port type

      Copy to Clipboard Toggle word wrap

   7. 出力に表示されたエラーについて CLA に質問します。

      $ c "how do I fix ValueError: Type httpd_port_t is invalid, must be a port type"

      Copy to Clipboard Toggle word wrap

6. CLA によって提供された手順を実行します。

   $ sudo ls -Z /usr/sbin/httpd
   system_u:object_r:httpd_exec_t:s0 /usr/sbin/httpd
   
   $ chcon -t httpd_exec_t /usr/sbin/httpd
   
   $ sudo setenforce 1

   Copy to Clipboard Toggle word wrap

   1. httpd サービスを再起動し、httpd.service のステータスを確認します。

      $ sudo systemctl restart httpd
      Job failed
      
      $ sudo systemctl status httpd.service
      Failed to start the Apache Server

      Copy to Clipboard Toggle word wrap

7. httpd が port 12345 で待ち受けできるようにする方法について、CLA に質問します。

   $ c "how do I enable httpd to listen on port 12345 selinux"

   Copy to Clipboard Toggle word wrap

   1. CLA によって提案されたコマンドを実行します。

      $ sudo setsebool -P httpd_can_network_connect=1

      Copy to Clipboard Toggle word wrap

8. httpd サービスを再起動し、httpd.service のステータスを再度確認します。

   $ sudo systemctl status httpd
   $ sudo systemctl restart httpd
   Job failed, see journalctl

   Copy to Clipboard Toggle word wrap

9. journalctl サービスを確認します。

   $ journalctl -xeu httpd
   Output: An ExecStart= process belonging to unit httpd.service has exited.

   Copy to Clipboard Toggle word wrap

10. 出力を使用して CLA にトラブルシューティングを実行するよう求めます。

    $ c "An ExecStart= process belonging to unit httpd.service has exited."

    Copy to Clipboard Toggle word wrap

    1. CLA の応答で返されるコマンドを実行します。

       $ sudo ausearch -m AVC,USER_AVC -ts recent
       Output: "avc:  denied  {name_bind}  for pid=7184 comm="httpd" src=12345 scontext=system_u:system_r:httpd_t:s0 tcontext=system_u:object_r: unreserved_port_t:s0 tclas=tcp_socket permissive=0"

       Copy to Clipboard Toggle word wrap

    2. 前のコマンドの出力をコピーします。

       $ sudo c "avc: denied {name_bind} for pid=7184 comm="httpd" src=12345 scontext=system_u:system_r:httpd_t:s0 tcontext=system_u:object_r: unreserved_port_t:s0 tclas=tcp_socket permissive=0"

       Copy to Clipboard Toggle word wrap

    3. "SELinux is preventing Apache Server (httpd) from binding to port 12345" というエラーを解決するために、次のコマンドを実行します。

       $ sudo semanage port -a -t http_port_t -p tcp 12345

       Copy to Clipboard Toggle word wrap

手順

1. システムが登録されているかどうかを確認します。

   # subscription-manager identity

   Copy to Clipboard Toggle word wrap

2. システムが登録されていない場合は、次のコマンドを使用してシステムを登録します。

   # subscription-manager register

   Copy to Clipboard Toggle word wrap

手順

1. コマンドラインアシスタントデーモン (clad) を再起動します。

   $ systemctl restart clad

   Copy to Clipboard Toggle word wrap

2. 質問を指定して c コマンドを再実行します。

   $ c "<Your_question>"

   Copy to Clipboard Toggle word wrap

手順

1. key.pem の権限を root に変更します。

   $ sudo ls -l /etc/pki/consumer/
   $ sudo chown $(whoami):$(id -gn) /etc/pki/consumer/${<key_name>}

   Copy to Clipboard Toggle word wrap

2. clad コマンドを root として実行します。

   $ sudo chown $(whoami):$(id -gn) /etc/pki/consumer/${<key_name>}

   Copy to Clipboard Toggle word wrap

手順

1. /etc/xdg/command-line-assistant/config.toml 設定ファイルを開いて、プロキシー設定にアクセスします。

2. config.toml ファイルで次のブロックを見つけて変更します。

   # Backend settings for communicating with the external API.
   [backend]
   ...
   # proxies = { http = "http://example-host:8002", https = "https://example-host:8002" }

   Copy to Clipboard Toggle word wrap

3. proxies キーのコメントを解除し、http または https プロキシーホストを定義します。

   [backend]
   …
   # For a https proxy host
   proxies = { https = "https://<your_https_proxy_host:1234>"}

   Copy to Clipboard Toggle word wrap

4. 変更を加えたら、変更を有効にするために clad を再起動します。

   $ sudo systemctl restart clad

   Copy to Clipboard Toggle word wrap
   注記

   clad からの http または https トラフィックを指定のプロキシーにルーティングする場合は、http 値と https キーによる制御を使用できます。ただし、プロトコルはプロキシータイプの選択に影響せず、https トラフィックに http プロキシーを使用する設定にすることもできます。以下に例を示します。

   https = "http://<your_https_proxy_host:1234>"

   Copy to Clipboard Toggle word wrap

手順

1. 選択したデータベースをインストールします。

   • MySQL をインストールするには、次のように入力します。

     # dnf install python3-PyMySQL

     Copy to Clipboard Toggle word wrap

   • PostgreSQL をインストールするには、次のように入力します。

     # dnf install python3-psycopg2

     Copy to Clipboard Toggle word wrap
2. /etc/xdg/command-line-assistant/config.toml にあるデータベース設定ファイルにアクセスします。

3. デフォルト設定を見つけてコメントアウトします。以下に例を示します。

    [database]
       # type = "sqlite"
       # connection_string = "/var/lib/command-line-assistant/history.db"

   Copy to Clipboard Toggle word wrap

4. 選択したデータベースを設定します。以下の情報は /etc/xdg/command-line-assistant/config.toml でも参照できます。

   1. データベースの種類を設定します。<db_type> に、mysql または postgresql を指定します。

   2. データベースの詳細を設定します。

       type = <db_type>
       host = "<hostname_or_ip_address>"
       port = "5432"
       username = "<database_user_name>"
       password = "<password>"
       database = "<database_name>"

      Copy to Clipboard Toggle word wrap

5. データベースの種類を変更した後、変更を適用するために clad デーモンを再起動します。

   $ sudo systemctl restart clad

   Copy to Clipboard Toggle word wrap

手順

1. /etc/xdg/command-line-assistant/config.toml にあるデータベース設定ファイルにアクセスします。

2. [database] セクションから username および password パラメーターを削除します。次に例を示します。

   [database]
   type = "postgresql"
   host = "localhost"
   port = "5432"
   database = "history"

   Copy to Clipboard Toggle word wrap
   注記

   ユーザー名とパスワードを設定ファイルに残しておくと、これらの認証情報が systemd-creds ツールよりも優先されます。

3. 暗号化されたユーザー名またはパスワードの認証情報を生成します。次の例では、systemd-ask-password コマンドを使用します。名前が database-username および database-password のスキーマに従っている必要があります。従っていない場合、clad が認証情報を正しくロードしません。

   1. 暗号化されたユーザー名を生成するには、次のコマンドを実行します。

      $ systemd-ask-password -n | ( echo "[Service]" && systemd-creds encrypt --name=<database_username> -p - - ) >/etc/systemd/system/clad.service.d/<username>.conf

      Copy to Clipboard Toggle word wrap

   2. 暗号化されたパスワードを生成するには、次のコマンドを実行します。

      $ systemd-ask-password -n | ( echo "[Service]" && systemd-creds encrypt --name=<database_password> -p - - ) >/etc/systemd/system/clad.service.d/<password>.conf

      Copy to Clipboard Toggle word wrap

4. データベースの認証情報を更新した後、systemd を再ロードし、clad デーモンを再起動して変更を適用します。

   $ sudo systemctl daemon-reload
   $ sudo systemctl restart clad

   Copy to Clipboard Toggle word wrap