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を検索します。
[Install] をクリックします。
プロンプトが表示されたら、VS Code を再起動します。
拡張機能が正常にインストールされたら、Cloud Code のアイコンがアクティビティ バーに追加され、使用できるようになります。Cloud Code のインストールをさらに構成するには、最上位のアプリケーション タスクバー（[Code] > [Preferences] > [Settings] > [Extensions] > [Cloud Code]）を使用して設定を指定します。
依存関係のカスタム バージョン
Cloud Code では、自動依存関係がデフォルトで有効になっており、一部のコマンドライン依存関係が自動的にインストールされます。自動依存関係をオフにすると、依存関係のカスタム バージョンを使用できますが、Cloud Code が機能するためには依存関係を自分でインストールする必要があります。
Cloud Code 依存関係のカスタム バージョンを使用するには:
- 設定 [Manage] > [Settings] をクリックし、[Auto Dependencies]（
cloudcode.autoDependencies）をoffに設定します。 PATHに次の依存関係をインストールします。- kubectl
- Skaffold
- minikube: ローカル開発用
- Google Cloud CLI（Google Cloud で開発する場合）
省略可: 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?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] をクリックし、[Help and Feedback] を展開します。- [Sign Out of Google Cloud] をクリックし、プロンプトが表示されたら [Sign-out] を選択します。
- または、コマンド パレットを使用してログアウトすることもできます。
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 サービスの認証を行うをご覧ください。