本页面介绍您在使用 Cloud Workstations 时可能会遇到的已知问题。
由于 Compute Engine 资源短缺,无法启动工作站
如果 Compute Engine 出现工作站配置中指定的机器类型资源短缺(缺货)的情况,您可能无法启动工作站。如需解决此问题,请尝试以下策略之一:
- 将工作站配置中的机器类型更改为在您所在区域有可用容量的机器类型。
- 预留容量为所选 机器类型。Cloud Workstations 会自动使用预留,您也可以将该服务配置为使用特定预留。
- 使用 提升模式功能在配置中指定其他机器类型。这样,您的开发者在启动工作站时就可以选择在您所在区域有容量的机器类型。
Workbench 无法连接到服务器
此错误表示编辑器无法与基本编辑器建立 WebSocket 连接。这通常是由于中间代理或网络配置阻止 WebSocket 流量或阻止流向 *.cloudworkstations.dev 网域的流量造成的。
如果您不确定如何解决流量问题,请与您的网络管理员联系。
连接到已停止的工作站
如果您无法连接到已停止的工作站,请查看工作站集群设置。如需让 Cloud Workstations 在您连接时自动重启已停止的 工作站,您必须将工作站集群配置为使用 默认 Google Cloud 控制台启动器。如需了解详情,请参阅 自动重启已停止的工作站。
停用 Cloud Workstations API 不会删除 Cloud Workstations 资源
停用 Cloud Workstations API 不会删除 Cloud Workstations 资源。 为避免产生费用,您必须删除底层 Cloud Workstations 资源。
在工作站配置中设置的环境变量未在 SSH 会话中设置
默认情况下,在工作站配置或工作站级别设置的环境变量 不会在 SSH 会话中设置,而是需要使用 自定义映像。
基于 IntelliJ IDEA 的 IDE
由于 JetBrains Gateway 存在限制,因此基于 IntelliJ IDEA 的 IDE 扩展程序的以下功能 不可用 :
- 在 Kubernetes 上调试
- 调试在本地运行的 Cloud Run 服务
Google Cloud CLI 找不到我的命令
如果 gcloud CLI 找不到您的命令,请更新到当前版本:
gcloud components update
此外,请确保您使用的是最新的 Cloud Workstations gcloud CLI 语法。
如需帮助,请参阅
gcloud workstations --help.
如 gcloud CLI
发布级别中所述,Alpha 版和 Beta 版命令可能会发生变化
,恕不另行通知。
从区域级永久性磁盘切换到 Hyperdisk
创建工作站配置后,无法将工作站配置从区域级永久性磁盘切换到 Hyperdisk。 如需切换工作站的备份主磁盘,您必须使用 Hyperdisk 创建新配置,然后手动 将工作站克隆到新配置。
APT 代码库 GPG 密钥过期或轮替错误
在工作站
容器内运行 apt-get update 或安装软件包时,您可能会遇到 GPG 密钥错误,例如 KEYEXPIRED 或
NO_PUBKEY KEY_ID。当上游第三方代码库所有者(例如 Yarn、NodeSource 或 Microsoft)以带外方式更新或轮替其签名密钥时,就会发生这种情况。
如需更新容器中预安装的 APT 代码库密钥,请运行密钥刷新脚本:
sudo /google/scripts/refresh-preinstalled-apt-keys.sh
您还可以在运行 apt-get update 或 apt-get install 之前,直接在自定义 Dockerfile 中运行此脚本。如需了解详情,请参阅更新预配置的安全 APT 密钥。