排查 devfile 的问题 - 亚马逊 CodeCatalyst
即使我在自定义 devfile 中实现了自定义映像，我的开发环境还是使用默认通用 devfile我的项目未使用默认通用 devfile 在我的开发环境中进行构建我需要移动开发环境的存储库 devfile我在启动 devfile 时遇到了问题我无法确定如何查看我的 devfile 状态我的 devfile 与最新映像中提供的工具不兼容

从2025年11月7日起，亚马逊 CodeCatalyst 将不再向新客户开放。如果您想使用该服务，请在2025年11月7日之前注册。有关更多信息，请参阅 如何迁移 CodeCatalyst。

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

排查 devfile 的问题

要解决中与 devfiles 相关的问题，请参阅以下章节。 CodeCatalyst有关 devfile 的更多信息，请参阅配置开发环境的 devfile。

即使我在自定义 devfile 中实现了自定义映像，我的开发环境还是使用默认通用 devfile

如果在启动使用自定义开发文件的开发环境时 CodeCatalyst 遇到错误，则开发环境默认为默认的通用开发文件。要解决此问题，您可以在 /aws/mde/logs/devfile.log 下的日志中查看确切的错误。您还可以在日志中检查 postStart 执行是否成功：/aws/mde/logs/devfileCommand.log。

我的项目未使用默认通用 devfile 在我的开发环境中进行构建

要解决此问题，请检查您是否未使用自定义 devfile。如果您未使用自定义 devfile，请在项目的源存储库中查看 devfile.yaml 文件以查找并纠正所有错误。

我需要移动开发环境的存储库 devfile

您可以将 /projects/devfile.yaml 中的默认 devfile 移至您的源代码存储库。要更新 devfile 的位置，请使用以下命令：/aws/mde/mde start --location repository-name/devfile.yaml。

我在启动 devfile 时遇到了问题

如果启动 devfile 时出现问题，它将进入恢复模式，这样您仍能连接到您的环境并修复 devfile。在恢复模式中，运行 /aws/mde/mde status 将不会包含 devfile 的位置。

{
    "status": "STABLE"
}

您可以查看 /aws/mde/logs 下的日志中的错误，修复 devfile，然后重试运行 /aws/mde/mde start。

我无法确定如何查看我的 devfile 状态

可以通过运行 /aws/mde/mde status 来查看 devfile 状态。运行此命令后，您可能会看到以下内容之一：

  • {"status": "STABLE", "location": "devfile.yaml" }

    这表明 devfile 是正确的。

  • {"status": "STABLE" }

    这表示 devfile 无法启动并且已进入恢复模式。

您可以在 /aws/mde/logs/devfile.log 下的日志中查看确切的错误。

您还可以在日志中检查 postStart 执行是否成功：/aws/mde/logs/devfileCommand.log。

有关更多信息，请参阅为开发环境指定通用 devfile 映像。

我的 devfile 与最新映像中提供的工具不兼容

在您的开发环境中，如果 latest 工具没有特定项目所需的工具，则 devfile 或 devfile postStart 可能会失败。要修复此问题，请执行以下操作：

  1. 导航到您的 devfile。

  2. 在您的 devfile 中，更新至精细映像版本，而不是 latest。其内容可能与以下内容类似：

    components:
  - container:
      image: public.ecr.aws/amazonlinux/universal-image:1.0

  3. 使用更新后的 devfile 创建新的开发环境。