Cloud Code for Cloud Shell 的局限和限制

从最新版本开始,集成了 Cloud Code 的 Cloud Shell 具有以下已知局限和局限性。

用量配额

Cloud Code 每周的默认配额为 50 小时。

查看您的每周 Cloud Code 配额

如果您已达到配额,则需要等到指定的日期和时间后,才能再次使用 Cloud Code,或者咨询您的 Cloud Code 管理员以提高配额。

如需查看您的每周配额,请执行以下操作:

  • 点击 会话信息 会话信息,然后点击用量配额。系统会显示一个对话框,并显示配额中的剩余小时数、配额中的总时长,以及配额重置的日期和时间。

申请增加配额

Cloud Shell 配额增加必须通过客户服务申请增加,且无法使用 Google Cloud 控制台进行更新。如需申请增加配额,请与 Cloud Customer Care 团队联系(而非“结算”)。

如果您的配额提升请求需要批准,则您可能需要收到来自 Google Cloud 的电子邮件,以确认收到您的请求。如需进一步的帮助,您可以回复此电子邮件。Cloud Customer Care 通常会在 2-3 个工作日内处理您的申请,然后向您发送电子邮件,告知您配额提升是否获得批准。该电子邮件会提供提升的有效日期(如果适用)。

如需详细了解配额增加流程,请参阅关于增加配额请求

Cloud Code 非活跃

为防止您的 $HOME 目录因 120 天不活动而被删除,请启动一个会话。对于要长期存储的敏感数据,请考虑 Cloud Storage 上的其他解决方案。

非交互式用法

Cloud Code 仅适用于交互式使用。非交互式会话会在一小时后自动结束。Cloud Code 会话的上限为 12 小时,之后会话会自动终止。您可以随后立即启动新会话。

在违反服务限制后恢复会话

如果您的会话因超出服务限制而终止或无法建立,Cloud Code 则会显示错误,其中包含一个链接,您可以通过该链接就限制违规行为提出申诉。点击反馈链接,在表单中填写会话终止前您正在执行的操作的详情并提交表单。

局限和限制

自行安装的软件包和持久性

为 Cloud Code for Cloud Shell 会话提供支持的虚拟机实例不会永久分配给 Cloud Code 会话,并且会在该会话处于非活动状态 20 分钟后终止。实例终止后,您在 $HOME 目录之外对其所做的任何修改都将丢失。

如需使您的配置在各个会话中保留,请考虑自定义您的环境

未满 18 周岁或年龄未知的用户

Cloud Code 不适用于未满 18 周岁或年龄未知的用户。默认情况下,Google Workspace 教育版会禁止所有用户访问 Cloud Code。如果您所在机构的学生年龄超过 18 周岁,并且想要使用包括 Cloud Shell 在内的有年龄限制的服务,请参阅按年龄控制对 Google 服务的访问权限,以了解识别年满 18 周岁的用户的步骤。

Cloud Shell Editor 扩展程序

Cloud Shell Editor 不支持安装自定义编辑器扩展程序。但是,Cloud Shell Editor 自带一组必备扩展程序,并且已经安装最新版本。

.bashrc 内容

如果 .bashrc 文件已修改或删除,Cloud Code 可能会产生错误。.bashrc 文件必须包含以下行:

  if [ -f "/google/devshell/bashrc.google" ]; then
    source "/google/devshell/bashrc.google"
  fi

gcloud 输出格式

默认情况下,Cloud Code 会启用 gcloud 无障碍功能。启用无障碍功能后,gcloud 表输出会呈现为展平化的项列表。

如需恢复许多命令的框表默认行为,请将以下命令附加到 $HOME/.bashrc 文件的末尾:

  gcloud config set accessibility/screen_reader false

连接缓慢

首次连接 Cloud Code 时,系统需要为您创建主磁盘,目前最长可能需要 25 秒的时间。此后再与现有虚拟机实例连接时,需要大约五秒钟的时间。但是,如果您不使用 Cloud Code 的时间达到一周,则连接性能将会变慢,因为需要从归档恢复主目录。

Cloud Code 还提供暂存模式,即没有永久性磁盘存储空间的 Cloud Code 体验。临时模式可提供更快的连接性能,但在会话期间创建的所有文件都会在会话结束时丢失。

浏览器支持

Cloud Code 支持最新版本的 Google Chrome、Mozilla Firefox、Microsoft Edge、Microsoft Internet Explorer 11+ 和 Apple Safari 8+。但不支持 Safari 的无痕浏览模式。

无痕浏览并停用第三方 Cookie

如果停用了第三方 Cookie,则无法在 Cloud Code 中加载 Cloud Shell Editor。有些浏览器默认停用了第三方 Cookie,而大多数浏览器的无痕模式或无痕浏览器模式也会屏蔽这些 Cookie。

在停用第三方 Cookie 的情况下,您仍然可以在独立的窗口中使用 Cloud Shell 编辑器,方法是点击在打开编辑器会话时可访问的在新窗口中打开按钮 代码编辑器按钮

或者,您也可以使用网页预览 网页预览按钮 转到端口 970。

编辑器面板会说明由于屏蔽第三方 Cookie 而无法加载代码编辑器,同时提供在新窗口中打开编辑器的链接

提示:如果您使用的是 Google Chrome,则可通过执行以下操作来启用第三方 Cookie:点击地址栏中的第三方 Cookie 屏蔽图标 第三方 Cookie 屏蔽图标,选择网站无法正常运行?,点击允许使用 Cookie,然后重新加载页面。

磁盘存储

Cloud Code 免费预配 5 GB 的永久性磁盘存储空间,装载为您在虚拟机实例上的 $HOME 目录。此存储空间按用户分配,并且可以供多个项目使用。您存储在主目录中的所有文件(包括安装的软件、脚本以及 .bashrc.vimrc 等用户配置文件)在不同会话之间共享,并计入 5 GB 限额。

清理磁盘空间

如果遇到 no space left on device 错误,请使用 Cloud Code 终端从主目录中移除文件,以释放空间。使用 du -hs $(ls -A) 命令查看每个文件在每个子目录中的空间。请考虑移除不再需要或占用大量存储空间的插件。