在 Amazon Q 中配置开发文件 - Amazon Q 开发者版

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

在 Amazon Q 中配置开发文件

要让 Amazon Q 测试其为响应/dev命令而生成的代码建议，您必须配置开发文件。您可以：

  • 让 Amazon Q 根据您的项目背景为您生成开发文件。

  • 自己创建开发文件。

有关开发文件和使用 Amazon Q 进行测试的更多信息，请参阅测试由 Amazon Q “/dev” 命令生成的代码建议。

让 Amazon Q 为你生成一个开发文件

  1. 在你的 IDE 中，运行一个/dev命令。Amazon Q 会生成一条未经测试的建议，它会在聊天窗口中向您显示该建议。

  2. 在建议的末尾，选择 “生成开发文件以生成代码” 按钮。Amazon Q 会生成一个开发文件。

  3. 将文件另存devfile.yaml为项目的根文件夹。

    保存开发文件后，Amazon Q 将在下次使用该/dev命令时开始使用它。

  4. （可选，但建议使用）提交并推送开发文件，以便其他用户可以使用该文件。

配置你自己的开发文件

  1. 从基本的开发文件开始。您可以让 Amazon Q 为您生成一个（参见前面的过程），也可以使用中的一个示例Amazon Q 开发者中的示例开发文件。

  2. 按照下一节中的指导方针修改开发文件以满足您的需求。Guidelines for configuring your own devfile

  3. 将文件另存devfile.yaml为项目的根文件夹。

    保存开发文件后，Amazon Q 将在下次使用该/dev命令时开始使用它。

  4. （可选，但建议使用）提交并推送开发文件，以便其他用户可以使用该文件。

配置自己的开发文件的指导方针

  • 中指定的 Docker 映像image:必须位于公共镜像注册表中，例如 DockerHub 或公共的 Amazon ECR 注册表中。不支持私有注册表。

  • 开发文件必须符合 devfil e 2.2.0 架构。

  • 并非支持 devfile 2.2.0 架构中的所有对象。Amazon Q 仅支持installbuild、和test命令。你可以添加其他命令，但它们不会被运行。

  • 中的命令总共commands:必须花费不到五分钟的时间才能运行。他们将在五分钟后超时。

  • 如果你需要引用工件，它们必须位于公共工件存储库中，比如 pyPI 或 npmjs.com。不支持私有构件存储库。

  • 请勿引用需要身份验证访问的 AWS 资源（或任何资源），例如 Amazon S3 存储桶。这是因为开发环境的 Docker 容器已被沙盒化，只能访问互联网上的公共资源。