云函数 环境变量

一、使用控制台新增环境变量

1. 登录 Serverless 控制台，单击左侧的函数服务。

2. 在创建函数的过程中，或针对已创建的函数进行编辑时，可在“环境变量”中，增加环境变量。
环境变量通常以 key-value 对的形式出现，请在环境变量的输入框中，前一输入框输入所需的环境变量 key，后一输入框输入所需的环境变量 value。注意，key、value 的取值必须以字母起始，只能包含字母、数字及"_"，长度不小于 2 位且不大于 64 字节。

二、本地新增环境变量

1. 本地开发时，在 serverless.yml 文件中找到需要配置环境变量的函数，添加 environment 配置项。如下所示：

component: scf # (必选) 组件名称，在该实例中为scfname: scfdemo # (必选) 组件实例名称。#组件参数配置inputs: name: scfdemo # 云函数名称，默认为 ${name}-${stage}-${app} namespace: default # 1. 默认写法，新建特定命名的 cos bucket 并上传 src: ./src type: event # 函数类型，默认为 event(事件类型)，web(web类型) handler: index.main_handler #入口（函数类型为事件类型时生效） runtime: Nodejs10.15 # 运行环境 默认 Nodejs10.15 region: ap-guangzhou # 函数所在区域 description: This is a function in ${app} application. memorySize: 128 # 内存大小，单位MB timeout: 20 # 函数执行超时时间，单位秒 initTimeout: 3 # 初始化超时时间，单位秒 environment: # 环境变量 variables: # 环境变量对象 TEST1: value1 TEST2: value2

2. 保存 serverless.yml 文件，并在命令行窗口中执行 scf deploy 命令部署到云端。

三、查看环境变量

在配置好云函数的环境变量后，可通过查看云函数的函数配置，查询到具体已配置的环境变量，环境变量以 key=value 的形式显示。

四、使用环境变量

已配置的环境变量，会在函数运行时配置到函数所在的运行环境中，可通过代码读取系统环境变量的方式来获取到具体值并在代码中使用。需要注意的是，环境变量无法在本地进行读取。
假设针对云函数，配置的环境变量的 key 为 key，以下为各运行环境读取并打印此环境变量值的示例代码。

·在 Python 运行环境中，读取环境变量的方法为：

import osvalue = os.environ.get('key')print(value)

·在 Node.js 运行环境中，读取环境变量的方法为：

var value = process.env.keyconsole.log(value)

·在 Java 运行环境中，读取环境变量的方法分为临时授权字段和其他字段两种情况：

·临时授权字段包括：TENCENTCLOUD_SESSIONTOKEN、TENCENTCLOUD_SECRETID、TENCENTCLOUD_SECRETKEY，读取环境变量的方法为：

System.out.println("value: "+ System.getProperty("key"));

·其他字段，读取环境变量的方法为：

System.out.println("value: "+ System.getenv("key"));

·在 Golang 运行环境中，读取环境变量的方法为：

import "os"var value stringvalue = os.Getenv("key")

·在 PHP 运行环境中，读取环境变量的方法为：

$value = getenv('key');

五、使用场景

·可变值提取：针对业务中有可能会变动的值，提取至环境变量中，可避免需要根据业务变更而修改代码。

·加密信息外置：认证、加密相关的 key，从代码中提取至环境变量，可避免相关 key 硬编码在代码中而引起的安全风险。

·环境区分：针对不同开发阶段所要进行的配置和数据库信息，可提取到环境变量中。针对开发和发布的不同阶段，仅需要修改环境变量的值，分别执行开发环境数据库和发布环境数据库即可。

六、使用限制

针对云函数的环境变量，有如下使用限制：

·key 必须以字母 [a-zA-Z] 开头，只能包含字母数字字符和下划线（ [a-zA-Z0-9_]）。

·预留的环境变量 key 无法配置。预留的 key 包括：

·SCF_ 开头的 key，例如 SCF_RUNTIME。

·QCLOUD_ 开头的 key，例如 QCLOUD_APPID。

·TENCENTCLOUD_ 开头的 key，例如 TENCENTCLOUD_SECRETID。

七、已内置环境变量

目前运行环境中已内置的环境变量的 Key 及 Value 见下表：

注意：获取临时密钥信息的代码，需放在 main 函数中触发。详情请参见 角色与策略。