Cloud Code for VS Code 拡張機能により、VS Code に Google Cloud 開発のサポートが追加されます。
始める前に
Cloud Code をインストールする前に、次のツールがシステムにインストールされ、設定されていることを確認します。
- マシンに Visual Studio Code をインストールして設定する。
言語サポートをインストールして構成する。
Cloud Code 拡張機能は次の言語で最も効果的に機能します。
Git をインストールします。 サンプルをマシンにコピーするには Git が必要です。
Docker クライアントをインストールし、
PATH環境変数に追加します。- Cloud Build または Jib のみを使用して構築する場合は、Docker のインストールをスキップできます。
- Windows Home を使用している場合、Docker クライアントの設定手順については、Windows Home 用 Docker デスクトップのガイドをご覧ください。
- WSL を使用しているものの、デスクトップ用の Docker をインストールできない場合は、代わりに Cloud Code でのローカル開発に minikube を使用してください。
Google Cloud を使用している場合は、Google Cloud プロジェクトを作成してから、課金を有効にします。
プロジェクトを使用すると、1 つのアプリケーションの関連リソースを 1 か所に集約し、API を管理して、Google Cloud サービスを有効化し、共同編集者の追加と削除を行い、Google Cloud リソースに対する権限を管理できます。
Cloud Code をインストールする
Visual Studio Code Marketplace から Google Cloud Code 拡張機能をインストールします。
または、以下の手順で、VS Code で [拡張機能] ビューを開きます。
[拡張機能] をクリックするか、Ctrl/Cmd+Shift+Xキーを押します。Google Cloud Codeを検索します。
[インストール] をクリックします。
プロンプトが表示されたら、VS Code を再起動します。
拡張機能が正常にインストールされると、Cloud Code のアイコンがアクティビティ バーに追加され、使用できるようになります。Cloud Code のインストールをさらに構成するには、最上位のアプリケーション タスクバーを使用して[Code] >設定 >設定 >拡張機能に移動し、
Gemini Code Assist + Google Cloud Codeを検索し、設定を指定します。
依存関係のカスタム バージョン
Cloud Code では、自動依存関係がデフォルトで有効になっており、一部のコマンドライン依存関係が自動的にインストールされます。自動依存関係を無効にした場合、カスタム バージョンの依存関係を使用できますが、Cloud Code が機能するには、依存関係を自分でインストールする必要があります。
Cloud Code 依存関係のカスタム バージョンを使用するには、次のようにします。
設定 [Manage] > [Settings] をクリックし、[Auto Dependencies]（
cloudcode.autoDependencies）をoffに設定します。PATHに次の依存関係をインストールします。
Google Cloud CLI をインストールする
gcloud CLI を必要とする機能を初めて使用する場合、IDE から CLI をインストールする方法、既存のインストール方法を使用する方法、マネージド依存関係で続行する方法を選択できます。gcloud CLI を手動でインストールする場合は、gcloud CLI をインストールするをご覧ください。
省略可: VsixSignTool を使用して Cloud Code vsix を検証する
VsixSignTool を使用して Cloud Code Vix を検証するには、次の手順を実行します。
以下を使用していることを確認します。
- NuGet パッケージ マネージャー
- Windows OS
- Cloud Code の本番環境リリース
Microsoft VsixSignTool をインストールし、インストール パスをメモします。
VS Code を開き、
[拡張機能] > [Cloud Code] に移動します。[詳細] タブの [拡張機能のリソース] で、[Marketplace] をクリックします。
ブラウザの Marketplace ページの [リソース] で [拡張機能をダウンロード] をクリックして、パッケージ化されたバージョンの Cloud Code をダウンロードします。
.vsixファイル拡張子を持つパッケージ化されたバージョンの Cloud Code が、デフォルトのダウンロード ディレクトリにダウンロードされます。最新バージョンとは異なるバージョンを検証する場合は、[変更履歴] タブをクリックして、別のバージョンを選択してダウンロードします。
ダウンロードが完了したら、ターミナル ウィンドウを開き、次のコマンドを実行します。
PATH_TO_VSIXSIGNTOOL verify PATH_TO_DOWNLOADED_VSIX出力が以下と一致していることを確認します。
VsixSignTool Success: Package PATH_TO_DOWNLOADED_VSIX is valid.
Google Cloud の認証情報を認証する
Google Cloud API を使用してアプリケーション開発をサポートするため、gcloud CLI にサインインすると、アプリケーションのデフォルト認証情報が更新されます。
Google Cloud にログインする
Google Cloud にログインしていない場合は、次の手順でログインします。
- Cloud Code のステータスバーで [Cloud Code - ログイン] をクリックします。
IDE で初めて Google Cloud に接続する場合は、信頼できるドメインに
https://accounts.google.comを追加するよう求められます。表示されるダイアログで [信頼できるドメインの構成] をクリックします。![[信頼できるドメインの構成] ダイアログ](https://cloud.google.com/static/code/docs/vscode/images/configure-trusted-domains.png?authuser=0&hl=ja)
プロンプトに従い、ウェブブラウザを使用してサインインします。
Cloud Code に Google アカウントへのアクセスを許可するように求められたら、[許可] をクリックします。
既知の問題: 認証コールバック時に Edge ブラウザが HTTPS にリダイレクトする
Microsoft Edge ブラウザを使用して認証情報を認証する場合に、Edge ブラウザが URL http://localhost:3000 を https://localhost:3000 にリダイレクトすることがあります。これにより、次のエラー メッセージが表示されます。
The connection for this site is not secure. localhost sent an invalid response.
Try running Windows Network Diagnostics. ERR_SSL_PROTOCOL_ERROR.
この問題を解決するには、次の手順で、リダイレクトから localhost を除外します。
Edge ブラウザのアドレスバーに「
edge://net-internals/#hsts」と入力します。ドメイン セキュリティ ポリシーを削除するセクションに移動します。
「
localhost」と入力して [削除] をクリックします。
Google Cloud からログアウトする
[Cloud Code] をクリックし、[ヘルプとフィードバック] を展開します。- [Google Cloud からログアウト] をクリックし、メッセージが表示されたら [ログアウト] を選択します。
- または、コマンド パレットを使用してログアウトすることもできます。
Ctrl/Cmd+Shift+Pをクリックするか、[表示] > [コマンド パレット] をクリックして、Google Cloud SDK のすべてのアカウントからログアウト をクリックします。
アクティブな Google Cloud プロジェクトを変更する
Cloud Code ステータスバーで、アクティブなプロジェクト名をクリックします。
表示されたクイック選択ツールで、sync_alt [プロジェクトを切り替え] を選択します。
プロジェクトを選択するか、検索バーにキーワードを入力してプロジェクトをフィルタします。
ローカルでアプリケーションをデバッグするための認証情報を認証する
Google Cloud にサインインするセクションの認証手順に加えて、Google API 呼び出しを行う IDE でアプリケーションをローカルにデバッグするための認証情報を認証する必要があります。
アプリケーションをデバッグするための認証情報を認証しないと、Google API の呼び出しを試行するローカル アプリケーションを実行 / デバッグしようとしたときに IDE にエラー メッセージが表示されます。
アプリケーションをローカルでデバッグするための認証情報を認証するには、次の手順を行います。
マシンに gcloud をインストールします（まだインストールしていない場合）。
次のコマンドを実行します。
gcloud auth application-default loginローカルでのデバッグが終了したら、次のコマンドを実行してログアウトできます。
gcloud auth application-default revoke
アプリケーションのデフォルト認証情報と Google API の詳細については、クライアント ライブラリを使用した Cloud サービスの認証を行うをご覧ください。