Cloud Code for Cloud Shell の制限事項

最新リリースの Cloud Code が統合された Cloud Shell には、次の既知の制限事項があります。

使用量の割り当て

Cloud Code のデフォルトでは、1 週間の割り当ては 50 時間です。

1 週間の Cloud Code の割り当ての表示

割り当てに達した場合は、指定された日時まで待ってから、Cloud Code を再び使用するか、Cloud Code 管理者に割り当てを増加できるかどうか確認する必要があります。

1 週間の割り当てを確認するには:

• [セッション情報] をクリックし、[使用量の割り当て] をクリックします。ダイアログが開き、割り当ての残り時間、割り当ての合計時間数、割り当てのリセット日時が表示されます。

割り当ての増加リクエスト

週単位の使用制限がない Cloud Workstations にアップグレードすることを強くおすすめします。Cloud Workstations を使用すると、開発環境をカスタマイズ、適正化、保護できます。Cloud Workstations にアップグレードして、VPC にプロビジョニングされたマネージド セキュア開発環境を、使用量の上限なしで利用できます。

Cloud Shell の割り当ては特定のケースでのみ増やすことができます。また、カスタマー サポート リクエストを通じて行う必要があります。Cloud Shell の割り当ては、Google Cloud コンソールを使用して更新できません。割り当ての増加をリクエストするには、（課金ではなく）Cloud カスタマーケアにお問い合わせください。

割り当ての増加リクエストに対して承認が必要な場合は、リクエストの受領確認メールを Google Cloud から受け取ることができます。サポートが必要な場合は、このメールに返信してください。Cloud カスタマーケアでリクエストが処理され（通常は 2～3 営業日以内）、割り当ての増加が承認されたかどうかが通知されます。このメールには発効日が記載されています（該当する場合）。

割り当ての増加プロセスの詳細については、割り当ての増加リクエストについてをご覧ください。

Cloud Code の長期不使用

$HOME ディレクトリが 120 日間不使用だったために削除されるのを防止するには、セッションを開始してください。長期間保存する必要がある機密データについては、Cloud Storage の別のソリューションの使用を検討してください。

非対話型の使用

Cloud Code は、インタラクティブな使用のみを想定しています。非対話型セッションは、40 分後に自動的に終了します。Cloud Code セッションは 12 時間に制限されていて、時間が経過するとセッションは自動的に終了します。その後すぐに新しいセッションを開始できます。

サービス制限違反後にセッションを復元する

サービスの限度を越えたためにセッションが終了した場合、またはセッションが確立できなかった場合、Cloud Code は、エラー メッセージとともに、限度違反に対する申し立てフォームへのリンクを表示します。フィードバックのリンクをクリックし、セッションが終了する前に実行しようとしていたタスクについての詳しい情報をフォームに記して提出します。

制限事項

カスタム インストールされたソフトウェアのパッケージと永続性

Cloud Shell の Cloud Code セッションを支える仮想マシン インスタンスは、Cloud Code セッションに永続的に割り当てられているわけではなく、セッションが 20 分間の非アクティブになると終了します。インスタンスが終了すると、$HOME 以外で行った修正はすべて失われます。

セッション間で構成を維持するには、環境のカスタマイズを検討してください。

18 歳未満または年齢が不明なユーザー

18 歳未満または年齢が不明なユーザーは Cloud Code を使用できません。Google Workspace for Education のデフォルトでは、すべてのユーザーに対して Cloud Code へのアクセスがブロックされます。教育機関に 18 歳以上の学生がいて、Cloud Code などの年齢制限のあるサービスへのアクセスを割り当てる場合、18 歳以上のユーザーを特定する手順については、Google サービスへのアクセスを年齢で制御するをご覧ください。

Cloud Shell エディタの拡張機能

Cloud Shell エディタでは、カスタム エディタ拡張機能のインストールがサポートされていません。ただし、Cloud Shell エディタには、一連の必要な拡張機能がすでにインストールされており、最新の状態に保たれています。

.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 秒かかります。それ以降、既存の仮想マシン インスタンスとの接続時間は、およそ 5 秒程度になります。ただし、Cloud Code を 1 週間使用しなかった場合は、ホーム ディレクトリがアーカイブから復元されるため、接続速度が遅くなります。

Cloud Code には、永続ディスク ストレージのない Cloud Code のエクスペリエンスであるエフェメラル モードも用意されています。一時的ログインモードを使用すると、接続パフォーマンスは速くなりますが、セッションで作成したファイルは、セッション終了時にすべて失われます。

ブラウザのサポート

Cloud Code では、Google Chrome、Mozilla Firefox、Microsoft Edge、Microsoft Internet Explorer 11 以降、Apple Safari 8 以降の最新バージョンがサポートされています。シークレット ブラウジング モードの Safari はサポートされていません。

シークレット ブラウジングと無効化されたサードパーティの Cookie

サードパーティの Cookie が無効になっていると、Cloud Shell エディタは Cloud Shell に読み込めません。一部のブラウザでは、サードパーティの Cookie はデフォルトで無効になっています。また、ほとんどのブラウザのシークレット モードやプライベート ブラウザ モードでも Cookie がブロックされます。

サードパーティの Cookie が無効になっていても、エディタ セッション（）を開いたときに [新しいウィンドウで開く] ボタンをクリックすると、別のウィンドウで Cloud Shell エディタを使用できます。

また、ウェブ プレビュー を使用して、ポート 970 に移動することもできます。

ヒント: Google Chrome を使用している場合は、アドレスバーにあるサードパーティの Cookie ブロック アイコン（）をクリックして、[サイトが動作していない場合] を選択し、[Cookie を許可] をクリックしてページを再読み込みすることで、サードパーティの Cookie を有効にできます。

ディスク ストレージ

Cloud Code では、仮想マシン インスタンスで $HOME ディレクトリとして使える 5 GB の無料永続ディスク ストレージが用意されています。このストレージは、ユーザーごとに割り当てられ、複数のプロジェクトを横断して使用することができます。インストール済みのソフトウェア、スクリプト、.bashrc や .vimrc などのユーザー構成ファイルなど、ホーム ディレクトリに保存されているファイルはすべて、セッション間で維持され、最大 5 GB までカウントされます。

ディスクの空き容量の確保

no space left on device エラーが発生した場合は、Cloud Code ターミナルを使用してホーム ディレクトリからファイルを削除して、空き容量を確保してください。du -hs $(ls -A) コマンドを使用して、各サブディレクトリ内で各ファイルが使用しているスペースを確認します。不要になったものや、ストレージを大量に消費するものを削除することを検討してください。