serverless-dotenv-plugin

Preload Environment Variables with Dotenv into Serverless

Github星跟蹤圖

serverless-dotenv-plugin npm version

Donate

Preload Environment Variables Into Serverless

Use this plugin if you have variables stored in a .env file that you want loaded into your serverless yaml config. This will allow you to reference them as ${env:VAR_NAME} inside your config and it will load them into your lambdas.

Install and Setup

First, install the plugin:

> npm i -D serverless-dotenv-plugin

Next, add the plugin to your serverless config file:

service: myService
plugins:
  - serverless-dotenv-plugin
...

Now, just like you would using dotenv in any other JS application, create your .env file in the root of your app:

DYANMODB_TABLE=myTable
AWS_REGION=us-west-1
AUTH0_CLIENT_ID=abc12345
AUTH0_CLIENT_SECRET=12345xyz

Automatic Env file name resolution

By default, the plugin looks for the file: .env. In most use cases this is all that is needed. However, there are times where you want different env files based on environment. For instance:

.env.development
.env.production

When you deploy with NODE_ENV set: NODE_ENV=production sls deploy the plugin will look for a file named .env.production. If it doesn't exist it will default to .env. If for some reason you can't set NODE_ENV, you could always just pass it in as an option: sls deploy --env production. If NODE_ENV or --env is not set, it will default to development., Valid .env file names, Description, ---------------------, ---------------------------------------------------------------------------------------------------, .env, Default file name when no other files are specified or found., .env.development, If NODE_ENV or --env is not set, will try to load .env.development. If not found, load .env, .env.{ENV}, If NODE_ENV or --env is set, will try to load .env.{env}. If not found, load .env, ### Plugin options

path: path/to/my/.env

The plugin will look for your .env file in the same folder where you run the command using the file resolution rules as described above, but these rules can be overridden by setting the path option.

basePath: path/to/my/

The problem with setting the path option is that you lose environment resolution on the file names. If you don't need environment resolution, the path option is just fine. If you do, then use the basePath option.

include: ...

All env vars found in your file will be injected into your lambda functions. If you do not want all of them to be injected into your lambda functions, you can whitelist them with the include option. (Note that there is currently no "blacklist" option)

Complete example:

custom:
  dotenv:
    path: path/to/my/.env (default ./.env)
    basePath: path/to/ (default ./)
    include:
      - AUTH0_CLIENT_ID
      - AUTH0_CLIENT_SECRET

Usage

Once loaded, you can now access the vars using the standard method for accessing ENV vars in serverless:

...
provider:
  name: aws
  runtime: nodejs6.10
  stage: ${env:STAGE}
  region: ${env:AWS_REGION}
...

Lambda Environment Variables

Again, remember that when you deploy your service, the plugin will inject these environment vars into any lambda functions you have and will therefore allow you to reference them as process.env.AUTH0_CLIENT_ID (Nodejs example).

Examples

You can find example usage in the examples folder.

主要指標

概覽
名稱與所有者neverendingqs/serverless-dotenv-plugin
主編程語言JavaScript
編程語言JavaScript (語言數: 1)
平台
許可證MIT License
所有者活动
創建於2017-08-07 07:04:11
推送於2025-07-01 15:14:23
最后一次提交2024-12-30 17:53:51
發布數26
最新版本名稱v6.0.0 (發布於 2023-03-19 01:50:18)
第一版名稱3.0.0 (發布於 )
用户参与
星數354
關注者數5
派生數52
提交數236
已啟用問題?
問題數77
打開的問題數5
拉請求數116
打開的拉請求數33
關閉的拉請求數47
项目设置
已啟用Wiki?
已存檔?
是復刻?
已鎖定?
是鏡像?
是私有?