Firestore でのセッション処理

多くのアプリには、認証設定とユーザー設定用のセッション処理が必要です。Node.js Express フレームワークには、この機能を実行するためのメモリベースの実装が付属しています。ただし、記録されるセッションがインスタンス間で異なる場合があるため、この実装は複数のインスタンスから提供できるアプリには適していません。このチュートリアルでは、App Engine でセッションを処理する方法を示します。

目標

アプリを作成する。
アプリをローカルで実行する。
App Engine にアプリをデプロイする。

費用

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

料金計算ツールを使うと、予想使用量に基づいて費用の見積もりを生成できます。

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

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

始める前に

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

Enable the Firestore API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Google Cloud CLI をインストールします。

外部 ID プロバイダ（IdP）を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。

gcloud CLI を初期化するには、次のコマンドを実行します:

gcloud init

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.

Enable the Firestore API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Google Cloud CLI をインストールします。

外部 ID プロバイダ（IdP）を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。

gcloud CLI を初期化するには、次のコマンドを実行します:

gcloud init

プロジェクトの設定

ターミナルウィンドウで、選択したディレクトリに移動し、sessions という名前の新しいディレクトリを作成します。このチュートリアルのコードはすべて、sessions ディレクトリ内にあります。
sessions ディレクトリに移動します。
```
cd sessions
```
package.json ファイルを初期化します。
```
npm init .
```

依存関係をインストールします。

npm install \
 --save @google-cloud/connect-firestore @google-cloud/firestore express express-session

このチュートリアルの最後では、最終的なファイル構造が次のようになります。

sessions
├── app.yaml
├── index.js
└── package.json

ウェブアプリの作成

このアプリは、ユーザーごとに異なる言語で挨拶を表示します。リピーターは常に同じ言語で挨拶されます。

さまざまな言語で挨拶が表示されている複数のアプリウィンドウ。

アプリでユーザーの設定を保存するには、現在のユーザーに関する情報をセッションに保存する方法が必要です。このサンプルアプリは、Firestore を使用してセッションデータを保存します。

express-session と互換性のあるセッションストア、connect-firestore を使用できます。

ターミナルウィンドウで、次の内容の index.js という名前のファイルを作成します。

// Copyright 2019, Google LLC.
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//    http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

const {Firestore} = require('@google-cloud/firestore');
const express = require('express');
const session = require('express-session');

const app = express();
const {FirestoreStore} = require('@google-cloud/connect-firestore');

app.use(
  session({
    store: new FirestoreStore({
      dataset: new Firestore(),
      kind: 'express-sessions',
    }),
    secret: 'my-secret',
    resave: false,
    saveUninitialized: true,
  })
);

const greetings = [
  'Hello World',
  'Hallo Welt',
  'Ciao Mondo',
  'Salut le Monde',
  'Hola Mundo',
];

app.get('/', (req, res) => {
  if (!req.session.views) {
    req.session.views = 0;
    req.session.greeting =
      greetings[Math.floor(Math.random() * greetings.length)];
  }
  const views = req.session.views++;
  res.send(`${views} views for ${req.session.greeting}`);
});

const port = process.env.PORT || 8080;
app.listen(port, () => {
  console.log(`Example app listening on port ${port}!`);
});

module.exports = app;

次の図は、Firestore が App Engine アプリ用のセッションを処理する方法を示しています。

アーキテクチャの図: ユーザー、App Engine、Firestore。

app.use(session) を設定すると、すべてのリクエストが req.session プロパティを持つようになり、このプロパティを使用してリピーターを特定できます。セッションデータは Firestore に保存されます。

セッションの削除

Connect-firestore は、古いセッションや期限切れのセッションを削除しません。コンソールでセッションデータを削除するか、自動削除戦略を実装できます。Google Cloud セッションに、Memcache や Redis などのストレージソリューションを使用すると、期限切れのセッションが自動的に削除されます。

ローカルでの実行

ターミナルウィンドウで、 Google Cloud プロジェクトの依存関係をインストールします。
```
npm install
```
HTTP サーバーを起動します。
```
npm start
```
ウェブブラウザでアプリを表示します。

Cloud Shell

Cloud Shell ツールバーの [ウェブでプレビュー] アイコンをクリックし、[ポート 8080 でプレビュー] を選択します。

ローカルマシン

ブラウザで、http://localhost:8080 にアクセスします。

「Hello World」、「Hallo Welt」、「Hola mundo」、「Salut le Monde」、「Ciao Mondo」の 5 つの挨拶のいずれかが表示されます。別のブラウザまたはシークレットモードでページを開くと、別の言語で表示されます。コンソールでセッションデータを表示して編集できます。Google Cloud
HTTP サーバーを停止するには、ターミナルウィンドウで Control+C を押します。

App Engine でのデプロイと実行

App Engine スタンダード環境を使用すると、高い負荷の下で大量のデータを使用して正常に動作するアプリをビルドしてデプロイできます。

このチュートリアルでは、App Engine スタンダード環境を使用してサーバーをデプロイします。

ターミナルウィンドウで app.yaml ファイルを作成し、以下をコピーします。
```
runtime: nodejs10
```
App Engine にアプリをデプロイします。
```
gcloud app deploy
```
次の URL を入力して、ライブアプリを表示します。

https://PROJECT_ID.REGION_ID.r.appspot.com

次のように置き換えます。
- PROJECT_ID: 実際の Google Cloud プロジェクト ID
- REGION_ID: App Engine がアプリに割り当てるコード

これで、App Engine インスタンスで実行しているウェブサーバーから挨拶が配信されます。

アプリのデバッグ

App Engine アプリに接続できない場合は、次の点を確認してください。

gcloud デプロイコマンドが正常に終了して、エラーを出力しなかったことを確認します。エラー（たとえば、 message=Build failed）が発生した場合は、それらを修正してから、もう一度、 App Engine アプリをデプロイします。
コンソールで、[ログエクスプローラ] ページに移動します。 Google Cloud

[ログエクスプローラ] ページに移動
1. [最近選択したリソース] プルダウンリストで、[App Engine アプリケーション] をクリックしてから、[All module_id] をクリックします。アプリにアクセスした以降のリクエストのリストが表示されます。リクエストのリストが表示されない場合は、プルダウンリストで [All module_id] が選択されていることを確認します。エラーメッセージが Google Cloud コンソールに出力された場合は、アプリのコードがウェブアプリの作成に関するセクション内のコードと一致することを確認します。
2. Firestore API が有効になっていることを確認します。

クリーンアップ

プロジェクトを削除する

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

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

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

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

App Engine インスタンスの削除

コンソールで、App Engine の [**バージョン**] ページに移動します。 Google Cloud
[バージョン] に移動
デフォルト以外で削除するアプリのバージョンのチェックボックスをオンにします。削除します。
注: App Engine アプリのデフォルトバージョンを削除する唯一の方法は、プロジェクトを削除することです。ただし、コンソールでデフォルトバージョンを停止することもできます。 Google Cloud このアクションによって、バージョンに関連付けられているすべてのインスタンスがシャットダウンします。これらのインスタンスは、必要に応じてあとで再起動できます。

App Engine スタンダード環境では、お使いのアプリに手動スケーリングまたは基本スケーリングがある場合、デフォルトバージョンを停止させることができます。
アプリのバージョンを削除するには、 [削除] をクリックします。

次のステップ

他の Cloud Run 関数のチュートリアルを試す。
App Engine の詳細を確認する。
Cloud Run を使用してみる（フルマネージド環境や独自の Google Kubernetes Engine クラスタでステートレスコンテナを実行できます）。

Firestore でのセッション処理 コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

目標

費用

始める前に

プロジェクトの設定

ウェブアプリの作成

セッションの削除

ローカルでの実行

Cloud Shell

ローカルマシン

App Engine でのデプロイと実行

アプリのデバッグ

クリーンアップ

プロジェクトを削除する

App Engine インスタンスの削除

次のステップ

Firestore でのセッション処理