.NET 開発環境の設定

このチュートリアルでは、Google Cloud で実行され、Google Cloud API を呼び出す .NET および .NET core アプリを開発するために、ローカル マシンを準備する方法を示します。

開発環境のインストール

このドキュメントで説明する .NET チュートリアルとサンプル アプリを実行するために推奨される開発環境は、Visual Studio 2017 または Visual Studio Code です。

Google Cloud プロジェクトを作成する

アプリを実行するための Google Cloud プロジェクトを作成します。Google Cloud プロジェクトは、すべての Google Cloud サービスを作成、有効化、使用するための基礎を形成します。

認証

ローカルでの開発中、.NET アプリは、Google Cloud API とやりとりを行うためにアプリ自体を認証する必要があります。次の手順では、アプリを認証するためのサービス アカウント キーを作成する方法について説明します。アプリは、Google Cloud にデプロイされたとき、この方法を使用してローカルで認証できます。アプリのデプロイ後の認証の処理方法などの詳細については、認証をご覧ください。

認証用のサービス アカウントキーの作成

Cloud Console

  1. Cloud Console で、[サービス アカウント キーの作成] ページに移動します。

    [サービス アカウントキーの作成] ページに移動
  2. [サービス アカウント] リストから [新しいサービス アカウント] を選択します。
  3. [サービス アカウント名] フィールドに名前を入力します。
  4. [役割] リストで、[プロジェクト] > [オーナー] を選択します。

    : [役割] フィールドの設定により、リソースにアクセスするサービス アカウントが承認されます。このフィールドは、Cloud Console を使用して後から表示および変更できます。本番環境アプリケーションを開発している場合は、[プロジェクト] > [オーナー] よりも詳細な権限を指定します。詳しくはサービス アカウントへの役割の付与をご覧ください。
  5. [作成] をクリックします。キーが含まれている JSON ファイルがパソコンにダウンロードされます。

コマンドライン

ローカルマシン上の Cloud SDK を使用するか、または Cloud Shell 内で以下のコマンドを実行できます。

  1. サービス アカウントを作成します。[NAME] をサービス アカウントの名前に置き換えます。

    gcloud iam service-accounts create [NAME]
  2. サービス アカウントに権限を付与します。[PROJECT_ID] は実際のプロジェクト ID に置き換えます。

    gcloud projects add-iam-policy-binding [PROJECT_ID] --member "serviceAccount:[NAME]@[PROJECT_ID].iam.gserviceaccount.com" --role "roles/owner"
    : [役割] フィールドの設定により、リソースにアクセスするサービス アカウントが承認されます。このフィールドは、後で Cloud Console を使用して表示および変更できます。本番環境アプリケーションを開発している場合は、[プロジェクト] > [オーナー] よりも詳細な権限を指定します。詳しくは、サービス アカウントへのロールの付与をご覧ください。
  3. キーファイルを生成します。[FILE_NAME] はキーファイルの名前に置き換えます。

    gcloud iam service-accounts keys create [FILE_NAME].json --iam-account [NAME]@[PROJECT_ID].iam.gserviceaccount.com

次に、環境変数 GOOGLE_APPLICATION_CREDENTIALS を、ダウンロードした JSON キーのパスに設定します。PowerShell で次のコマンドを実行します。

この PowerShell セッションでは、以下のコマンドを実行します。

PS > $env:GOOGLE_APPLICATION_CREDENTIALS = "$env:USERPROFILE\Downloads\your-project-id-dea9fa230eae3.json"

このコマンドを実行した後に作成されるすべてのプロセスでは、以下のコマンドを実行します。

PS > [Environment]::SetEnvironmentVariable("GOOGLE_APPLICATION_CREDENTIALS", "$env:USERPROFILE\Downloads\your-project-id-dea9fa230eae3.json", "User")

(オプション).NET ツールと SDK のインストール

Google Cloud Console を使用すると、ウェブブラウザを介して Google Cloud リソースを作成して管理できますが、Visual Studio 内またはコマンドラインから Google Cloud リソースを管理したい場合は、次のツールのインストールを検討できます。

  • Cloud SDK: Cloud SDK は、Google Cloud のプロダクトとサービス用のコマンドライン インターフェースです。

  • Tools for Visual Studio: Tools for Visual Studio は、Google Cloud 上の Visual Studio での開発を可能にします。

  • Tools for PowerShell: Tools for PowerShell は、Google Cloud リソースを管理できる Windows PowerShell のコマンドレットのセットです。

次のステップ