3.3. 设置 Red Hat Ansible Lightspeed 内部部署

流程

1. 以管理员身份登录 Red Hat OpenShift Container Platform。

2. 创建命名空间：

   1. 进入 Administration Namespaces。
   2. 点 Create Namespace。
   3. 为命名空间输入一个唯一名称。
   4. 点 Create。

3. 安装 Operator：

   1. 进入 Operators OperatorHub。
   2. 选择您要安装 Red Hat Ansible Automation Platform Operator 的命名空间。
   3. 搜索 Ansible Automation Platform operator。
   4. 在搜索结果中，选择 Ansible Automation Platform （由红帽提供）。
   5. 选择一个 更新频道。您可以选择 stable-2.x 或 stable-2.x-cluster-scoped 作为频道。
   6. 如果您选择了 "stable-2.x" 作为更新频道，请选择目标命名空间。
   7. 选择 Install。安装 Operator 需要几分钟时间。
4. 点 View Operator 查看新安装的 Red Hat Ansible Automation Platform Operator 的详情。

流程

1. 以管理员身份登录自动化控制器。
2. 在 Administration 下，点 Applications > Add。

3. 输入以下信息：

   1. Name ：指定应用程序的唯一名称。
   2. Organization: 选择一个首选的机构。
   3. 授权授权类型 ：选择 授权代码。

   4. 重定向 URI ：立即输入临时 URL，例如 https://temp/。

      确切的 Red Hat Ansible Lightspeed 应用程序 URL 在内部部署完成后生成。部署完成后，您必须将 Redirect URI 更改为指向生成的 Red Hat Ansible Lightspeed 应用 URL。如需更多信息 ，请参阅更新 Redirect URI。

   5. 从 Client type 列表中，选择 机密。

4. 点 Save。

   此时会显示弹出窗口以及生成的应用程序客户端 ID 和客户端 secret。

5. 复制并保存生成的客户端 ID 和客户端 secret，以备将来使用。

   重要

   这是仅显示弹出窗口的唯一时间。因此，请确保复制客户端 ID 和客户端 secret，因为您需要这些令牌为 Red Hat Ansible Automation Platform 和 IBM watsonx Code Assistant 创建连接 secret。

   下图是生成的客户端 ID 和客户端 secret 的示例：

   

流程

1. 进入 Red Hat OpenShift Container Platform。
2. 选择 Select Workloads Secrets。
3. 点 Create Key/value secret。
4. 在 Projects 列表中，选择安装 Red Hat Ansible Automation Platform Operator 时创建的命名空间。

5. 创建 授权 secret 以连接到 Red Hat Ansible Automation Platform：

   1. 点 Create Key/value secret。
   2. 在 Secret name 中，为 secret 输入唯一名称。例如： auth-aiconnect。

   3. 单独添加以下键及其关联的值：

      键	value
      auth_api_url	输入自动化控制器的 API URL，格式为： https://<CONTROLLER_SERVER_NAME>/api。
      auth_api_key	输入您之前记录的 OAuth 应用程序的客户端 ID。
      auth_api_secret	输入您之前记录的 OAuth 应用程序的客户端 secret。
      auth_allowed_hosts	输入代表底层 Django 框架使用的主机/域名的字符串列表，以限制哪些主机可以访问该服务。这是一种安全措施，用于防止 HTTP 主机标头攻击。如需更多信息，请参阅 Django 文档中的允许主机。
      auth_verify_ssl	输入值为 true。

      重要

      确保您不会意外在值字段中添加任何空格字符（额外行、空格等）。如果 secret 中有任何额外的或错误字符，与 Red Hat Ansible Automation Platform 的连接会失败。

   4. 点 Create。

      下图是授权 secret 的示例：

      

6. 同样，创建一个 模型 secret 来连接到 IBM watsonx Code Assistant 模型：

   1. 点 Create Key/value secret。
   2. 在 Secret name 中，为 secret 输入唯一名称。例如，model-aiconnect。

   3. 单独添加以下键及其关联的值：

      键	value
      username	输入您用来连接到 IBM Cloud Pak for Data 部署的用户名。
      model_type	输入 wca-onprem 以连接到 IBM Cloud Pak for Data 部署。
      model_url	输入 IBM watsonx Code Assistant 的 URL。
      model_api_key	在 IBM Cloud Pak for Data deployment 中输入 IBM watsonx Code Assistant 模型的 API 密钥。
      model_id	在 IBM Cloud Pak for Data deployment 中输入 IBM watsonx Code Assistant 模型的模型 ID。

      重要

      确保您不会意外在值字段中添加任何空格字符（额外行、空格等）。如果 secret 中有任何额外的或错误字符，与 IBM watsonx Code Assistant 的连接会失败。

   4. 点 Create。

流程

1. 进入 Red Hat OpenShift Container Platform。
2. 选择 Operators Installed Operators。
3. 从 Projects 列表中，选择要安装 Red Hat Ansible Lightspeed 实例的命名空间，以及创建连接 secret 的位置。
4. 找到并选择您之前安装的 Ansible Automation Platform （由 Red Hat 提供） Operator。
5. 选择 All instances Create new。
6. 从 Create new 列表中，选择 Ansible Lightspeed 模态。
7. 确保您已选择了 Form view 作为配置模式。

8. 提供以下信息：

   1. 名称 ：输入 Red Hat Ansible Lightspeed 实例的唯一名称。
   2. 找到身份验证信息的 secret ：选择您创建的身份验证 secret 以连接到 Red Hat Ansible Automation Platform。
   3. 找到模型配置的 secret ：选择您创建的模型 secret 以连接到 IBM watsonx Code Assistant。

9. 点 Create。

   Red Hat Ansible Lightspeed 实例需要几分钟时间才能部署到您的命名空间中。安装状态显示为 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. 更新 登录重定向 URI：

   1. 在自动化控制器中，进入 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/。

      重要

      Redirect URL 必须包括以下信息：

      • https://前缀
      • & lt;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://。

        例如，正确的主机名为 my-aiconnect-instance.somewhere.com，而不是 https://my-aiconnect-instance.somewhere.com。

      • 按照 codeblock 中指定的，使用单引号和双引号。

        如果将单引号更改为双引号，反之亦然，则退出时将遇到错误。

      • 使用逗号分隔来指定 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。此任务会重启自动化控制器 pod。

流程

1. 打开 VS Code 应用。
2. 在 Activity 栏中，点 Extensions 图标。
3. 从 Installed Extensions 列表中，选择 Ansible。
4. 在 Ansible 扩展页面中，点 Settings 图标( )并选择 Extension Settings。

5. 选择 Ansible Lightspeed 设置并指定以下信息：

   • 在 Ansible Lightspeed 字段的 URL 中，输入 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。

流程

1. 进入 Red Hat OpenShift Container Platform。
2. 选择 Operators Installed Operators。
3. 从 Projects 列表中，选择安装 Red Hat Ansible Lightspeed 实例的命名空间。
4. 找到并选择您之前安装的 Ansible Automation Platform （由 Red Hat 提供） Operator。
5. 选择 Ansible Lightspeed 选项卡。
6. 查找并选择您要更新的实例。
7. 点 Actions > Edit AnsibleLightspeed。编辑器将切换到文本或 YAML 视图。

8. 滚动文本以查找 spec: 部分。

   )

9. 查找您更改的 secret 的条目，并将其保存在新名称下。
10. 将 secret 的名称更改为新 secret。

11. 点 Save。

    创建新的 AnsibleLightspeed Pod。新 pod 成功运行后，旧的 AnsibleLightspeed Pod 将被终止。