Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

.NET のスタートガイド

このチュートリアルは、初めてクラウドでアプリを構築する方々を対象にしています。エンジニアやウェブデベロッパーなどが、に適用できるアプリ開発の重要なコンセプトを学習する場合に役立ちます。 Google Cloud

目標

基本的な Google Cloud ツール（Google Cloud コンソールや gcloudなど）について学習します。
アプリをCloud Runにデプロイします。
Firestore でデータを保存します。
Cloud Storage にアップロードしたファイルを保存します。
Google Cloud Observability を使用してアプリをモニタリングします。

費用

このドキュメントでは、課金対象である次のコンポーネントを使用します。 Google Cloud

このドキュメントの手順は、リソース使用量が Google Cloud's Always Free ティアの制限内に収まるように設計されています。料金計算ツールを使うと、予想使用量に基づいて費用の見積もりを生成できます。

新規の Google Cloud ユーザーの方は、無料トライアルをご利用いただける場合があります。

このドキュメントに記載されているタスクの完了後、作成したリソースを削除すると、それ以上の請求は発生しません。詳細については、クリーンアップをご覧ください。

始める前に

アカウントに Google Cloud ログインします。 Google Cloudを初めて使用する場合は、アカウントを作成して、実際のシナリオで Google プロダクトのパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Firestore データベースをネイティブモードで作成するには、次の手順に沿って操作してください。
1. コンソール Google Cloud で、[**Firestore のデータベースの作成**] ページに移動します。
  
  Firestore のデータベースの作成に移動
2. [Cloud Firestore モードの選択] 画面から [ネイティブモードを選択] をクリックします。
3. Firestore データベースのロケーションを選択します。このロケーション設定は、プロジェクトのデフォルトの Google Cloud リソースのロケーションです Google Cloud 。このロケーションは、ロケーション設定を必要とする Google Cloud プロジェクト内のサービス（特にデフォルトの Cloud Storage バケットおよび Cloud Run アプリ）で使用されます。
  警告: プロジェクトのデフォルトのリソースロケーションを設定すると、後で変更することはできません。 Google Cloud Google Cloud
4. [データベースを作成] をクリックします。
Cloud Run、Cloud Storage JSON、Cloud Logging、Error Reporting API を有効にします。
API を有効にするために必要なロール
API を有効にするには、serviceusage.services.enable 権限が必要です。プロジェクトを作成した場合は、オーナーロール（roles/owner）を介してこの権限がすでに付与されている可能性があります。それ以外の場合は、サービス使用管理者ロール（roles/serviceusage.serviceUsageAdmin）を介してこの権限を取得できます。ロールを付与する方法をご覧ください。
API を有効にする
サンプルリポジトリのクローンを作成して、Cloud Shell でサンプルアプリケーションを開きます。
Cloud Shell に移動

Cloud Shell を使用すると、ブラウザからコマンドラインで直接 Google Cloud リソースにアクセスできます。
リポジトリのクローンを作成するプロンプトで、[確認] をクリックします。
Cloud Shell で、gcloud ツールを構成して新しい Google Cloud プロジェクトを使用します。
```
# Configure gcloud for your project
gcloud config set project PROJECT_ID
```
PROJECT_ID は、 Google Cloud コンソール Google Cloud を使用して作成したプロジェクト ID に置き換えます。

Google Cloud CLI は、コマンドラインから Google Cloud リソースを操作する基本的な方法です。このチュートリアルでは、gcloud ツールを使用してアプリをデプロイおよびモニタリングします。

アプリを実行する

アプリを実行します。
```
GOOGLE_CLOUD_PROJECT=PROJECT_ID dotnet run
```
PROJECT_ID を、作成した Google Cloud プロジェクト ID に置き換えます。
Cloud Shell で、[**ウェブでプレビュー**] , をクリックし、[**ポート 8080 でプレビュー**] を選択します。新しいウィンドウが開き、実行中のアプリが表示されます。

アプリを Cloud Run にデプロイする

Google Cloud には、コードを実行する際に使用できるオプションがいくつか用意されています。この例では、Cloud Run を使用してスケーラブルなアプリを Google Cloudにデプロイします。Cloud Run ではサーバーの管理が不要なため、コーディングに集中できます。また、トラフィックが急激に跳ね上がった場合も Cloud Run が自動的にスケーリングしてサポートします。

Dockerfile は、アプリの実行方法を Cloud Run に指示します。

FROM mcr.microsoft.com/dotnet/core/aspnet:2.1
COPY . /app
WORKDIR /app
ENTRYPOINT ["dotnet", "Bookshelf.dll"]

Dockerfiles はよりリッチになる可能性がありますが、この構成は多くのアプリで機能します。

Cloud Run は、PORT 環境変数を設定して、リッスンするポートをアプリに指示します。Bookshelf の Program.cs には、 PORT 変数を監視してそのポートでリッスンするコードが含まれています。

using Google.Cloud.Diagnostics.AspNetCore;
using Microsoft.AspNetCore;
using Microsoft.AspNetCore.Hosting;
using System;

namespace Bookshelf
{
    public class Program
    {
        public static void Main(string[] args)
        {
            CreateWebHostBuilder(args).Build().Run();
        }

        public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
            WebHost.CreateDefaultBuilder(args)
                .UseGoogleDiagnostics(Startup.GetProjectId(), "Bookshelf", "0.01")
                .UseStartup<Startup>().UsePortEnvironmentVariable();
    }

    static class ProgramExtensions
    {
        // Google Cloud Run sets the PORT environment variable to tell this
        // process which port to listen to.
        public static IWebHostBuilder UsePortEnvironmentVariable(
            this IWebHostBuilder builder)
        {
            string port = Environment.GetEnvironmentVariable("PORT");
            if (!string.IsNullOrEmpty(port))
            {
                builder.UseUrls($"http://0.0.0.0:{port}");
            }
            return builder;
        }
    }
}

ターミナルウィンドウで、gcloud CLI を使用してアプリを Cloud Run にデプロイします。

アプリをローカルでビルドします。
```
dotnet publish -c Release
```
Cloud Build を使用して Docker コンテナをビルドし、Container Registry に公開します。
```
gcloud builds submit --tag gcr.io/PROJECT_ID/bookshelf \
    bin/Release/netcoreapp2.1/publish
```

Cloud Run を使用してコンテナを実行します。

gcloud run deploy bookshelf --region us-central1 --platform managed \
    --image gcr.io/PROJECT_ID/bookshelf --allow-unauthenticated

これで、アプリは gcloud run の出力に表示される URL で確認できるようになりました。

Service [bookshelf] revision [bookshelf-00001] has been deployed and is serving traffic at
https://bookshelf-lwuhslogjlnpofsxugoc.a.run.app

URL を Web ブラウザーにコピーして、アプリを表示します。
注: この SSL で保護されたドメインは自動的に作成され、開発に役立ちます。Cloud Run を使用してカスタムドメインを設定することもできます。

Cloud Run へのデプロイの詳細については、Cloud Run のドキュメントをご覧ください。

Firestore を使用してデータを保存する

Cloud Run インスタンスに情報を保存することはできません。インスタンスを再起動すると情報が失われ、新しいインスタンスが作成されたときにはその情報は存在しないためです。そこで、すべてのインスタンスが読み取りおよび書き込みするデータベースを使用します。

Google Cloud にはデータを保存する際に使用できるオプションがいくつか用意されています。この例では、Firestore を使用して各書籍のデータを保存します。 Firestore はフルマネージドでサーバーレスの NoSQL ドキュメントデータベースで、データを保存および照会できます。Firestore はアプリのニーズを満たすために自動でスケールし、使用しない場合はゼロにスケールします。最初の書籍を追加しましょう。

デプロイしたアプリ用の書籍を作成するには、[Add book] をクリックします。
[Title] 項目に「Moby Dick」と入力します。
[Author] 項目に「Herman Melville」と入力します。
[保存] をクリックします。Bookshelf アプリにエントリが追加されました。
コンソール Google Cloud で、[**Cloud Firestore**] に移動します。 Cloud Firestore に移動します
データが Firestore に表示されます。Bookshelf アプリは、各書籍を一意の ID とともに Firestore ドキュメントとして保存し、これらのドキュメントはすべて Firestore コレクション内に保存されます。このチュートリアルでは、コレクションを書籍と呼びます。

Firestore は Firestore クライアントライブラリを使用して書籍を保存します。 Firestore ドキュメントを取得する例を次に示します。

using Google.Cloud.Firestore;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;

namespace Bookshelf.Models
{
    class FirestoreBookStore : IBookStore
    {
        private FirestoreDb _firestore;
        private CollectionReference _books;

        public FirestoreBookStore(string projectId)
        {
            _firestore = FirestoreDb.Create(projectId);
            _books = _firestore.Collection("Books");
        }

Firestore の使用方法の詳細については、 Firestore にデータを追加するをご覧ください。

Cloud Storage にアップロードしたファイルを保存する

書籍を追加したので、書籍の表紙の画像を追加します。ファイルをインスタンスに保存することはできず、データベースは画像ファイルに適していません。そこで Cloud Storage を使用します。

Cloud Storage はメインの blob ストアです Google Cloud。Cloud Storage を使用して、で共有するアプリのアセットをホストできます Google Cloud。Cloud Storage を使用するには、データを保存する基本的なコンテナである Cloud Storage バケットを作成する必要があります。

コンソール Google Cloud で Cloud Storage の [**ブラウザ**] ページに移動します。
Cloud Storage ブラウザページに移動
[バケットを作成] をクリックします。
[バケットの作成] ダイアログで、 Google Cloud プロジェクト ID を文字列 _bucket に付け加えてバケットの名前を入力して、名前を YOUR_PROJECT_ID_bucket のようにします。この名前はバケット名の要件を満たしている必要があります。他のすべての項目はデフォルト値のままにします。
[作成] をクリックします。
バケットの作成後、ユーザーが閲覧できるようにオブジェクトを一般公開する必要があります。オブジェクトを一般公開するには、データの一般公開をご覧ください。
[Edit book] をクリックして、書籍の表紙としてアップロードする画像を選択します。たとえば、このパブリックドメインの画像を使用します。
[保存] をクリックします。Bookshelf アプリのエントリがある
ホームページにリダイレクトされます。

Bookshelf アプリは、 Cloud Storage クライアントライブラリを使用して、アップロードされたファイルを Cloud Storage に送信します。

using Google.Cloud.Storage.V1;
using Microsoft.AspNetCore.Http;
using System;
using System.Threading.Tasks;
using System.Web;

namespace Bookshelf.Services
{
    public class ImageUploader
    {
        private readonly string _bucketName;
        private readonly StorageClient _storageClient;

        public ImageUploader(string bucketName)
        {
            _bucketName = bucketName;
            _storageClient = StorageClient.Create();
        }

Cloud Storage の使用方法については、 Cloud Storage の概要をご覧ください。

Google Cloud Observability を使用してアプリをモニタリングする

アプリをデプロイし、書籍を作成して修正しました。ユーザーのためにこのようなイベントをモニタリングするには、アプリケーションパフォーマンス管理を使用します。

Cloud Logging でログをモニタリングする

で Google Cloud、[**ログエクスプローラ**] に移動します。
[ログエクスプローラ] に移動
アプリをリアルタイムでモニタリングできます。アプリに問題が発生した場合は、まずこちらの画面を確認してください。
[リソース] プルダウンリストで、[Cloud Run のリビジョン, bookshelf] を選択します。

Error Reporting でエラーをモニタリングする

コンソール Google Cloud で [Error Reporting] ページに移動します。
[Error Reporting] ページに移動
Error Reporting では、アプリ内のエラーと例外が強調表示され、そのアラートを設定できます。
ブラウザで、アプリの /Home/Throw URL に移動します。
たとえば、アプリが https://bookshelf-lwuhslogjlnpofsxugoc.a.run.app でホストされている場合は、https://bookshelf-lwuhslogjlnpofsxugoc.a.run.app/Home/Throw に移動します。
これにより、新しいテストの例外が生成され、Google Cloud Observability に送信されます。
Google Cloud コンソールで、[Error Reporting] ページに戻り、しばらくすると新しいエラーが表示されます。[自動再読み込み] をクリックすると、ページを手動で更新する必要がなくなります。

クリーンアップ

このチュートリアルで使用したリソースについて、Google Cloud アカウントに課金されないようにするには、リソースを含むプロジェクトを削除するか、プロジェクトを維持して個々のリソースを削除します。

プロジェクトを削除する

注意 : プロジェクトを削除すると、次のような影響があります。

プロジェクト内のすべてのものが削除されます。既存のプロジェクトを使用してこのドキュメントのタスクを行った場合、そのプロジェクトを削除すると、プロジェクト内で行った他の作業もすべて削除されます。
カスタムプロジェクト ID が失われます。このプロジェクトを作成したときに、将来使用するカスタムプロジェクト ID を作成した可能性があります。そのプロジェクト ID を使用した URL（例: appspot.com）を保持するには、プロジェクト全体ではなく、プロジェクト内の選択したリソースだけを削除します。

複数のアーキテクチャ、チュートリアル、クイックスタートを実施する予定がある場合は、プロジェクトを再利用するとプロジェクトの割り当て上限を超えないようにすることができます。

コンソール Google Cloud で [**リソースの管理**] ページに移動します。
[リソースの管理] に移動
プロジェクトリストで、削除するプロジェクトを選択し、[削除] をクリックします。
ダイアログでプロジェクト ID を入力し、 [Shut down] をクリックしてプロジェクトを削除します。

.NET のスタートガイド コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

目標

費用

始める前に

アプリを実行する

アプリを Cloud Run にデプロイする

Firestore を使用してデータを保存する

Cloud Storage にアップロードしたファイルを保存する

Google Cloud Observability を使用してアプリをモニタリングする

Cloud Logging でログをモニタリングする

Error Reporting でエラーをモニタリングする

クリーンアップ

プロジェクトを削除する

次のステップ

.NET のスタートガイド