.NET 向け新ライブラリ : Cloud Client Libraries for .NET 入門
2016年9月7日水曜日
* この投稿は米国時間 8 月 25 日、Developer Advocate である Mete Atamel によって投稿されたもの（投稿はこちら）の抄訳です。
私たちは先ごろ、.NET と Google Cloud Platform（GCP）を統合するための新しいツールとクライアント ライブラリを紹介しました。その中には、.NET 開発者が GCP サービスと違和感なくインタラクションを行う方法を提供する新しいクライアント ライブラリ、Google Cloud Client Libraries for .NET も含まれています。
この投稿では、.NET 向けの新しいクライアント ライブラリをプロジェクトにインストールするにはどうすればよいのかを説明します。
この新しいクライアント ライブラリは、今のところ、Google BigQuery、Google Cloud Pub/Sub、Google Cloud Storage などの GCP サービスのサブセットをサポートしています（これ以外のサービスに関しては、従来の .NET 向け Google API Client Libraries に頼る必要があります）。
両ライブラリのセットは共存することができ、新しいライブラリでサポートされるサービスが増えるにつれて、古いライブラリへの依存性は薄れていきます。
GitHub におけるこのライブラリ用のページ（google-cloud-dotnet）の Authentication（認証）の節には、さまざまなシナリオの手順の説明があります。簡単に言えば、ローカルな開発やテストのための認証を行うには、Google Cloud SDK シェルを含む Windows 用の Cloud SDK をインストールし、gcloud コマンドライン ツールを使います。
gcloud をまだ初期化していない場合には、Google Cloud SDK シェルの中で下記のコマンドを実行してプロジェクトを初期化し、その後で認証をセットアップします。
gcloud の設定が済んでいて認証だけを行いたい場合には、代わりに下記のコマンドを実行します。
私たちは先ごろ、.NET と Google Cloud Platform（GCP）を統合するための新しいツールとクライアント ライブラリを紹介しました。その中には、.NET 開発者が GCP サービスと違和感なくインタラクションを行う方法を提供する新しいクライアント ライブラリ、Google Cloud Client Libraries for .NET も含まれています。
この投稿では、.NET 向けの新しいクライアント ライブラリをプロジェクトにインストールするにはどうすればよいのかを説明します。
この新しいクライアント ライブラリは、今のところ、Google BigQuery、Google Cloud Pub/Sub、Google Cloud Storage などの GCP サービスのサブセットをサポートしています（これ以外のサービスに関しては、従来の .NET 向け Google API Client Libraries に頼る必要があります）。
両ライブラリのセットは共存することができ、新しいライブラリでサポートされるサービスが増えるにつれて、古いライブラリへの依存性は薄れていきます。
認証
この新しいクライアント ライブラリは、ご想像のとおり、人気のある .NET 向けのパッケージ マネージャである NuGet 上で公開されているので、プロジェクトに取り入れるのは非常に簡単です。ただし、利用の前に認証を設定する必要があります。GitHub におけるこのライブラリ用のページ（google-cloud-dotnet）の Authentication（認証）の節には、さまざまなシナリオの手順の説明があります。簡単に言えば、ローカルな開発やテストのための認証を行うには、Google Cloud SDK シェルを含む Windows 用の Cloud SDK をインストールし、gcloud コマンドライン ツールを使います。
gcloud をまだ初期化していない場合には、Google Cloud SDK シェルの中で下記のコマンドを実行してプロジェクトを初期化し、その後で認証をセットアップします。
$ gcloud init
$ gcloud auth login
インストール
それでは、新しいライブラリをインポートして使ってみましょう。Visual Studio の中でプロジェクトを作成して（このライブラリではまだ .NET Core プロジェクトをサポートしていないので、.NET Core プロジェクトにはしないでください）、プロジェクトの “References” を右クリックし、“Manage NuGet Packages” を選択します。
NuGet ウィンドウの中の “Browse” を選択して、“Include prerelease” にチェックを入れます。google-cloud-dotnet ページには、サポートされているサービスとその NuGet パッケージ名のすべてのリストがあります。
ここでは、Cloud Storage 用のライブラリをインストールしてみましょう。Cloud Storage 用のライブラリを見つけるためには、Google.Storage を検索する必要があります。
検索結果のリストには、Cloud Storage 用の新しいクライアント ライブラリ（Google.Storage）と、このライブラリが依存している低水準ライブラリ（Google.Apis.Storage）が含まれており、Google.Storage を選んでインストールします。インストールが完了すると、Google.Storage は参照として、Google.Apis は依存関係として表示されるはずです。
これで OK です。Cloud Storage 用の新しいクライアント ライブラリを .NET アプリケーションから利用できるようになりました。
サンプルが欲しい方は、このライブラリの GitHub ページの Cloud Storage の節をチェックしてみてください。
試してみた方は、ぜひ感想をお聞かせください。何か問題がありましたら、こちらにご連絡ください。もしよろしかったら、.NET アプリケーションのサポート向上をお手伝いしていただけるとうれしいです。
Google Cloud のユーザー エクスペリエンス向上をお手伝いしてくださる方は、ここをクリックしてください！
- Posted by Mete Atamel, Developer Advocate
NuGet ウィンドウの中の “Browse” を選択して、“Include prerelease” にチェックを入れます。google-cloud-dotnet ページには、サポートされているサービスとその NuGet パッケージ名のすべてのリストがあります。
ここでは、Cloud Storage 用のライブラリをインストールしてみましょう。Cloud Storage 用のライブラリを見つけるためには、Google.Storage を検索する必要があります。
検索結果のリストには、Cloud Storage 用の新しいクライアント ライブラリ（Google.Storage）と、このライブラリが依存している低水準ライブラリ（Google.Apis.Storage）が含まれており、Google.Storage を選んでインストールします。インストールが完了すると、Google.Storage は参照として、Google.Apis は依存関係として表示されるはずです。
これで OK です。Cloud Storage 用の新しいクライアント ライブラリを .NET アプリケーションから利用できるようになりました。
サンプルが欲しい方は、このライブラリの GitHub ページの Cloud Storage の節をチェックしてみてください。
試してみた方は、ぜひ感想をお聞かせください。何か問題がありましたら、こちらにご連絡ください。もしよろしかったら、.NET アプリケーションのサポート向上をお手伝いしていただけるとうれしいです。
Google Cloud のユーザー エクスペリエンス向上をお手伝いしてくださる方は、ここをクリックしてください！
0 件のコメント :
コメントを投稿