Cloud Code for Cloud Shell を使用して Cloud Functions(第 2 世代)を作成する

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

Cloud Code は、Google Kubernetes Engine や Cloud Run など多くの Google Cloud サービスを IDE で直接使用できるようにする拡張機能です。コンテキストを切り替えることなくアプリケーションを開発できます。Cloud Code は、デフォルトでは Cloud Shell エディタで利用できます。

Cloud Code 拡張機能を VS Code にインストールできます。これは関数の作成とデプロイや、IntelliJ と Cloud Functions をサポートしていないその他のサポートされている JetBrains IDE もサポートしています。


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

ガイドを表示


始める前に

  1. 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.
  2. Google Cloud Console の [プロジェクト セレクタ] ページで、Google Cloud プロジェクトを選択または作成します。

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

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

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

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

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

Google Cloud に接続する

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

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

  1. Cloud Shell エディタを起動する

  2. Cloud Code が認証情報を使用して Google Cloud API を呼び出すことを承認するよう求められたら、利用規約に同意する場合は [承認] をクリックします。

  3. まだ Google Cloud に接続していない場合は、Cloud Code のステータスバーで [Google Cloud に接続] をクリックします。

    ステータスバーの [Google Cloud に接続] ボタン

  4. Cloud Code が認証情報を使用して Google Cloud API を呼び出すことを承認するよう求められたら、利用規約に同意する場合は [承認] をクリックします。

  5. Google Cloud プロジェクトをまだ選択していない場合は、Cloud Code のステータスバーで [Google Cloud プロジェクトを選択] をクリックします。

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

  6. 表示された [Google Cloud プロジェクトを選択] クイック選択メニューで、Google Cloud プロジェクトを選択します。

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

関数を作成する

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

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

  1. Cloud Code のステータスバーで、[Cloud Code] をクリックします。

    Cloud Code のステータスバーのボタン

  2. 表示されたクイック選択メニューで、[New Application] を選択します。

  3. サンプル アプリケーションの種類として [Cloud Functions application] を選択します。

  4. サンプルの Cloud Functions アプリのリストから、[Node.js: Hello World] を選択します。

  5. アプリを配置するフォルダを選択して、[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",
        }
    ]
    }
    

関数をデプロイする

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

  1. Cloud Code をクリックし、Cloud Functions エクスプローラを展開します。

  2. 関数をクリックして、 [Deploy function] をクリックします。

  3. Quickpick メニューで、関数をデプロイする先の Google Cloud プロジェクトを選択します。

  4. 関数をデプロイする先のリージョンを選択します。

  5. [Node.js 20] を選択します。

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

    デプロイが失敗した場合は、[Output]([View] > [Output])ビューでエラー メッセージを確認します。リンクをクリックすると、Google Cloud コンソールにビルドログが表示され、エラーの詳細を確認できます。

  6. (省略可)関数がデプロイされたら、次の操作を行うことができます。

    • デプロイされた関数の読み取り専用ファイルを表示するには、関数を展開してから、[Source Code] フォルダを展開します。ここでは、.vscode の下に launch.json、デプロイされたコード、および package.json が表示されます。

    • Google Cloud コンソールで関数を表示するには、関数を右クリックして [Open in Cloud Console] を選択し、プロンプトが表示されたら [Open] を選択します。

    • 関数のメタデータを編集するには、関数を右クリックして [Edit metadata in Cloud Console] を選択します。

    • デプロイされた関数のログを表示するには、関数を右クリックして [ログを表示] を選択します。

関数を呼び出す

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

  1. 関数を右クリックし、[Invoke function via HTTP] を選択します。

  2. 表示される [Trigger function via HTTP] Quickpick メニューで、[Invoke with no arguments] を選択します。

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

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

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

  1. [Cloud Code] をクリックし、[Cloud Functions] エクスプローラを展開します。

  2. Google Cloud プロジェクト スニペットを展開し、ダウンロードする関数を右クリックして、[Download to new workspace] を選択します。

  3. プロンプトが表示されたら、新しいアプリケーションの名前を入力して、[Create New Application] をクリックします。

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

クリーンアップ

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

  1. [Cloud Functions] エクスプローラで、関数名を右クリックして [Open in Cloud Console] を選択します。

  2. [削除] をクリックし、[削除] をクリックします。

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

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

    [プロジェクト] ページに移動

  2. このクイックスタート用に作成したプロジェクトを選択し、[削除] をクリックします。

  3. プロジェクト ID を入力して確定し、[シャットダウン] をクリックします。

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

次のステップ