Cloud Shell で関数を作成してデプロイする

Cloud Shell エディタで Cloud Code と Cloud Functions を使用して、第 2 世代の HTTP 関数の作成、デプロイ、呼び出し、ダウンロードを行う方法について説明します。

このタスクを Cloud Shell エディタで直接行う際のガイダンスについては、「ガイドを表示」をクリックしてください。

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.

Google Cloud Console の [プロジェクトセレクタ] ページで、Google Cloud プロジェクトを選択または作成します。

プロジェクトセレクタに移動

Google Cloud プロジェクトで課金が有効になっていることを確認します。

Google Cloud Console の [プロジェクトセレクタ] ページで、Google Cloud プロジェクトを選択または作成します。

プロジェクトセレクタに移動

Google Cloud プロジェクトで課金が有効になっていることを確認します。

Google Cloud に接続する

このセクションでは、Cloud Shell エディタを起動して Google Cloud に接続し、Google Cloud プロジェクトを選択します。

Google Cloud に接続するには、次の手順を行います。

Cloud Shell エディタを起動する
認証情報を使用して Google Cloud API を呼び出すことを Cloud Code に承認するよう求められたら、利用規約に同意する場合は [承認] をクリックします。
まだ Google Cloud に接続していない場合は、Cloud Code のステータスバーで [Google Cloud に接続] をクリックします。
認証情報を使用して Google Cloud API 呼び出しを行うことを Cloud Code に承認するよう求められたら、利用規約に同意する場合は [承認] をクリックします。
Google Cloud プロジェクトをまだ選択していない場合は、Cloud Code のステータスバーで [Google Cloud プロジェクトを選択] をクリックします。

すでに Google Cloud プロジェクトが選択されている場合は、Cloud Code のステータスバーにプロジェクト名が表示され、関数の作成に進むことができます。
表示された [Google Cloud プロジェクトを選択] クイック選択メニューで、Google Cloud プロジェクトを選択します。

プロジェクトが読み込まれ、Cloud Shell エディタでアクティブなプロジェクトになります。このプロジェクトは、Cloud Code のステータスバーでアクティブなプロジェクト名をクリックし、別のプロジェクトを選択することで、いつでも切り替えることができます。

関数を作成する

関数の作成とデプロイのための環境として Cloud Shell エディタを使用します。このエディタには、クラウド開発に必要なツールがプリロードされています。

サンプルを使用して新しい関数を作成するには、次の手順に従います。

Cloud Code のステータスバーで、[Cloud Code] をクリックします。
表示されたクイック選択メニューで、[新しいアプリケーション] を選択します。
サンプルアプリケーションの種類として [Cloud Functions アプリケーション]を選択します。
サンプルの Cloud Functions アプリのリストから、[Node.js: Hello World] を選択します。
アプリを配置するフォルダを選択して、[Create New Application] をクリックします。

Cloud Shell エディタの新しいワークスペースにアプリが読み込まれます。再読み込みすると、エクスプローラ ビューでアプリにアクセスできるようになります。

.vscode フォルダにある launch.json ファイルには、関数に必要な構成が含まれています。
```
{
"configurations": [
    {
    "name": "Deploy Cloud Function",
    "type": "cloudcode.cloudfunctions",
    "request": "launch",
    "functionName": "function-hello-world",
    "gen": "GEN_2",
    "entryPoint": "helloHttp",
    }
]
}
```

1 つのワークスペースで複数の関数を作成する方法については、シェルワークスペースでの関数の管理をご覧ください。

関数をデプロイする

関数を作成したので、次の手順で Cloud Shell に関数をデプロイできます。

Cloud Code をクリックし、Cloud Functions エクスプローラを展開します。
関数をクリックして、 [関数のデプロイ] をクリックします。
Quickpick メニューで、関数をデプロイする Google Cloud プロジェクトを選択します。
関数のデプロイ先のリージョンを選択します。
[Node.js 20] を選択します。

関数のデプロイには数分かかる場合があります。進行中の場合は、進行状況アイコンが表示されます。完了すると、次のいずれかが表示されます。成功した場合は成功アイコン、失敗した場合はエラーアイコン、またはデプロイが失敗し、以前に成功したデプロイに戻った場合は警告アイコンです。

デプロイが失敗した場合は、[出力]（[表示] > [出力]）ビューでエラーメッセージを確認します。リンクをクリックすると、Google Cloud コンソールにビルドログが表示され、エラーの詳細を確認できます。
（省略可）関数のデプロイ後、次の操作を行うことができます。
- デプロイされた関数の読み取り専用ファイルを表示するには、関数を展開して、[ソースコード] フォルダを展開します。ここでは、.vscode の下に launch.json、デプロイされたコード、および package.json を表示できます。
- Google Cloud コンソールで関数を表示するには、関数を右クリックして [Cloud コンソールで開く] を選択し、プロンプトが表示されたら [開く] を選択します。
- 関数のメタデータを編集するには、関数を右クリックして [Cloud コンソールでメタデータを編集] を選択します。
- デプロイされた関数のログを表示するには、関数を右クリックして [ログを表示] を選択します。

関数を呼び出す

関数を呼び出すと、Cloud Shell エディタのターミナルから Google Cloud コンソールでデプロイされた関数を実行できます。関数を呼び出す手順は次のとおりです。

関数を右クリックし、[HTTP 経由で関数を呼び出す] を選択します。
表示される [HTTP 経由のトリガー関数] クイックメニューで、[引数なしで呼び出す] を選択します。

ターミナルが IDE で開き、Google Cloud で関数を実行するコマンドを実行します。

省略可: 既存の関数を新しいワークスペースにダウンロードする

既存の関数を新しいワークスペースにダウンロードするには、次の手順に従います。

[Cloud Code] をクリックし、[Cloud Functions] エクスプローラを展開します。
Google Cloud プロジェクトスニペットを開き、ダウンロードする関数を右クリックして、[新しいワークスペースにダウンロード] を選択します。
プロンプトが表示されたら、新しいアプリケーションの名前を入力して、[新規アプリケーションを作成] をクリックします。

関数がローカルマシンにダウンロードされ、Cloud Shell エディタの新しいワークスペースで開きます。

クリーンアップ

このクイックスタート用に作成した関数のみを削除するには:

[Cloud Functions] エクスプローラで、関数名を右クリックして [Cloud Console で開く] を選択します。
[削除] をクリックし、[削除] をクリックします。

プロジェクト（および関連するリソース）を削除するには:

Google Cloud コンソールの [プロジェクト] ページに移動します。

プロジェクトページに移動
このクイックスタート用に作成したプロジェクトを選択し、[削除] をクリックします。
プロジェクト ID を入力して確定し、[シャットダウン] をクリックします。

プロジェクトがシャットダウンし、プロジェクト削除のスケジュールが決定されます。

次のステップ

ワークスペースの管理またはローカル開発環境の設定の詳細については、Cloud Functions の操作の概要をご覧ください。