3.3. Red Hat Ansible Lightspeed オンプレミスデプロイメントのセットアップ

手順

1. Red Hat OpenShift Container Platform に管理者としてログインします。

2. namespace を作成します。

   1. Administration Namespaces に移動します。
   2. Create Namespace をクリックします。
   3. namespace の一意の名前を入力します。
   4. Create をクリックします。

3. Operator をインストールします。

   1. Operators OperatorHub に移動します。
   2. Red Hat Ansible Automation Platform Operator をインストールする namespace を選択します。
   3. Ansible Automation Platform Operator を検索します。
   4. 検索結果から、Ansible Automation Platform (provided by Red Hat) タイルを選択します。
   5. Update Channel を選択します。チャネルとして stable-2.x または stable-2.x-cluster-scoped のいずれかを選択できます。
   6. 更新チャネルとして “stable-2.x” を選択した場合は、宛先 namespace を選択します。
   7. Install を選択します。Operator のインストールには数分かかります。
4. View Operator をクリックすると、新しくインストールされた Red Hat Ansible Automation Platform Operator の詳細が表示されます。

手順

1. Automation Controller に管理者としてログインします。
2. Administration で、Applications Add をクリックします。

3. 以下の情報を入力します。

   1. Name: アプリケーションの一意の名前を指定します。
   2. Organization: 任意の組織を選択します。
   3. Authorization grant type: Authorization code を選択します。

   4. Redirect URIs: ひとまず一時的な URL を入力しておきます (例: https://temp/)。

      オンプレミスのデプロイメントが完了すると、正確な Red Hat Ansible Lightspeed アプリケーション URL が生成されます。デプロイメントが完了したら、生成された Red Hat Ansible Lightspeed アプリケーション URL を参照するように Redirect URI を変更する必要があります。詳細は、Redirect URIs の更新 を参照してください。

   5. Client type リストから、Confidential を選択します。

4. Save をクリックします。

   ポップアップウィンドウに、生成されたアプリケーションクライアント ID とクライアントシークレットが表示されます。

5. 生成されたクライアント ID とクライアントシークレットの両方をコピーして保存し、後で使用できるようにします。

   重要

   ポップアップウィンドウは、このときにしか表示されません。そのため、必ずクライアント ID とクライアントシークレットの両方をコピーしてください。これらのトークンは、Red Hat Ansible Automation Platform と IBM watsonx Code Assistant の両方の接続シークレットを作成するのに必要です。

   次のイメージは、生成されたクライアント ID とクライアントシークレットの例です。

   

手順

1. Red Hat OpenShift Container Platform にアクセスします。
2. Operators Installed Operators を選択します。
3. Projects リストから、Red Hat Ansible Lightspeed インスタンスをインストールし、接続シークレットを作成した namespace を選択します。
4. 先ほどインストールした Ansible Automation Platform (provided by Red Hat) Operator を探して選択します。
5. All instances Create new を選択します。
6. Create new リストから、Ansible Lightspeed モーダルを選択します。
7. 設定モードとして Form view が選択されていることを確認します。

8. 次の情報を指定します。

   1. Name: Red Hat Ansible Lightspeed インスタンスの一意の名前を入力します。
   2. Secret where the authentication information can be found: Red Hat Ansible Automation Platform に接続するために作成した認証シークレットを選択します。
   3. Secret where the model configuration can be found: IBM watsonx Code Assistant に接続するために作成したモデルシークレットを選択します。

9. Create をクリックします。

   Red Hat Ansible Lightspeed インスタンスを namespace にデプロイするには数分かかります。インストールステータスが Successful と表示されたら、Red Hat OpenShift Container Platform の Networking Routes で Ansible Lightspeed ポータル URL を取得できるようになります。

手順

1. Ansible Lightspeed インスタンスの URL を取得します。

   1. Red Hat OpenShift Container Platform にアクセスします。
   2. Networking Routes の順に選択します。
   3. 作成した Red Hat Ansible Lightspeed インスタンスを見つけます。
   4. Red Hat Ansible Lightspeed インスタンスの Location URL をコピーします。

2. logout リダイレクト URI を更新します。

   1. Automation Controller で、Administration Applications に移動します。
   2. 作成した Lightspeed Oauth アプリケーションを選択します。

   3. Oauth アプリケーションの Redirect URIs フィールドに、次の形式で URL を入力します。

      https://<lightspeed_route>/complete/aap/

      URL の例は https://lightspeed-on-prem-web-service.com/complete/aap/ です。

      重要

      リダイレクト URL には次の情報が含まれている必要があります。

      • 接頭辞 https://
      • <lightspeed_route> URL (先ほどコピーした Red Hat Ansible Lightspeed インスタンスの URL)
      • 末尾のバックスラッシュ記号 (/) を含む接尾辞 /complete/aap/
   4. Save をクリックします。

3. logout リダイレクト URI を更新します。

   1. Red Hat Ansible Automation Platform インスタンスが実行されているクラスターにログインします。
   2. AutomationController カスタムリソースを特定します。
   3. [YAML view] を選択します。

   4. YAML ファイルに次のエントリーを追加します。

      ```yaml
        spec:
        ...
        extra_settings:
          - setting: LOGOUT_ALLOWED_HOSTS
            value: "'<lightspeed_route-HostName>'"
        ```

      重要

      value: パラメーターを指定する際には、必ず以下を行ってください。

      • https:// など、ネットワークプロトコルなしでホスト名を指定します。

        たとえば、正しいホスト名は https://my-aiconnect-instance.somewhere.com ではなく、my-aiconnect-instance.somewhere.com になります。

      • コードブロックで指定されているとおりに、一重引用符と二重引用符を正確に使用します。

        一重引用符を二重引用符に変更したり、その逆を行ったりすると、ログアウト時にエラーが発生します。

      • Red Hat Ansible Lightspeed デプロイメントのインスタンスを複数指定するには、コンマを使用します。

        単一の Red Hat Ansible Automation Platform デプロイメントで Red Hat Ansible Lightspeed アプリケーションのインスタンスを複数実行している場合は、コンマ (,) を追加してから、他のホスト名の値を追加します。たとえば、"'my-lightspeed-instance1.somewhere.com','my-lightspeed-instance2.somewhere.com'" のように複数のホスト名を追加できます。

4. 変更した YAML を適用します。これにより、Automation Controller Pod が再起動します。

手順

1. VS Code アプリケーションを開きます。
2. Activity バーから Extensions アイコンをクリックします。
3. Installed Extensions リストから、Ansible を選択します。
4. Ansible 拡張機能ページで、Settings アイコン ( ) をクリックし、Extension Settings を選択します。

5. Ansible Lightspeed 設定を選択し、次の情報を指定します。

   • URL for Ansible Lightspeed フィールドに、Red Hat Ansible Lightspeed オンプレミスデプロイメントの Route URL を入力します。Ansible ユーザーは、Ansible Automation Platform コントローラーの認証情報を持っている必要があります。

   • オプション: デフォルトモデルの代わりにカスタムモデルを使用する場合は、Model ID Override フィールドにカスタムモデル ID を入力します。設定は自動的に VS Code に保存されます。

     Ansible VS Code 拡張機能を Red Hat Ansible Lightspeed オンプレミスデプロイメントに接続するように設定した後、Ansible VS Code 拡張機能を介して Ansible Lightspeed にログイン する必要があります。

     注記

     最近 Red Hat Ansible Automation Platform にサブスクライブしている場合は、Red Hat Ansible Lightspeed が新しいサブスクリプションを検出するまでに数時間かかる場合があります。VS Code で、アクティビティーバーの Ansible 拡張の Refresh ボタンを使用して、再度確認します。

手順

1. Red Hat OpenShift Container Platform にアクセスします。
2. Operators Installed Operators を選択します。
3. Projects リストから、Red Hat Ansible Lightspeed インスタンスをインストールした namespace を選択します。
4. 先ほどインストールした Ansible Automation Platform (provided by Red Hat) Operator を探して選択します。
5. Ansible Lightspeed タブを選択します。
6. 更新するインスタンスを見つけて選択します。
7. Actions Edit AnsibleLightspeed をクリックします。エディターはテキストまたは YAML ビューに切り替わります。

8. テキストをスクロールして spec: セクションを見つけます。

   )

9. 変更して新しい名前で保存したシークレットのエントリーを見つけます。
10. シークレットの名前を新しいシークレットに変更します。

11. Save をクリックします。

    新しい Ansible Lightspeed Pod が作成されます。新しい Pod が正常に実行されると、古い Ansible Lightspeed Pod が終了します。

手順

1. システム監査 ユーザーを作成します。

   1. Red Hat Ansible Automation Platform で システム auditor ロールを持つユーザーを作成します。Automation Controller ユーザーガイド の トピック Creating a user を参照してください。
   2. 新しく作成されたシステム auditor ユーザーとしてオンプレミスデプロイメント(https://<lightspeed_route>/)の Ansible Lightspeed ポータルにログインしてから、ログアウトできることを確認します。

2. システム監査 ユーザーのトークンを作成します。

   1. 以下の認証情報を使用して、オンプレミスデプロイメント(https://<lightspeed_route>/admin)用に Ansible Lightspeed ポータルにログインします。

      • ユーザー名: admin
      • Password: Red Hat Ansible Light speed がデプロイされている Red Hat OpenShift Container Platform クラスター名前空間で <lightspeed-custom-resource-name>-admin-password という名前のシークレット。
   2. Django 管理ウィンドウで、Users エリアから Users を選択します。ユーザーの一覧が表示されます。
   3. システム auditor ロールを持つユーザーが ユーザー リストに表示されていることを 確認 します。
   4. Django Oauth ツールキットエリアから、Access tokens Add 選択します。

   5. 次の情報を入力し、Save をクリックします。

      • ユーザー：拡大 glass アイコンを使用して、システム監査者のロールを持つユーザーを検索して選択します。
      • Token: ユーザーのトークンを指定します。このトークンは、後で使用するためにコピーします。
      • ID token : トークン ID を選択します。
      • アプリケーション: VS Code に Ansible Lightspeed を 選択します。
      • Expires: トークンの有効期限が切れる日時を選択します。

      • Scope: スコープを 読み取り書き込み として指定します。

        アクセストークンは、システム監査者のロールを持つユーザーに対して作成されます。

   6. オンプレミスデプロイメント用に Ansible Lightspeed ポータルからログアウトします。
3. システム auditor ロールを持つユーザーの認証トークンを使用して、メトリクスエンドポイント https://<lightspeed_route>/metrics にアクセスするために、Red Hat Ansible Lightspeed オンプレミスデプロイメントを監視します。