Ruby クイックスタート

Cloud Functions は、クラウド サービスの構築と接続に使用できるサーバーレスの実行環境です。Cloud Functions を使用すると、クラウドのインフラストラクチャやサービスで生じたイベントに関連する、単一目的のシンプルな関数を作成できます。関数は、HTTP リクエストが外部に送信されるか、監視対象のイベントが発生するとトリガーされます。

Cloud Console を使用して、Ruby の Cloud Functions の関数を作成し、デプロイする方法を説明します。


このタスクを Cloud Console で直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。

ガイドを表示


以降のセクションでは、[ガイドを表示] をクリックした場合と同じ手順について説明します。

この Ruby 関数は、HTTP リクエストによってトリガーされると次のメッセージを書き込みます。

require "functions_framework"
require "json"

# This function receives an HTTP request of type Rack::Request
# and interprets the body as JSON. It prints the contents of
# the "message" field, or "Hello World!" if there isn't one.
FunctionsFramework.http "hello_world" do |request|
  input = JSON.parse request.body.read rescue {}
  msg = input["message"].to_s
  msg.empty? ? "Hello World!" : msg
end

始める前に

  1. Google Cloud アカウントにログインします。Google Cloud を初めて使用する場合は、アカウントを作成して、実際のシナリオでの Google プロダクトのパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。
  2. Google Cloud Console の [プロジェクト セレクタ] ページで、Google Cloud プロジェクトを選択または作成します。

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

  3. Cloud プロジェクトに対して課金が有効になっていることを確認します。プロジェクトに対して課金が有効になっていることを確認する方法を学習する

  4. Cloud Functions and Cloud Build API を有効にします。

    API を有効にする

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

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

  6. Cloud プロジェクトに対して課金が有効になっていることを確認します。プロジェクトに対して課金が有効になっていることを確認する方法を学習する

  7. Cloud Functions and Cloud Build API を有効にします。

    API を有効にする

関数を作成する

  1. Cloud Console で Functions の概要ページを開きます。

    Cloud Functions の概要ページに移動

    Cloud Functions を有効にしたプロジェクトが選択されていることを確認します。

  2. [関数を作成] をクリックします。

  3. 関数に名前を付けます。

  4. [トリガー] フィールドで、[HTTP] を選択します。

  5. [認証] フィールドで、[未認証の呼び出しを許可する] を選択します。

  6. [保存] をクリックして変更を保存し、[次へ] をクリックします。

  7. [ソースコード] フィールドで [インライン エディタ] を選択します。この演習では、エディタで提供されているデフォルト関数を使用します。

  8. [ランタイム] プルダウンで、必要な Ruby ランタイムを選択します。

関数をデプロイする

  1. ページの下部にある [デプロイ] をクリックします。

  2. [デプロイ] をクリックすると、Cloud Console に Cloud Functions の概要ページが表示されます。

    関数のデプロイ中は、関数の横に小さいスピナーのアイコンが表示されます。デプロイが完了すると、スピナーが緑のチェックマークに変わります。

    関数のデプロイ プロセスを示すスクリーンショット

関数をテストする

  1. 関数のメニューを表示して、[関数をテスト] をクリックします。

    関数のテストプロセスを示すスクリーンショット

  2. テストページで、[関数をテスト] をクリックします。

    [出力] 画面にテキスト "Hello World!" が表示されます。

  3. ここで、メッセージを変更します。[トリガーとなるイベント] フィールドに、テキスト「{"message":"Hello, YOUR_NAME!"}」を入力し(YOUR_NAME は名前に置き換えてください)、[関数をテスト] をクリックします。

    たとえば、「Rowan」という名前を入力したとします。[出力] フィールドに、「Hello, Rowan!」というメッセージが表示されます。

    [ログ] フィールドにステータス コード 200 が表示されていれば、成功しています。

    [ログ] フィールドに成功を示すコード 200 が表示されているスクリーンショット

ログを表示する

ログ履歴内のアクションを確認するには、ログを開いてチェックします。

  • Cloud Functions の概要ページに戻り、関数のメニューを表示し、[ログを表示] をクリックします。

ログの履歴が表示されます。

[ログ] フィールドに成功を示すコード 200 が表示されているスクリーンショット

次のステップ