Cloud Functions は、Cloud Run functions という名称になりました。詳細については、Cloud Run functions のブログ投稿をご覧ください。

このページは Cloud Translation API によって翻訳されました。

Node.js で Cloud Run の HTTP 関数を作成してデプロイする

このドキュメントでは、簡単な Cloud Run 関数の HTTP 関数を作成するプロセスについて説明します。これは、次の 2 種類の Cloud Run 関数のいずれかです。

HTTP 関数。標準的な HTTP リクエストから呼び出します。
イベントドリブン関数。Pub/Sub トピック上のメッセージや Cloud Storage バケット内の変更など、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.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Enable the Cloud Functions, Cloud Build, Artifact Registry, Cloud Run, and Cloud Logging APIs.

Enable the APIs

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

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Enable the Cloud Functions, Cloud Build, Artifact Registry, Cloud Run, and Cloud Logging APIs.

Enable the APIs

gcloud CLI をインストールして初期化します。

gcloud コンポーネントを更新してインストールします。
```
gcloud components update
```
開発環境を準備します。

Node.js 設定ガイドに移動

関数を作成する

関数コードで使用するため、ローカルシステムにディレクトリを作成します。
Linux / Mac OS X
```
mkdir ~/helloworld
cd ~/helloworld
```
Windows
```
mkdir %HOMEPATH%\helloworld
cd %HOMEPATH%\helloworld
```

helloworld ディレクトリに、次の内容の index.js ファイルを作成します。

const functions = require('@google-cloud/functions-framework');

// Register an HTTP function with the Functions Framework that will be executed
// when you make an HTTP request to the deployed function's endpoint.
functions.http('helloGET', (req, res) => {
  res.send('Hello World!');
});

このサンプル関数は、すべてのリクエストに「Hello World!」という挨拶を返します。

依存関係を指定する

Node.js における依存関係は、npm で管理され、package.json というメタデータファイルで表現されます。このファイルは手動で、または npm コマンドを使用して作成できます。

npm コマンドを使用して package.json ファイルを作成するには:
1. helloworld ディレクトリから npm init コマンドを実行します。Enter を押して、質問への回答をデフォルトのまま確定します。
```
npm init
```
2. package.json ファイルを編集して、functions-framework 依存関係を追加します。
```
"dependencies": {
  "@google-cloud/functions-framework": "^3.1.0"
}
```
package.json ファイルを手動で作成する場合は、次の内容をコピーします。

{
  "name": "nodejs-docs-samples-functions-hello-world-get",
  "version": "0.0.1",
  "private": true,
  "license": "Apache-2.0",
  "author": "Google Inc.",
  "repository": {
    "type": "git",
    "url": "https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git"
  },
  "engines": {
    "node": ">=16.0.0"
  },
  "scripts": {
    "test": "c8 mocha -p -j 2 test/*.test.js --timeout=6000 --exit"
  },
  "dependencies": {
    "@google-cloud/functions-framework": "^3.1.0"
  },
  "devDependencies": {
    "c8": "^10.0.0",
    "gaxios": "^6.0.0",
    "mocha": "^10.0.0",
    "wait-port": "^1.0.4"
  }
}

多くの Node.js クライアントライブラリが Google Cloud プロダクトで使用でき、依存関係としてインストールできます。

関数をローカルでビルドしてテストする

関数をデプロイする前にローカルでテストするには、Functions Framework をローカルにインストールしてから関数を実行する必要があります。

helloworld ディレクトリから次のコマンドを実行して、ローカルマシンに Functions Framework をインストールします。
```
npm install @google-cloud/functions-framework
```
関数をローカルで実行するには、helloworld ディレクトリから次のコマンドを実行します。
```
npx @google-cloud/functions-framework --target=helloGET
```
関数をテストするには、ブラウザで http://localhost:8080 にアクセスするか、別のウィンドウから curl localhost:8080 を実行します。

詳細については、ローカル関数にリクエストを送信するをご覧ください。

関数から「Hello World!」というメッセージが返されます。

関数をデプロイする

関数をデプロイするには、helloworld ディレクトリで gcloud functions deploy コマンドを実行します。

gcloud functions deploy hello-node-function \
  --gen2 \
  --runtime=nodejs22 \
  --region=REGION \
  --source=. \
  --entry-point=helloGET \
  --trigger-http \
  --allow-unauthenticated

REGION は、関数をデプロイする Google Cloud リージョンの名前に置き換えます（us-west1 など）。

これにより、選択したリージョンに nodejs22 ランタイムを使用してサンプル関数がデプロイされます。

オプションの --allow-unauthenticated フラグを使用すると、認証なしで関数にアクセスできます。

デプロイした関数をテストする

関数がデプロイされたら、gcloud functions deploy コマンドの出力で uri プロパティをメモするか、次のコマンドを使用して取得します。
```
  gcloud functions describe hello-node-function \
    --region=REGION
```
REGION は、関数をデプロイした Google Cloud リージョンの名前に置き換えます（us-west1 など）。
ブラウザまたは次の curl コマンドを使用して、この URL にアクセスします。
```
curl FUNCTION_URL
```
FUNCTION_URL は、取得した uri プロパティに置き換えます。

この関数は、「Hello World!」メッセージを返します。

関数のログを表示する

コマンドラインツールを使用してログを表示する

関数のログを表示するには、Cloud Logging UI または Google Cloud CLI を使用します。

gcloud CLI を使用して関数のログを表示するには、gcloud functions logs read コマンドを使用します。

    gcloud functions logs read \
      --gen2 \
      --region=REGION \
      --limit=10 \
      hello-node-function

REGION は、関数をデプロイした Google Cloud リージョンの名前に置き換えます（us-west1 など）。

出力は次のようになります。

LEVEL: I
NAME: hello-node-function
TIME_UTC: 2023-06-16 18:42:24.956
LOG:

LEVEL: I
NAME: hello-node-function
TIME_UTC: 2023-06-16 18:42:01.692
LOG:

LEVEL: I
NAME: hello-node-function
TIME_UTC: 2023-06-16 18:31:47.711
LOG: Default STARTUP TCP probe succeeded after 1 attempt for container "hello--node--function-1" on port 8080.

LEVEL: I
NAME: hello-node-function
TIME_UTC: 2023-06-16 18:31:46.542
LOG:

LEVEL: I
NAME: hello-node-function
TIME_UTC: 2023-06-16 18:31:27.390
LOG: Default STARTUP TCP probe succeeded after 1 attempt for container "hello--node--function-1" on port 8080.

ロギングダッシュボードでログを表示する

ロギングダッシュボードで関数のログを表示するには、Cloud Run functions の概要ページを開き、リストから関数の名前をクリックして、[ログ] タブをクリックします。