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

流程

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

2. 创建命名空间：

   1. 进入 管理 命名空间。
   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. 在 管理 下，单击 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 的示例：

   

   View larger image

   

流程

1. 进入 Red Hat OpenShift Container Platform。
2. 选择 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. 单独添加以下键及其关联的值：

      Expand

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

      Show more
      重要

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

   4. 点 Create。

      下图是授权 secret 的示例：

      

      View larger image

      

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

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

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

      Expand

      键	value
      username	输入您用来连接到 IBM watsonx Code Assistant 模型的用户名。
      model_type	根据 IBM watsonx Code Assistant 模型输入以下值之一： 对于 IBM watsonx Code Assistant 模型的内部部署(IBM Cloud Pak for Data)： wca-onprem 对于 IBM watsonx Code Assistant 模型的云部署： wca
      model_url	输入 IBM watsonx Code Assistant 模型的 URL。
      model_api_key	输入在模型安装过程中生成的 IBM watsonx Code Assistant 模型的 API 密钥。
      model_id	输入 IBM watsonx Code Assistant 模型的 ID。
      model_verify_ssl	可选，只在 Red Hat Ansible Automation Platform 2.5 中支持。 这个键控制是否验证 IBM watsonx Code Assistant 模型的 SSL 证书。 默认为 true

      Show more
      重要

      确保您不会意外在值字段中添加任何空格字符（额外行、空格等）。如果 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. 可选：如果您创建了捆绑包 secret 以信任自定义证书颁发机构，请从 Advanced Bundle CA Certificate Secret 列表中选择 bundle_cacert_secret。

10. 点 Create。

    Red Hat Ansible Lightspeed 实例需要几分钟时间才能部署到您的命名空间中。安装状态显示为 Successful 后，Red Hat OpenShift Container Platform 的 Networking Routes 下提供了 Ansible Lightspeed 门户 URL。

流程

1. 在 Red Hat OpenShift Container Platform 中，选择 Networking Routes 并找到您创建的 Red Hat Ansible Lightspeed 实例。这是 Ansible Lightspeed 实例的 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：

   • 当使用 Ansible Automation Platform operator 安装 Red Hat Ansible Lightspeed 实例和自动化控制器时的流程 ：

     1. 登录到运行 Ansible Automation Platform 实例的集群。
     2. 识别 AutomationController 自定义资源。
     3. 选择 [YAML view]。

     4. 在 YAML 文件中添加以下条目：

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

        Copy to Clipboard Toggle word wrap
        重要

        在指定 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'"

     5. 应用修改后的 YAML。此任务会重启自动化控制器 pod。

   • 当 Ansible Automation Platform Operator 在虚拟机上运行时 的步骤：

     1. 使用 Ansible Automation Platform 控制器登录到虚拟机。

     2. 在 /etc/tower/conf.d/custom.py 文件中，添加以下参数：
        LOGOUT_ALLOWED_HOSTS = "<lightspeed_route-HostName>"

        重要
        • 如果 /etc/tower/conf.d/custom.py 文件不存在，请创建该文件。

        • 指定没有网络协议的主机名，如 https://。

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

        • 在对中使用单引号和双引号；不要使用双引号混合单引号。
     3. 执行以下命令重启自动化控制器：
        $ automation-controller-service restart

   • 当平台网关在虚拟机上运行时的步骤 ：

     1. 使用平台网关登录虚拟机。

     2. 在 gateway/settings.py 文件或 ansible-automation-platform/gateway/settings.py 文件中添加以下参数：
        LOGOUT_ALLOWED_HOSTS = "<lightspeed_route-HostName>"

        重要

        • 指定没有网络协议的主机名，如 https://。

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

        • 根据代码块中指定的那样，使用双引号。

流程

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。

     注意

     如果您的组织最近订阅了 Red Hat Ansible Automation Platform，则可能需要几小时时间 Red Hat Ansible Lightspeed 来检测新的订阅。在 VS Code 中，使用 Activity 栏中 Ansible 扩展中的 Refresh 按钮再次检查。

流程

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 将被终止。

流程

1. 创建 系统审核员 用户：

   1. 在 Red Hat Ansible Automation Platform 中使用 系统审核员 角色创建用户。有关流程， 请参阅开始使用 Ansible Automation Platform 的用户 部分。
   2. 验证您可以作为新创建的系统审核员用户登录到内部部署的 Ansible Lightspeed 门户(https://<lightspeed_route>/)，然后注销。

2. 为 系统审核员用户创建令牌 ：

   1. 使用以下凭证以管理员身份登录到内部部署的 Ansible Lightspeed 门户(https://<lightspeed_route>/admin)：

      • Username: admin
      • 密码 ：在部署 Red Hat Ansible Lightspeed 的 Red Hat OpenShift Container Platform 集群命名空间中的 <lightspeed-custom-resource-name>-admin-password 的 secret。
   2. 在 Django 管理窗口中，从 Users 区域中选择 Users。此时会显示用户列表。
   3. 验证具有 system auditor 角色的用户是否在 Users 列表中列出。
   4. 从 Django Oauth 工具包区域中，选择 Access token Add。

   5. 提供以下信息并点 Save ：

      • 用户 ：使用放大镜图标搜索并选择具有 system auditor 角色的用户。
      • token ：为用户指定令牌。复制此令牌供以后使用。
      • ID token ：选择令牌 ID。
      • 应用 ： 为 VS Code 选择 Ansible Lightspeed。
      • 过期 ：选择您希望令牌过期时的日期和时间。

      • Scope ：将范围指定为 读取写入。

        为具有系统审核员角色的用户创建访问令牌。

   6. 从 Ansible Lightspeed 门户注销，以进行内部部署。
3. 使用带有系统审核员角色的用户的授权令牌来监控 Red Hat Ansible Lightspeed_route>/metrics，以访问指标端点 https://<lightspeed_route>/metrics。

流程

1. 选择您要授予 REST API 访问权限的平台用户。

   您可以选择现有用户，或者在 Red Hat Ansible Automation Platform 中创建平台用户。有关流程， 请参阅开始使用 Ansible Automation Platform 的用户 部分。

2. 验证您可以登录到内部部署的 Ansible Lightspeed 门户(https://<lightspeed_route&gt;/)作为您选择的平台用户，然后注销。

3. 为平台用户创建令牌：

   1. 使用以下凭证以管理员身份登录到内部部署的 Ansible Lightspeed 门户(https://<lightspeed_route>/admin)：

      • Username: admin
      • 密码 ：在部署 Red Hat Ansible Lightspeed 的 Red Hat OpenShift Container Platform 集群命名空间中的 <lightspeed-custom-resource-name>-admin-password 的 secret。
   2. 在 Django 管理窗口中，从 Users 区域中选择 Users。此时会显示用户列表。
   3. 验证平台用户是否已列在 Users 列表中。
   4. 从 Django Oauth 工具包区域中，选择 Access token Add。

   5. 提供以下信息并点 Save ：

      • 用户 ：使用放大镜图标搜索并选择新创建的用户或现有用户，以获取 API 访问权限。
      • token ：为用户指定令牌。复制此令牌供以后使用。
      • ID token ：选择令牌 ID。
      • 应用 ： 为 VS Code 选择 Ansible Lightspeed。
      • 过期 ：选择您希望令牌过期时的日期和时间。

      • Scope ：将范围指定为 读取写入。

        为用户创建一个访问令牌。

   6. 从 Ansible Lightspeed 门户注销，以进行内部部署。

4. 通过在授权标头中指定新创建的令牌，对 Ansible Lightspeed REST API 进行直接调用：

   curl -H "Authorization: Bearer <token>"
   https://<lightspeed_route>/api/v1/me/

   Copy to Clipboard Toggle word wrap