環境変数を構成する

gcloud

Google Cloud CLI を使用してランタイム環境変数を設定するには、デプロイ時に --set-env-vars フラグを使用します。

gcloud functions deploy FUNCTION_NAME --set-env-vars FOO=bar FLAGS ...

カンマ区切りのリストを使用して、複数のランタイム環境変数を設定することもできます。

gcloud functions deploy FUNCTION_NAME --set-env-vars FOO=bar,BAZ=boo FLAGS...

ソース管理などで構成をファイルに保存する場合は、YAML ファイルと一緒に --env-vars-file フラグを使用します。

gcloud functions deploy FUNCTION_NAME --env-vars-file .env.yaml FLAGS...

.env.yaml ファイルの内容は次のとおりです。

 FOO: bar
 BAZ: boo

上の例で、FLAGS... は関数のデプロイ時に渡す他のオプションを表します。deploy コマンドの詳細については、gcloud functions deploy をご覧ください。

Google Cloud コンソール UI

ランタイム環境変数は、関数の作成時に、Google Cloud Console で次のように設定できます。

1. Google Cloud コンソールで関数の概要ページを開きます。

   Cloud Run functions の概要ページに移動

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

3. 関数の必須フィールドを入力します。

4. [ランタイム、ビルド、接続の設定] セクションを開きます。

5. [ランタイム] タブを選択します。

6. [ランタイム環境] セクションで、[変数を追加] をクリックして名前と値を追加します。

   既存の関数に環境変数を追加する方法については、ランタイム環境変数の更新をご覧ください。

gcloud

Google Cloud CLI を使用して変数を更新するには、デプロイ時に --update-env-vars フラグを使用します。

gcloud functions deploy FUNCTION_NAME --update-env-vars FOO=bar

カンマ区切りのリストを使用して、複数のランタイム環境変数を更新することもできます。

gcloud functions deploy FUNCTION_NAME --update-env-vars FOO=bar,BAZ=boo

Google Cloud コンソール UI

Google Cloud コンソールを使用してランタイム環境変数を更新するには:

1. Google Cloud コンソールで関数の概要ページを開きます。

   Cloud Run functions の概要ページに移動

2. 既存の関数をクリックして、その詳細ページに移動します。

3. [編集] をクリックします。

4. [ランタイム、ビルド、接続の設定] セクションを開きます。

5. [ランタイム] タブを選択します。

6. [ランタイム環境変数] セクションで必要な変更を加えます。

gcloud

ランタイム環境変数を個別に削除する場合は、デプロイ時に --remove-env-vars フラグを使用します。

gcloud functions deploy FUNCTION_NAME --remove-env-vars FOO,BAZ

あるいは、--clear-env-vars フラグを使用して、以前に設定した環境変数をすべてクリアします。

gcloud functions deploy FUNCTION_NAME --clear-env-vars

Google Cloud コンソール UI

Google Cloud コンソールを使用してランタイム環境変数を削除するには:

1. Google Cloud コンソールで関数の概要ページを開きます。

   Cloud Run functions の概要ページに移動

2. 既存の関数をクリックして、その詳細ページに移動します。

3. [編集] をクリックします。

4. [ランタイム、ビルド、接続の設定] セクションを開きます。

5. [ランタイム] タブを選択します。

6. [ランタイム環境変数] セクションで、Key-Value ペアの横にあるごみ箱アイコンをクリックして削除します。

Node.js

gcloud functions deploy envVar \
--runtime nodejs22 \
--set-env-vars FOO=bar \
--trigger-http

サポートされている Node.js バージョンのランタイム ID を指定して関数を実行するには、--runtime フラグを使用します。

Python

gcloud functions deploy env_vars \
--runtime python312 \
--set-env-vars FOO=bar \
--trigger-http

サポートされている Python バージョンのランタイム ID を指定して関数を実行するには、--runtime フラグを使用します。

Go

gcloud functions deploy EnvVar \
--runtime go122 \
--set-env-vars FOO=bar \
--trigger-http

サポートされている Go バージョンのランタイム ID を指定して関数を実行するには、--runtime フラグを使用します。

Java

gcloud functions deploy java-envVar-function \
--entry-point functions.EnvVars \
--runtime java21 \
--memory 512MB \
--set-env-vars FOO=bar \
--trigger-http

サポートされている Java バージョンのランタイム ID を指定して関数を実行するには、--runtime フラグを使用します。

C#

gcloud functions deploy csharp-envVar-function \
--entry-point EnvironmentVariables.Function \
--runtime dotnet8 \
--set-env-vars FOO=bar \
--trigger-http

サポートされている .NET バージョンのランタイム ID を指定して関数を実行するには、--runtime フラグを使用します。

Ruby

gcloud functions deploy env_vars --runtime ruby33 \
--set-env-vars FOO=bar \
--trigger-http

サポートされている Ruby バージョンのランタイム ID を指定して関数を実行するには、--runtime フラグを使用します。

PHP

 gcloud functions deploy envVar --runtime php83 \
--set-env-vars FOO=bar \
--trigger-http

サポートされている PHP バージョンのランタイム ID を指定して関数を実行するには、--runtime フラグを使用します。

Node.js

Node.js では、process.env プロパティを使用してランタイム環境変数にアクセスします。

exports.envVar = (req, res) => {
  // Sends 'bar' as response
  res.send(process.env.FOO);
};

Python

Python では、os.environ を使用してランタイム環境変数にアクセスします。

import os


def env_vars(request):
    return os.environ.get("FOO", "Specified environment variable is not set.")

Go

Go では、os.Getenv() を使用してランタイム環境変数にアクセスします。

// Package tips contains tips for writing Cloud Functions in Go.
package tips

import (
	"fmt"
	"net/http"
	"os"
)

// EnvVar is an example of getting an environment variable in a Go function.
func EnvVar(w http.ResponseWriter, r *http.Request) {
	fmt.Fprintf(w, "FOO: %q", os.Getenv("FOO"))
}

Java

Java では、System.getenv を使用してランタイム環境変数にアクセスします。

import com.google.cloud.functions.HttpFunction;
import com.google.cloud.functions.HttpRequest;
import com.google.cloud.functions.HttpResponse;
import java.io.BufferedWriter;
import java.io.IOException;

public class EnvVars implements HttpFunction {

  // Returns the environment variable "foo" set during function deployment.
  @Override
  public void service(HttpRequest request, HttpResponse response)
      throws IOException {
    BufferedWriter writer = response.getWriter();
    String foo = System.getenv("FOO");
    if (foo == null) {
      foo = "Specified environment variable is not set.";
    }
    writer.write(foo);
  }
}

C#

using Google.Cloud.Functions.Framework;
using Microsoft.AspNetCore.Http;
using System;
using System.Threading.Tasks;

namespace EnvironmentVariables;

public class Function : IHttpFunction
{
    public async Task HandleAsync(HttpContext context)
    {
        string foo = Environment.GetEnvironmentVariable("FOO")
            ?? "Specified environment variable is not set.";
        await context.Response.WriteAsync(foo, context.RequestAborted);
    }
}

Ruby

require "functions_framework"

FunctionsFramework.http "env_vars" do |_request|
  ENV["FOO"] || "Specified environment variable is not set."
end

PHP

use Psr\Http\Message\ServerRequestInterface;

function envVar(ServerRequestInterface $request): string
{
    return getenv('FOO') . PHP_EOL;
}

gcloud

Google Cloud CLI を使用して変数を設定するには、デプロイ時に --set-build-env-vars フラグを使用します。

gcloud beta functions deploy FUNCTION_NAME --set-build-env-vars FOO=bar FLAGS...

カンマ区切りのリストを使用して、複数のビルド環境変数を設定することもできます。

gcloud functions deploy FUNCTION_NAME --set-build-env-vars FOO=bar,BAZ=boo FLAGS...

ソース管理などで構成をファイルに保存する場合は、YAML ファイルと一緒に --build-env-vars-file フラグを使用します。

gcloud functions deploy FUNCTION_NAME --build-env-vars-file FILE_NAME.yaml FLAGS...

*.yaml ファイルの内容は次のとおりです。

 FOO: bar
 BAZ: boo

上の例で、FLAGS... は関数のデプロイ時に渡す他のオプションを表します。deploy コマンドの詳細については、gcloud beta functions deploy をご覧ください。

Google Cloud コンソール UI

ビルド環境変数は、関数を作成するときに Google Cloud Console で設定することもできます。

1. Google Cloud コンソールで関数の概要ページを開きます。

   Cloud Run functions の概要ページに移動

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

3. 関数の必須フィールドを入力します。

4. [ランタイム、ビルド、接続の設定] セクションを開きます。

5. [ビルド] タブを選択します。

6. [ビルド環境変数] セクションで、[変数を追加] をクリックして名前と値を追加します。

gcloud

Google Cloud CLI を使用して変数を設定するには、デプロイ時に --update-build-env-vars フラグを使用します。

gcloud functions deploy FUNCTION_NAME --update-build-env-vars FOO=bar

カンマ区切りのリストを使用して、複数のビルド環境変数を更新することもできます。

gcloud functions deploy FUNCTION_NAME --update-build-env-vars FOO=bar,BAZ=boo

Google Cloud コンソール UI

Google Cloud コンソールを使用してビルド環境変数を更新するには:

1. Google Cloud コンソールで関数の概要ページを開きます。

   Cloud Run functions の概要ページに移動

2. 既存の関数をクリックして、その詳細ページに移動します。

3. [編集] をクリックします。

4. [ランタイム、ビルド、接続の設定] セクションを開きます。

5. [ビルド] タブを選択します。

6. [ビルド環境変数] セクションで必要な変更を加えます。

gcloud

ビルド環境変数を個別に削除する場合は、デプロイ時に --remove-build-env-vars フラグを使用します。

gcloud functions deploy FUNCTION_NAME --remove-build-env-vars FOO,BAZ

あるいは、--clear-build-env-vars フラグを使用して、以前に設定したすべてのビルド環境変数をクリアします。

gcloud functions deploy FUNCTION_NAME --clear-build-env-vars

Google Cloud コンソール UI

Google Cloud コンソールを使用してビルド環境変数を削除するには:

1. Google Cloud コンソールで関数の概要ページを開きます。

   Cloud Run functions の概要ページに移動

2. 既存の関数をクリックして、その詳細ページに移動します。

3. [編集] をクリックします。

4. [ランタイム、ビルド、接続の設定] セクションを開きます。

5. [ビルド] タブを選択します。

6. [ビルド環境変数] セクションで、Key-Value ペアの横にあるごみ箱アイコンをクリックして削除します。