設定環境變數 (第 1 代)

gcloud

如要使用 Google Cloud CLI 設定執行階段環境變數，請在部署時間使用 --set-env-vars 標記：

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

您也可以使用以半形逗號分隔的清單，設定多個執行階段環境變數：

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

如果您想將設定儲存在檔案中 (例如在來源控管下)，可以使用 YAML 檔案搭配 --env-vars-file 標記：

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

.env.yaml 檔案的內容如下：

 FOO: bar
 BAZ: boo

在上述範例中，FLAGS... 代表您在部署函式期間傳送的其他選項。如需 deploy 指令的完整參考資料，請參閱 gcloud functions deploy。

Google Cloud 主控台 UI

您可以在 Google Cloud 主控台建立函式時設定執行階段環境變數：

1. 在 Google Cloud 控制台中開啟「Functions Overview」(函式總覽) 頁面：

   前往「Cloud Run functions」(Cloud Run 函式) 總覽頁面。

2. 按一下「建立函式」。

3. 為函式填寫必填欄位。

4. 開啟「執行階段、建構作業和連線設定」部分。

5. 選取「Runtime」分頁標籤。

6. 在「Runtime environment variables」(執行階段環境變數) 部分，按一下「Add variable」(新增變數)，然後新增名稱和值。

   如需將環境變數新增至現有函式的操作說明，請參閱「更新執行階段環境變數」。

gcloud

如要使用 Google Cloud CLI 更新變數，請在部署時使用 --update-env-vars 旗標：

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

您也可以使用以半形逗號分隔的清單更新多個執行階段環境變數：

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

Google Cloud 主控台 UI

如要使用 Google Cloud 控制台更新執行階段環境變數，請按照下列步驟操作：

1. 在 Google Cloud 控制台中開啟「Functions Overview」(函式總覽) 頁面：

   前往「Cloud Run functions」(Cloud Run 函式) 總覽頁面。

2. 請點選現有函式前往其詳細資料頁面。

3. 按一下 [編輯]。

4. 開啟「執行階段、建構作業和連線設定」部分。

5. 選取「Runtime」分頁標籤。

6. 在「執行階段環境變數」部分進行編輯。

gcloud

如果您想有選擇地移除執行階段環境變數，可以在部署時使用 --remove-env-vars 標記：

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

或者，您也可以使用 --clear-env-vars 標記清除先前設定的所有執行階段環境變數：

gcloud functions deploy FUNCTION_NAME --no-gen2 --clear-env-vars

Google Cloud 主控台 UI

如要使用 Google Cloud 控制台刪除執行階段環境變數，請按照下列步驟操作：

1. 在 Google Cloud 控制台中開啟「Functions Overview」(函式總覽) 頁面：

   前往「Cloud Run functions」(Cloud Run 函式) 總覽頁面。

2. 請點選現有函式前往其詳細資料頁面。

3. 按一下 [編輯]。

4. 開啟「執行階段、建構作業和連線設定」部分。

5. 選取「Runtime」分頁標籤。

6. 在「Runtime environment variables」區段中，按一下鍵/值組旁邊的垃圾桶圖示，即可刪除該組。

Node.js

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

使用 --runtime 標記指定支援的 Node.js 版本的執行階段 ID，以便執行函式。

Python

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

使用 --runtime 標記，指定支援的 Python 版本的執行階段 ID，以便執行函式。

Go

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

使用 --runtime 標記，指定支援的 Go 版本的執行階段 ID，以便執行函式。

Java

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

使用 --runtime 標記，指定支援的 Java 版本的執行階段 ID，以便執行函式。

C#

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

使用 --runtime 標記，指定支援的 .NET 版本的執行階段 ID，以便執行函式。

Ruby

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

使用 --runtime 標記，指定支援的 Ruby 版本的執行階段 ID，以便執行函式。

PHP

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

使用 --runtime 標記，指定支援的 PHP 版本的執行階段 ID，以便執行函式。

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 --no-gen2 --set-build-env-vars FOO=bar FLAGS...

您也可以使用以半形逗號分隔的清單設定多個建構環境變數：

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

如果您想將設定儲存在檔案中 (例如在原始碼管控下)，可以使用 YAML 檔案搭配 --build-env-vars-file 標記：

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

*.yaml 檔案的內容如下：

 FOO: bar
 BAZ: boo

在上述範例中，FLAGS... 代表您在部署函式期間傳送的其他選項。如需 deploy 指令的完整參考資料，請參閱 gcloud beta functions deploy。

Google Cloud 主控台 UI

您也可以在 Google Cloud 主控台建立函式期間設定建構環境變數：

1. 在 Google Cloud 控制台中開啟「Functions Overview」(函式總覽) 頁面：

   前往「Cloud Run functions」(Cloud Run 函式) 總覽頁面。

2. 按一下「建立函式」。

3. 為函式填寫必填欄位。

4. 開啟「執行階段、建構作業和連線設定」部分。

5. 選取「Build」分頁標籤。

6. 在「Build environment variables」部分，按一下「Add variable」，然後新增名稱和值。

gcloud

如要使用 Google Cloud CLI 設定變數，請在部署時使用 --update-build-env-vars 標記：

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

您也可以使用以半形逗號分隔的清單更新多個建構環境變數：

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

Google Cloud 主控台 UI

如要使用 Google Cloud 控制台更新建構環境變數，請按照下列步驟操作：

1. 在 Google Cloud 控制台中開啟「Functions Overview」(函式總覽) 頁面：

   前往「Cloud Run functions」(Cloud Run 函式) 總覽頁面。

2. 請點選現有函式前往其詳細資料頁面。

3. 按一下 [編輯]。

4. 開啟「執行階段、建構作業和連線設定」部分。

5. 選取「Build」分頁標籤。

6. 在「Build environment variables」部分進行編輯。

gcloud

如果您想有選擇地移除建構環境變數，可以在部署時使用 --remove-build-env-vars 標記：

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

或者，您也可以使用 --clear-build-env-vars 標記，清除先前設定的所有建構環境變數：

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

Google Cloud 主控台 UI

如要使用 Google Cloud 控制台刪除建構環境變數，請按照下列步驟操作：

1. 在 Google Cloud 控制台中開啟「Functions Overview」(函式總覽) 頁面：

   前往「Cloud Run functions」(Cloud Run 函式) 總覽頁面。

2. 請點選現有函式前往其詳細資料頁面。

3. 按一下 [編輯]。

4. 開啟「執行階段、建構作業和連線設定」部分。

5. 選取「Build」分頁標籤。

6. 在「Build environment variables」區段中，按一下鍵/值組旁的垃圾桶圖示，即可刪除該組合。