排查开发环境的问题
要排查与开发环境相关的问题,请参阅以下部分。有关开发环境的更多信息,请参阅在 CodeCatalyst 中使用开发环境编写和修改代码。
主题
由于出现配额问题,我无法创建开发环境
问题:我要在 CodeCatalyst 中创建一个开发环境,但显示了一个错误。控制台中的开发环境页面上显示一条消息,指示我已达到空间的存储限制。
可能的修复方法:根据您在项目或空间中的角色,您可以删除自己的一个或多个开发环境,或者如果您具有空间管理员角色,则可以删除其他用户创建的未使用的开发环境。您也可以决定将计费等级更改为一个包含更多存储空间的计费等级。
要查看存储限制,请查看 Amazon CodeCatalyst 空间的账单选项卡,以确定用量配额是否已达到允许的最大值。如果配额已达到最大值,请联系具有空间管理员角色的人员以移除不需要的开发环境或考虑更改计费等级。
要移除您创建的不再需要的任何开发环境,请参阅删除开发环境。
如果问题仍然存在,并且您的 IDE 中出现错误,请检查您是否具有让您能够创建开发环境的 CodeCatalyst 角色。空间管理员角色、项目管理员角色和贡献者角色都有创建开发环境所需的权限。有关更多信息,请参阅使用用户角色授予访问权限。
我无法将更改从开发环境推送到存储库中的特定分支
问题:我要将开发环境中的代码更改提交并推送到源存储库中的分支,但显示一个错误。
可能的修复方法:根据您在项目或空间中的角色,您可能无权将代码推送到项目中的源存储库。空间管理员角色、项目管理员角色和贡献者角色都有权将代码推送到项目中的存储库。
如果您具有贡献者角色但无法将代码推送到特定分支,则可能为该特定分支配置了一个分支规则,该规则禁止具有此角色的用户将代码推送到该特定分支。尝试将更改推送到其他分支,或者创建一个分支,然后将代码推送到该分支。有关更多信息,请参阅使用分支规则管理分支允许的操作。
我的开发环境未恢复
问题:我的开发环境在停止后未恢复。
可能的修复方法:要修复此问题,请查看 Amazon CodeCatalyst 空间的账单选项卡,以确定用量配额是否已达到最大限制。如果配额已达到最大限制,请联系您的空间管理员来提高计费等级。
我的开发环境已断开连接
问题:我的开发环境在使用期间断开连接。
可能的修复方法:要修复此问题,请检查您的 Internet 连接。如果您未连接到 Internet,请连接开发环境并继续工作。
我的与 VPC 连接的开发环境出现问题
问题:我将 VPC 连接关联到我的开发环境,但出现错误。
可能的修复方法:Docker 使用了一种名为网桥网络的链路层设备,它使连接到同一网桥网络的容器能够进行通信。默认网桥通常使用 172.17.0.0/16
子网进行容器联网。如果环境实例的 VPC 子网使用的地址范围与 Docker 使用的相同,则可能会出现 IP 地址冲突。要解决由 Amazon VPC 和使用相同的 IPv4 CIDR 地址块的 Docker 导致的 IP 地址冲突,请配置一个与 172.17.0.0/16
中的 CIDR 块不同的 CIDR 块。
注意
您不能更改现有 VPC 或子网的 IP 地址范围。
我找不到我的项目位于哪个目录
问题:我找不到我的项目位于哪个目录
可能的修复方法:要找到您的项目,请将目录更改为 /projects
。您可以在此目录中找到您的项目。
我无法通过 SSH 连接到我的开发环境
要排查通过 SSH 与开发环境建立的连接的问题,您可以执行带 -vvv
选项的 ssh
命令,以显示有关如何解决问题的更多信息:
ssh -vvv codecatalyst-dev-env=
<space-name>
=<project-name>
=<dev-environment-id>
我无法通过 SSH 连接到我的开发环境,因为我的本地 SSH 配置缺失
如果本地 SSH 配置(~/.ssh/config
)缺失或 Host codecatalyst-dev-env*
部分的内容已过期,则您将无法通过 SSH 连接到您的开发环境。要解决此问题,请删除 Host codecatalyst-dev-env*
部分并重新从 SSH 访问权限模式执行第一条命令。有关更多信息,请参阅使用 SSH 连接到开发环境。
我无法通过 SSH 连接到我的开发环境,因为我的 codecatalyst
个人资料的 AWS Config 有问题
确保您的 codecatalyst
个人资料的 AWS Config(~/.aws/config
)与设置 AWS CLI 以与 CodeCatalyst 结合使用中描述的项相匹配。如果不是这样,请删除 codecatalyst
的个人资料并重新从 SSH 访问权限模式执行第一条命令。有关更多信息,请参阅使用 SSH 连接到开发环境。
当我使用单点登录账户登录 CodeCatalyst 时,无法创建开发环境
问题:当我以 SSO 用户身份登录 CodeCatalyst 控制台时,我在选择在空间中创建开发环境时收到一个未知的异常错误。当我选择创建开发环境并选择 IDE 以进行访问(例如 AWS Cloud9)时,我遇到了与以下内容类似的问题:
-
CodeCatalyst 控制台中的开发环境页面在列表中显示带
FAILED
状态的开发环境。 -
这将显示一条与以下内容类似的错误消息:
An unknown exception happened
We encountered an unknown exception when launching your Dev Environment. Mention your Dev Environment id
error_message_ID
if you want to report or need any help.
可能的修复方法:
开发环境不适用于将 Active Directory 用作身份提供商的空间中的用户。该空间的管理员可以使用其他身份提供商来访问开发环境,例如 IAM Identity Center。有关规划支持身份联合验证的空间的更多信息,请参阅《CodeCatalyst Administrator Guide》中的 Planning your space that supports identity federation。