Cloud Code for VS Code 拡張機能をインストールする

Cloud Code for VS Code 拡張機能により、VS Code に Google Cloud 開発のサポートが追加されます。

始める前に

Cloud Code をインストールする前に、次のツールがシステムにインストールされ、設定されていることを確認します。

  1. マシンに Visual Studio Code をインストールして設定する。
  2. 言語サポートをインストールして構成する。

    Cloud Code 拡張機能は次の言語で最も効果的に機能します。

    • NodeJS(組み込みサポート、アクション不要)
    • Go
    • Python
    • Java
    • .NET
  3. Git をインストールします。 サンプルをマシンにコピーするには Git が必要です。

  4. Docker クライアントをインストールし、PATH 環境変数に追加します。

    • Cloud Build または Jib のみを使用して構築する場合は、Docker のインストールをスキップできます。
    • Windows Home を使用している場合、Docker クライアントの設定手順については、Windows Home 用 Docker デスクトップのガイドをご覧ください。
    • WSL を使用しているものの、デスクトップ用の Docker をインストールできない場合は、代わりに Cloud Code でのローカル開発に minikube を使用してください。
  5. Google Cloud を使用している場合は、Google Cloud プロジェクトを作成してから、課金を有効にします

    プロジェクトを使用すると、1 つのアプリケーションの関連リソースを 1 か所に集約し、API を管理して、Google Cloud サービスを有効化し、共同編集者の追加と削除を行い、Google Cloud リソースに対する権限を管理できます。

Cloud Code をインストールする

Visual Studio Code Marketplace から Google Cloud Code 拡張機能をインストールします。

または、以下の手順で、VS Code で [拡張機能] ビューを開きます。

  1. 拡張機能アイコン [拡張機能] をクリックするか、Ctrl/Cmd+Shift+X キーを押します。

  2. Google Cloud Code を検索します。

    VSC マーケットプレイスの Cloud Code 拡張機能

  3. [インストール] をクリックします。

  4. プロンプトが表示されたら、VS Code を再起動します。

    拡張機能が正常にインストールされると、Cloud Code のアイコンがアクティビティ バーに追加され、使用できるようになります。Cloud Code のインストールをさらに構成するには、最上位のアプリケーション タスクバーを使用して[Code] >設定 >設定 >拡張機能に移動し、Gemini Code Assist + Google Cloud Code を検索し、設定を指定します。

依存関係のカスタム バージョン

Cloud Code では、自動依存関係がデフォルトで有効になっており、一部のコマンドライン依存関係が自動的にインストールされます。自動依存関係を無効にした場合、カスタム バージョンの依存関係を使用できますが、Cloud Code が機能するには、依存関係を自分でインストールする必要があります。

Cloud Code 依存関係のカスタム バージョンを使用するには、次のようにします。

  1. 設定 [Manage] > [Settings] をクリックし、[Auto Dependencies](cloudcode.autoDependencies)を off に設定します。

  2. PATH に次の依存関係をインストールします。

Google Cloud CLI をインストールする

gcloud CLI を必要とする機能を初めて使用する場合、IDE から CLI をインストールする方法、既存のインストール方法を使用する方法、マネージド依存関係で続行する方法を選択できます。gcloud CLI を手動でインストールする場合は、gcloud CLI をインストールするをご覧ください。

省略可: VsixSignTool を使用して Cloud Code vsix を検証する

VsixSignTool を使用して Cloud Code Vix を検証するには、次の手順を実行します。

  1. 以下を使用していることを確認します。

    • NuGet パッケージ マネージャー
    • Windows OS
    • Cloud Code の本番環境リリース
  2. Microsoft VsixSignTool をインストールし、インストール パスをメモします。

  3. VS Code を開き、VSC の拡張機能アイコン [拡張機能] > [Cloud Code] に移動します。

  4. [詳細] タブの [拡張機能のリソース] で、[Marketplace] をクリックします。

  5. ブラウザの Marketplace ページの [リソース] で [拡張機能をダウンロード] をクリックして、パッケージ化されたバージョンの Cloud Code をダウンロードします。.vsix ファイル拡張子を持つパッケージ化されたバージョンの Cloud Code が、デフォルトのダウンロード ディレクトリにダウンロードされます。

  6. 最新バージョンとは異なるバージョンを検証する場合は、[変更履歴] タブをクリックして、別のバージョンを選択してダウンロードします。

  7. ダウンロードが完了したら、ターミナル ウィンドウを開き、次のコマンドを実行します。

    PATH_TO_VSIXSIGNTOOL verify PATH_TO_DOWNLOADED_VSIX
    
  8. 出力が以下と一致していることを確認します。

    VsixSignTool Success: Package PATH_TO_DOWNLOADED_VSIX is valid.

Google Cloud の認証情報を認証する

Google Cloud API を使用してアプリケーション開発をサポートするため、gcloud CLI にサインインすると、アプリケーションのデフォルト認証情報が更新されます。

Google Cloud にログインする

Google Cloud にログインしていない場合は、次の手順でログインします。

  1. Cloud Code のステータスバーで [Cloud Code - ログイン] をクリックします。
  2. IDE で初めて Google Cloud に接続する場合は、信頼できるドメインに https://accounts.google.com を追加するよう求められます。表示されるダイアログで [信頼できるドメインの構成] をクリックします。

    [信頼できるドメインの構成] ダイアログ

  3. プロンプトに従い、ウェブブラウザを使用してサインインします。

  4. Cloud Code に Google アカウントへのアクセスを許可するように求められたら、[許可] をクリックします。

既知の問題: 認証コールバック時に Edge ブラウザが HTTPS にリダイレクトする

Microsoft Edge ブラウザを使用して認証情報を認証する場合に、Edge ブラウザが URL http://localhost:3000https://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 を除外します。

  1. Edge ブラウザのアドレスバーに「edge://net-internals/#hsts」と入力します。

  2. ドメイン セキュリティ ポリシーを削除するセクションに移動します。

  3. localhost」と入力して [削除] をクリックします。

Google Cloud からログアウトする

  1. [Cloud Code] をクリックし、[ヘルプとフィードバック] を展開します。
  2. [Google Cloud からログアウト] をクリックし、メッセージが表示されたら [ログアウト] を選択します。
  3. または、コマンド パレットを使用してログアウトすることもできます。Ctrl/Cmd+Shift+P をクリックするか、[表示] > [コマンド パレット] をクリックして、Google Cloud SDK のすべてのアカウントからログアウト をクリックします。

アクティブな Google Cloud プロジェクトを変更する

  1. Cloud Code ステータスバーで、アクティブなプロジェクト名をクリックします。

    ステータスバーに表示されるアクティブなプロジェクト名

  2. 表示されたクイック選択ツールで、sync_alt [プロジェクトを切り替え] を選択します。

  3. プロジェクトを選択するか、検索バーにキーワードを入力してプロジェクトをフィルタします。

ローカルでアプリケーションをデバッグするための認証情報を認証する

Google Cloud にサインインするセクションの認証手順に加えて、Google API 呼び出しを行う IDE でアプリケーションをローカルにデバッグするための認証情報を認証する必要があります。

アプリケーションをデバッグするための認証情報を認証しないと、Google API の呼び出しを試行するローカル アプリケーションを実行 / デバッグしようとしたときに IDE にエラー メッセージが表示されます。

アプリケーションをローカルでデバッグするための認証情報を認証するには、次の手順を行います。

  1. マシンに gcloud をインストールします(まだインストールしていない場合)。

  2. 次のコマンドを実行します。

    gcloud auth application-default login
    
  3. ローカルでのデバッグが終了したら、次のコマンドを実行してログアウトできます。

    gcloud auth application-default revoke
    

アプリケーションのデフォルト認証情報と Google API の詳細については、クライアント ライブラリを使用した Cloud サービスの認証を行うをご覧ください。

次のステップ

サポートを利用する

フィードバックを送信するには、GitHub で問題を報告します。または、Stack Overflow で質問します。