使用 IBM watsonx Code Assistant 用户指南的 Red Hat Ansible Lightspeed

流程

1. 以机构 管理员身份登录到 Ansible Lightspeed 门户。
2. 点 Log in → Log in with Red Hat。

3. 输入您的红帽帐户用户名和密码。Ansible Lightspeed 服务使用 Red Hat Single Sign-On (RH-SSO)进行身份验证。

   作为身份验证过程的一部分，Ansible Lightspeed Service 会检查您的机构是否有活跃的 Ansible Automation Platform 订阅。身份验证成功后，登录屏幕将与您的用户名和您分配的用户角色一起显示。

4. 从登录屏幕，单击 管理门户。

   您可以使用 IBM watsonx Code Assistant 管理员门户重定向到 Red Hat Ansible Lightspeed，您可以将 Red Hat Ansible Lightspeed 连接到您的 IBM watsonx Code Assistant 实例。

流程

1. 以机构 管理员身份登录到 Ansible Lightspeed 门户。
2. 从登录屏幕，单击 管理门户。

3. 指定 IBM watsonx Code Assistant 实例的 API 密钥：

   1. 在 IBM Cloud API Key 下，单击 Add API key。此时会显示输入 API 密钥的 屏幕。
   2. 输入 API Key。
   3. 可选：点 Test 来验证 API 密钥。
   4. 点 Save。

4. 指定您要使用的模型的型号 ID：

   1. 点 Model Settings。
   2. 在 Model ID 下，点 Add Model ID。此时会显示输入 Model Id 的屏幕。
   3. 输入您在上一步中获取的 Model ID 作为您的机构的默认模型。
   4. 可选：点 Test model ID 来验证模型 ID。

   5. 点 Save。

      当成功验证 API 密钥和模型 ID 时，Red Hat Ansible Lightspeed 会连接到 IBM watsonx Code Assistant 实例。

流程

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

流程

1. 进入 Ansible Lightspeed 门户登录页面。
2. 点 Log in → Log in with Red Hat。
3. 输入您的红帽帐户用户名和密码。

流程

1. 打开 VS Code 应用。
2. 在导航菜单中点 Extensions 图标。
3. 在 Search 字段中，输入 Ansible。
4. 选择 Ansible 以选择红帽发布的 Ansible 语言支持扩展。
5. 点 Install。

6. 安装完成后，验证您的 VSCode 安装：

   1. 使用 .yml 或 .yaml 文件扩展名创建一个新的 YAML 文件。
   2. 在 Status 工具栏中，点语言指示符并选择 Ansible 将 Ansible 语言类型与新的 YAML 文件关联。
   3. 开始编写测试 playbook。在开始创建内容时，会显示上下文辅助功能。

流程

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

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

   1. 确定选择了 Enable Ansible Lightspeed with watsonx Code Assistant inline recommendations 复选框。
   2. 在 Ansible Lightspeed 字段中，验证您有以下 URL ：https://c.ai.ansible.redhat.com/。
   3. 选择 Enable Ansible Lightspeed with watsonx Code Assistant 内联建议 复选框。

6. 可选：如果要使用自定义模型而不是默认的模型，在 Model ID Override 字段中输入自定义模型 ID。model-override 设置允许您覆盖默认模型并使用自定义模型，在机构管理员创建了自定义模型并单独共享模型 ID。

   您的设置会自动保存在 VS Code 中。

流程

1. 打开 VS Code 应用。

2. 使用 Ansible Lightspeed 视图中的 Connect 按钮或 Accounts 菜单登录。

   • 使用 连接按钮登录 ：

     1. 在 VS Code 活动栏中，单击 Ansible 图标。
     2. 在 Ansible Lightspeed 视图中，单击 Connect。
     3. 按照屏幕提示登录 Ansible Lightspeed。

   • 使用 Accounts 菜单登录 ：

     1. 在 VS Code 活动栏中，单击 Accounts 菜单。

     2. 使用 Ansible Lightspeed 登录以使用 Ansible 或与红帽签订以使用 Ansible，具体取决于您显示的登录选项。

        注意
        • 当 VS Code 扩展处于 active 状态时，会显示 sign-in 选项。在打开 Ansible 侧面板后，扩展会被激活，或者在 VS Code 编辑器中打开 Ansible 文件后激活。如果没有看到这个选项，请使用 Connect 按钮链接到 Ansible Lightspeed 服务。
        • 如果您在 Ansible Lightspeed 未知的域中使用云环境，如内部 Red Hat OpenShift Dev Spaces，则您的帐户登录菜单提供了由红帽 使用 Ansible 的 Sign-in 选项。这个选项使用设备代码流来成功完成登录过程，并需要 Red Hat Authentication extension v0.2.0 或更高版本。如果您需要此身份验证流，但没有看到红帽的 Sign-in 来使用 Ansible 选项，请确保使用 Ansible VS Code 扩展 v24.5.2 或更高版本。
     3. 按照屏幕提示登录 Ansible Lightspeed。

   身份验证成功后，登录屏幕将与您的用户名和您分配的用户角色一起显示。

流程

1. 使用您的红帽帐户登录 VS Code。

2. 创建新的 YAML 文件或使用现有的 YAML 文件：

   • 创建 YAML 文件：

     1. 选择 File → New Text File。
     2. 从屏幕右下角，单击 Plain Text，然后在语言模式中选择 Ansible。
     3. 将文件保存为 YAML 文件格式扩展名(.yml 或 .yaml)。

   • 使用现有的 YAML 文件：

     1. 在屏幕右下角，单击现有语言模式，然后在语言模式设置中选择 Ansible。

        注意

        如果您没有在 VS Code 编辑器中看到语言模式 部分，请从 Command swig 中选择 Configure Language Mode → Ansible。

3. 验证您在 VS Code 右下角的状态栏上看到 Lightspeed 的条目。

   如果 Ansible 已选为所需的语言，但没有显示 Lightspeed 条目，请重新选择 Ansible 作为语言模式。下图显示了 VS Code 状态栏上的 Lightspeed 和 Ansible 条目。

   图 4.2. Ansible 和 Lightspeed 设置为所选语言模式

   

   View larger image

   

4. 可选：如果看到有关缺少 Ansible lint 的错误消息，您可以安装缺少的模块或禁用它。执行以下任务之一：

   • 安装 Ansible lint：有关安装信息，请参阅 Ansible Lint 文档中的安装部分。https://ansible.readthedocs.io/projects/lint/installing/

   • 禁用 Ansible lint：

     1. 在 Activity 栏中，点 Extensions 图标 。
     2. 在 Installed extensions 列表中，选择 Ansible。
     3. 在 Ansible 扩展页面中，单击 Settings 图标并选择 Extension Settings。
     4. 清除 Ansible criu Validation criu Lint: Enabled 复选框。

5. 创建 playbook 或使用现有的 playbook。

   如需更多信息，请参阅开始使用 playbook 指南。

6. 在 playbook 中，提供以下信息来请求单个任务的代码建议：

   1. 通过在正确的缩进上启动带有 - name: 的新行来添加新的 Ansible 任务。
   2. 在任务描述 after - name: 在同一行中添加详细的自然语言提示。例如，您可以指定以下单任务提示： - name: Install postgresql-server

   3. 在任务描述后直接按 Enter 键。将光标保留在文件中的同一位置，并等待代码建议结果填充。

      Ansible Lightspeed 服务参与，它开始为单个任务生成代码建议。

      重要

      Ansible Lightspeed 服务每个任务需要 5 秒时间来填充代码建议。如果您使用多任务提示，Ansible Lightspeed 服务需要更长的时间（任务次数 5 秒）来填充结果。不要在生成代码建议时移动光标或按任意键。如果您更改了光标位置或按任意键，Ansible VS Code 扩展会取消请求，Ansible Lightspeed 服务不会处理您的请求。

      当 Ansible Lightspeed 服务参与时，会在屏幕右下角显示 Lightspeed 处理状态指示正在生成您的代码建议。

      

7. 查看您的代码建议，并确保建议与您的任务意图匹配。

   下图显示了 Ansible Lightspeed 服务为单一任务生成的代码建议，即 Install postgresql-server ：

   

8. 接受或拒绝代码建议：

   • 要接受代码建议，请按 Tab。

   • 要拒绝代码建议，请按 Esc。

     注意

     如果拒绝建议，您可以修改提示并再次查看生成的代码建议，以匹配您的任务意图。

9. 在 ANSIBLE: LIGHTSPEED TRAINING MATCHES 选项卡中，查看内容源匹配结果。

   下图显示了在现有 Ansible Galaxy 内容中找到的培训匹配，用于安装 postgresql-server 的任务提示：

   

   View larger image

   
10. 点 Save 在 Ansible YAML 文件中保存代码建议更改。

流程

1. 使用您的红帽帐户登录 VS Code。

2. 创建新的 YAML 文件或使用现有的 YAML 文件。

   • 创建 YAML 文件：

     1. 选择 File → New Text File。
     2. 从屏幕右下角，单击 Plain Text，然后在语言模式中选择 Ansible。
     3. 将文件保存为 YAML 文件格式扩展名(.yml 或 .yaml)。

   • 使用现有的 YAML 文件：

     1. 在屏幕右下角，单击现有语言模式，然后在语言模式设置中选择 Ansible。

        注意

        如果您没有在 VS Code 编辑器中看到语言模式 部分，请从 Command swig 中选择 Configure Language Mode → Ansible。

3. 验证您在 VS Code 右下角的状态栏上看到 Lightspeed 的条目。

   如果 Ansible 已选为所需的语言，但没有显示 Lightspeed 条目，请重新选择 Ansible 作为语言模式。下图显示了 VS Code 状态栏上的 Lightspeed 条目。

   图 4.3. Ansible 和 Lightspeed 设置为所选语言模式

   

   View larger image

   

4. 可选：如果看到有关缺少 Ansible lint 的错误消息，您可以安装缺少的模块或禁用它。执行以下任务之一：

   • 安装 Ansible lint：有关安装信息，请参阅 Ansible Lint 文档中的安装部分。https://ansible.readthedocs.io/projects/lint/installing/

   • 禁用 Ansible lint：

     1. 在 Activity 栏中，点 Extensions 图标 。
     2. 在 Installed extensions 列表中，选择 Ansible。
     3. 在 Ansible 扩展页面中，单击 Settings 图标并选择 Extension Settings。
     4. 清除 Ansible criu Validation criu Lint: Enabled 复选框。

5. 创建 playbook 或使用现有的 playbook。

   如需更多信息，请参阅开始使用 playbook 指南。

6. 在 playbook 中，提供以下信息来请求多任务代码建议：

   1. 通过在正确的缩进中输入 pound 符号(TALM)来启动新的 YAML 文件注释。

   2. 按顺序添加详细的自然语言提示，通过使用 符号(&)分隔每个任务。

      多任务提示示例

      # Install postgresql-server & run postgresql-setup command

      Copy to Clipboard Toggle word wrap

      为提高可读性，请将您的多任务内联提示拆分到多行。要达到此目的，请用 符号(&)结束当前行，并使用哈希符号(#)启动下一行。

      多任务提示通过多行分割的示例

      # Create a keypair called lightspeed-keypair & create a vpc & create vpc_id var &
      # create a security group that allows SSH & create subnet with 10.0.1.0/24 cidr &
      # create an internet gateway & create a route table

      Copy to Clipboard Toggle word wrap

   3. 在任务描述后直接按 Enter 键。将光标保留在文件中的同一位置，并等待代码建议结果填充。

      Ansible Lightspeed 服务参与，它开始为多个任务生成代码建议。

      重要

      Ansible Lightspeed 服务每个任务需要 5 秒时间来填充代码建议。如果您使用多任务提示，Ansible Lightspeed 服务需要更长的时间（任务次数 5 秒）来填充结果。不要在生成代码建议时移动光标或按任意键。如果您更改了光标位置或按任意键，Ansible VS Code 扩展会取消请求，Ansible Lightspeed 服务不会处理您的请求。

      当 Ansible Lightspeed 服务参与时，会在屏幕右下角显示 Lightspeed 处理状态指示正在生成您的代码建议。

      

7. 可选： 如果没有生成多任务代码建议，请从 VS Code 注销，并使用您的红帽帐户再次登录。

8. 查看您的代码建议，并确保建议与您的任务意图匹配。

   以下示例显示，Ansible Lightspeed 服务为 Install postgresql-server & run postgresql-setup 命令 生成的代码建议：

   

9. 接受或拒绝代码建议：

   • 要接受代码建议，请按 Tab。

   • 要拒绝代码建议，请按 Esc。

     注意

     如果拒绝建议，您可以修改提示并再次查看生成的代码建议，以匹配您的任务意图。

10. 在 ANSIBLE: LIGHTSPEED TRAINING MATCHES 选项卡中，查看内容源匹配结果。

    下图显示了在现有 Ansible Galaxy 内容中找到的培训匹配，用于任务提示 multitask 提示 Install postgresql-server & run postgresql-setup 命令 ：

    

    View larger image

    
11. 点 Save 在 Ansible YAML 文件中保存代码建议更改。

流程

1. 使用您的红帽帐户登录 VS Code。
2. 在 Activity 栏中，点 Ansible 图标。

3. 在 Ansible Creator 下，单击 Get started。此时会显示 Ansible Content Creator 页面。

   下图显示了 Ansible Content Creator 页面：

   图 4.5. 创建 Ansible playbook 的设置

   

   View larger image

   
4. 选择带有 Ansible Lightspeed 标题的 Playbook。此时会显示 Create a playbook 页面。

5. 在 What do want the playbook to accomplish? 字段中，输入提示以创建 playbook，然后单击 Analyze。

   几秒钟后，您的 playbook 意图的建议步骤会显示在您的 playbook 的"检查"步骤，并根据需要进行修改。

6. 执行以下任务之一：

   • 如果步骤与您的意图匹配：单击 Generate Playbook。
   • 如果需要修改：点编辑器并更新任务或步骤以符合您的意图。
   • 如果任务建议与您的意图不匹配：单击 Back 以更改原始提示，然后重新开始。
   • 如果要恢复原始任务建议：点 Reset，然后继续下一步。

7. 验证步骤后，单击 Generate playbook。

   playbook 生成几秒钟，并且为字段 生成以下 playbook 会显示新生成的 playbook：

8. 单击 Open editor。生成的 playbook 在 VS Code 编辑器中作为无权利的 YAML 文件打开。
9. 保存没有权利的 YAML 文件。

流程

1. 使用您的红帽帐户登录 VS Code。
2. 在 VS Code 中打开 Ansible playbook YAML 文件。

3. 使用以下方法之一查看 playbook 的解释：

   • 从活跃的 playbook YAML 文件中 ：

     1. 将光标放置在 playbook 文件中的任何位置。
     2. 右键单击并选择 说明使用 Ansible Lightspeed 的 playbook。

   • 在 Ansible 面板中 ：

     1. 在导航菜单中点 Ansible 图标。

     2. 选择 Explain the current playbook。

        Playbook 解释显示在 VS Code 屏幕右侧面板中。

        下图显示了一个 playbook 的示例：

        图 4.6. playbook 解释示例

        

        View larger image

        

流程

1. 使用您的红帽帐户登录 VS Code。
2. 在 Activity 栏中，点 Ansible 图标。

3. 使用以下方法之一创建角色：

   • 在 Ansible 面板中 ：

     1. 在导航菜单中点 Ansible 图标。
     2. 点 Generate a role。

   • 从命令面板 ：

     • 在 VS Code 编辑器的 Command && 中，单击 View → Command && amp;，然后输入 & gt; Ansible Lightspeed: Role generation。

       VS Code 屏幕右侧面板中会显示 Create a role with Ansible Lightspeed 页面。

4. 从 Select the collection to create role in 列表中，选择您要在其中创建角色的集合。您必须在工作区中有一个集合才能创建角色。

   如果没有集合，您必须使用以下方法之一创建它：

   • 使用以下命令：

     ansible-creator init collection myns.mycollection my_directory

     运行该命令后，使用 VS Code 打开新目录。

   • 使用 Ansible VS Code 扩展

     如需更多信息，请参阅 Ansible Automation Platform 入门指南 中的 关于内容集合 的主题。

5. 在 您要在自然语言字段中实现的 Describe 中，输入提示以创建角色，然后点击 Analyze。

   几秒钟后，您的角色意图的建议步骤会显示在 您的角色的建议步骤中，并根据需要进行修改。

6. 执行以下任务：

   1. 检查和（可选）更改角色名称。
   2. 查看创建角色的集合。

   3. 验证建议的步骤是否与您的意图匹配，然后单击 Continue。

      生成角色需要几秒钟，并且新生成的角色与生成角色的文件列表一起显示。

      注意
      • 如果要修改步骤：点编辑器字段，更新提示或步骤以符合您的意图，然后单击 Continue。
      • 如果角色建议与您的意图不匹配：单击 Back 以更改原始提示，然后重新开始。
      • 如果要恢复到原始建议的步骤：点 Reset，然后点 Continue 进入下一步。
7. 单击 Save files。此时会显示包含新角色的文件列表。
8. 单击文件，以在 VS Code 编辑器中打开它们。

流程

1. 使用您的红帽帐户登录 VS Code。
2. 在 VS Code 的 roles 目录中打开 Ansible 角色 YAML 文件。

3. 使用以下方法之一查看 playbook 的解释：

   • 从活跃的角色 YAML 文件中 ：

     1. 将光标放置在 playbook 文件中的任何位置。
     2. 右键单击并选择 Explain the role with Ansible Lightspeed。

   • 在 Ansible 面板中 ：

     1. 在导航菜单中点 Ansible 图标。
     2. 选择 Explain the current playbook。

   • 从命令面板 ：

     • 在 VS Code 编辑器的 Command && 中输入 Explain the role with Ansible Lightspeed。

       角色解释显示在 VS Code 屏幕右侧面板中。

       以下示例显示一个角色说明示例：

       图 4.7. 角色解释示例

       

       View larger image

       

流程

1. 以机构管理员身份 使用 IBM watsonx Code Assistant Hybrid Cloud Console 登录到 Ansible Lightspeed。

2. 在导航面板中，选择 Ansible Lightspeed > Admin Dashboard。

   Admin 仪表板显示过去 30 天内分析遥测数据的图形化表示。

3. 使用以下过滤器来优化遥测数据：

   • 要查看特定时间段或自定义日期范围的遥测数据，请从 Quick Date Range 列表中选择日期范围。
   • 要只查看特定 IBM watsonx Code Assistant 模型的遥测数据，请从 Model Name 列表中选择模型 ID。默认情况下，Admin 仪表板显示所有模型的遥测数据。

流程

1. 以机构 管理员身份登录到 Ansible Lightspeed 门户。
2. 从登录屏幕，单击 管理门户。
3. 在管理门户中，单击 Telemetry。

4. 要禁用 Admin 仪表板遥测，请仅选择 Operational telemetry data。

   注意

   要重新启用 Admin 仪表板遥测，请选择 Admin dashboard telemetry data。

5. 点 Save。

1. 使用内容解析器工具创建培训数据集
2. 使用 IBM watsonx Code Assistant 创建和部署自定义模型
3. 将 Red Hat Ansible Lightspeed 配置为使用自定义模型

流程

1. 在 GitHub 中，导航到您要扫描的存储库。
2. 在仓库 .github 文件夹中创建一个名为 ansible-code-bot .yml 的 .yml 配置文件。
   例如： .github/ansible-code-bot.yml。

3. 在配置文件中，以 interval 参数指定扫描调度。您可以将 interval 参数指定为 每日、weekly 或 monthly。例如：

   schedule:
     interval: daily

   Copy to Clipboard Toggle word wrap
4. 提交您的更改。

流程

1. 登录 Ansible 代码 bot 仪表板。

   Ansible 代码 bot 仪表板显示安装代码 bot 的仓库列表，并指示扫描计划是否未设置，或者设置为手动或调度扫描。

2. 要查看您仓库扫描的历史记录，请点存储库旁边的 Ellipsis 图标( )，然后选择 View scan history。

   存储库的扫描历史记录以及扫描启动时间、扫描状态、扫描类型（调度或手动）和拉取请求（如果创建）链接，如果扫描失败，则链接到拉取请求。

3. 要在 GitHub 上查看您的存储库，请点存储库旁边的 Ellipsis 图标( )并选择 View repository。

流程

1. 登录 Ansible 代码 bot 仪表板。
2. 单击 GitHub 上的 Manage Code Bot。
3. 在 GitHub 中，点您的配置集 photo > Settings。
4. 在 Integrations 下，单击 Applications。

5. 在 Repository access 区域中，执行以下任务之一：

   • 添加新软件仓库 ： 在 Select repositories 列表中，选择您要添加的存储库。新添加的存储库显示在 Ansible 代码 bot 仪表板中。
   • 删除现有存储库: 从 Select repositories 列表中，单击您要删除的存储库旁边的 跨 图标。删除的存储库详情在 Ansible 代码 bot 仪表板中不再可见。
6. 点 Save。

流程

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

8. 滚动并找到 spec: 部分，并在 spec: 部分中添加以下参数：

   extra_settings:
       - setting: ANSIBLE_AI_MODEL_MESH_API_VERIFY_SSL
         value: false

   Copy to Clipboard Toggle word wrap
9. 点 Save。

10. 重启自动化控制器 pod 以应用修改后的 YAML。
    执行以下步骤：

    1. 在 Red Hat OpenShift Container Platform 中，选择 Workloads → Pods。
    2. 找到并选择您更新的 Ansible Lightspeed pod。
    3. 点 Pod 旁边的 Edit 图标，再选择 Delete Pod。
       选择 pod 被删除并创建新的 pod。

1. 打开 Visual Studio Code。
2. 导航到 File > Preferences > Settings。
3. 在侧边栏中选择 Application → Proxy。

4. 在 Http: Proxy 字段中，添加以下 URL 到代理：

   • https://c.ai.ansible.redhat.com/
   • https://sso.redhat.com，如果您使用 RH-SSO 来验证用户。
5. 在 http: Proxy Support 下拉列表中，选择 Override。

6. 搜索并选择以下配置键：

   • Electron Fetch
   • 如果您使用自己的证书颁发机构(CA)，则系统证书 V2。

1. 安装 VS 代码扩展 网络代理测试。

2. 使用 Network Proxy Test: Test Connection 操作，通过参数 /check/status end-point 对服务器和端点进行目标。

   例如：

   https://c.ai.ansible.redhat.com/check/status/ 测试到 Red Hat Ansible Lightspeed 云服务的连接。