このチュートリアルは、Google Cloud の導入において主なアプリ開発のコンセプトを学習したいエンジニアやウェブ デベロッパーなど、クラウドにアプリをビルドするのが初めての人を対象にしています。
目標
- Google Cloud Console や
gcloud
などの Google Cloud の基本的なツールについて学習します。 - アプリを Cloud Run にデプロイします。
- Firestore でデータを保存します。
- Cloud Storage にアップロードしたファイルを保存します。
- Google Cloud のオペレーション スイートを使用してアプリをモニタリングします。
費用
このドキュメントでは、Google Cloud の次の課金対象のコンポーネントを使用します。
このドキュメントの手順は、リソース使用量が Google Cloud の無料枠ティアの制限内に収まるように設計されています。 料金計算ツールを使うと、予想使用量に基づいて費用の見積もりを生成できます。
このドキュメントに記載されているタスクの完了後、作成したリソースを削除すると、それ以上の請求は発生しません。詳細については、クリーンアップをご覧ください。
始める前に
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure 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.
-
Make sure that billing is enabled for your Google Cloud project.
-
Firestore データベースをネイティブ モードで作成するには、次の手順に沿って操作してください。
-
Google Cloud コンソールで、[Firestore Viewer] ページに移動します。
Firestore Viewer に移動 - [Cloud Firestore モードの選択] 画面から [ネイティブ モードを選択] をクリックします。
- Firestore データベースのロケーションを選択します。このロケーション設定は、Cloud プロジェクトのデフォルトの Google Cloud リソースのロケーションです。このロケーションは、ロケーション設定を必要とする Cloud プロジェクト内の Google Cloud サービス(特にデフォルトの Cloud Storage バケットおよび Cloud Run アプリ)で使用されます。
- [データベースを作成] をクリックします。
-
Google Cloud コンソールで、[Firestore Viewer] ページに移動します。
-
Enable the Cloud Run, Cloud Storage JSON, Cloud Logging, and Error Reporting APIs.
-
サンプル リポジトリのクローンを作成して、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 に指示します。Dockerfiles はよりリッチになる可能性がありますが、この構成は多くのアプリで機能します。
Cloud Run は、PORT
環境変数を設定して、リッスンするポートをアプリに指示します。Bookshelf の Program.cs
には、PORT
変数を監視してそのポートでリッスンするコードが含まれています。
ターミナル ウィンドウで、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 ブラウザーにコピーして、アプリを表示します。
Cloud Run へのデプロイの詳細については、Cloud Run のドキュメントをご覧ください。
Firestore を使用してデータを保存する
Cloud Run インスタンスに情報を保存することはできません。インスタンスを再起動すると情報が失われ、新しいインスタンスが作成されたときにはその情報は存在しないためです。そこで、すべてのインスタンスが読み取りおよび書き込みするデータベースを使用します。
Google Cloud にはデータを保存する際に使用できるオプションがいくつか用意されています。この例では、Firestore を使用して各書籍のデータを保存します。Firestore はフルマネージドでサーバーレスの NoSQL ドキュメント データベースで、データを保存および照会できます。Firestore はアプリのニーズを満たすために自動でスケールし、使用しない場合はゼロにスケールします。最初の書籍を追加しましょう。
-
デプロイしたアプリ用の書籍を作成するには、[Add book] をクリックします。
- [Title] 項目に「
Moby Dick
」と入力します。 - [Author] 項目に「
Herman Melville
」と入力します。 -
[Save] をクリックします。Bookshelf アプリにエントリが追加されました。
-
Google Cloud コンソールで、[Cloud Firestore] に移動します。Cloud Firestore に移動します
データが Firestore に表示されます。Bookshelf アプリは、各書籍を一意の ID とともに Firestore ドキュメントとして保存し、これらのドキュメントはすべて Firestore コレクション内に保存されます。このチュートリアルでは、コレクションを書籍と呼びます。
Firestore は Firestore クライアント ライブラリを使用して書籍を保存します。Firestore ドキュメントを取得する例を次に示します。
Firestore の使用方法の詳細については、Firestore にデータを追加するをご覧ください。
Cloud Storage にアップロードしたファイルを保存する
書籍を追加したので、書籍の表紙の画像を追加します。ファイルをインスタンスに保存することはできず、データベースは画像ファイルに適していません。そこで Cloud Storage を使用します。
Cloud Storage は Google Cloud 向けのメインの blob ストアです。Cloud Storage を使用して、Google Cloud で共有するアプリのアセットをホストできます。Cloud Storage を使用するには、データを保存する基本的なコンテナである Cloud Storage バケットを作成する必要があります。
- Google Cloud コンソールで、[Cloud Storage ブラウザ] ページに移動します。
- [バケットを作成] をクリックします。
- [バケットの作成] ダイアログで、Google Cloud のプロジェクト ID を文字列
_bucket
に付け加えてバケットの名前を入力して、名前をYOUR_PROJECT_ID_bucket
のようにします。この名前はバケット名の要件を満たしている必要があります。他のすべての項目はデフォルト値のままにします。 - [作成] をクリックします。
- バケットの作成後、ユーザーが閲覧できるようにオブジェクトを一般公開する必要があります。オブジェクトを一般公開するには、データの一般公開をご覧ください。
-
[Edit book] をクリックして、書籍の表紙としてアップロードする画像を選択します。たとえば、このパブリック ドメインの画像を使用します。
-
[Save] をクリックします。Bookshelf アプリのエントリがあるホームページにリダイレクトされます。
Bookshelf アプリは、Cloud Storage クライアント ライブラリを使用して、アップロードされたファイルを Cloud Storage に送信します。
Cloud Storage の使用方法の詳細については、入門ガイドのリストをご覧ください。
Google Cloud のオペレーション スイートを使用してアプリをモニタリングする
アプリをデプロイし、書籍を作成して修正しました。ユーザーのためにこのようなイベントをモニタリングするには、アプリケーション パフォーマンス管理を使用します。
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 のオペレーション スイートに送信されます。
-
Google Cloud コンソールで [Error Reporting] ページに戻り、しばらくすると新しいエラーが表示されます。[自動再読み込み] をクリックすると、ページを手動で更新する必要がなくなります。
クリーンアップ
このチュートリアルで使用したリソースについて、Google Cloud アカウントに課金されないようにするには、リソースを含むプロジェクトを削除するか、プロジェクトを維持して個々のリソースを削除します。
プロジェクトの削除
- In the Google Cloud console, go to the Manage resources page.
- In the project list, select the project that you want to delete, and then click Delete.
- In the dialog, type the project ID, and then click Shut down to delete the project.