精读《如何在 nodejs 使用环境变量》

智码棱镜客
• 阅读 12652

1 引言

本期精读的文章是:如何在 nodejs 使用环境变量

介绍了开发与生产环境如何管理环境变量。

这里环境变量指的是数据库密码等重要数据,而不是指普通变量传参。

2 概述

环境变量历史悠久,在运行第一行 JAVA 代码之前,你就得将环境变量设置好。

精读《如何在 nodejs 使用环境变量》

可问题是,系统变量并不易用,比如结尾是否要使用分号,JAVA_HOME 与 PATH 在哪些程序中功能相同?而且与操作系统绑定,在操作系统级别设置的变量,给 JAVA 级别的程序用还好,但用来存数据库密码就不合适了。

在 Node 中,我们怎样使用环境变量呢?作者给出了如下的建议:

通过命令行传递

PORT=65534 node bin/www

这是最基本、最常用的方式,可是当变量数量过多,不免觉得很崩溃:

PORT=65534 DB_CONN="mongodb://react-cosmos-db:swQOhAsVjfHx3Q9VXh29T9U8xQNVGQ78lEQaL6yMNq3rOSA1WhUXHTOcmDf38Q8rg14NHtQLcUuMA==@react-cosmos-db.documents.azure.com:19373/?ssl=true&replicaSet=globaldb" SECRET_KEY=b6264fca-8adf-457f-a94f-5a4b0d1ca2b9  node bin/www

作者提到,这种代码没有拓展性。作者认为,对工程师来说,可拓展性甚至比能正确运行更为重要。

使用 .env 文件

很显然,命令行写不下了就写到文件里:

PORT=65534
DB_CONN="mongodb://react-cosmos-db:swQOhAsVjfHx3Q9VXh29T9U8xQNVGQ78lEQaL6yMNq3rOSA1WhUXHTOcmDf38Q8rg14NHtQLcUuMA==@react-cosmos-db.documents.azure.com:10255/?ssl=true&replicaSet=globaldb"
SECRET_KEY="b6264fca-8adf-457f-a94f-5a4b0d1ca2b9"

通过 dotenv 这个 npm 包可以读取 .env 文件的配置到 Nodejs 程序中。

npm install dotenv --save

安装后,直接调用它解析,就可以从环境变量中拿到 .env 文件的配置信息了:

require("dotenv").config();
var MongoClient = require("mongodb").MongoClient;

// Reference .env vars off of the process.env object
MongoClient.connect(
  process.env.DB_CONN,
  function(err, db) {
    if (!err) {
      console.log("We are connected");
    }
  }
);

这有个问题,不要将配置文件发送到 Git 仓库,可能会泄漏隐私数据。然而 VSCode 帮你解决了这个问题(什么,你不用 VSCode?)

VSCode 启动配置

精读《如何在 nodejs 使用环境变量》

VSCode 可以配置 Node 启动配置,在这里可以设置环境变量:

精读《如何在 nodejs 使用环境变量》

为了和 .env 文件打通,我们可以在配置里设置 envFile 属性:

{
  "envFile": "${workspaceFolder}/.env"
}

程序中依然使用 dotenv 读取环境变量。这么做将配置保留在 VSCode 中,而不是代码中,不用再担心不小心上传了配置文件啦!

使用 Npm Scripts

作者推荐了一个良好的习惯:使用 npm start 运行项目,而不是暴露出 Node 命令。那么首先在 VSCode launch.json 中配置 Npm 模式:

精读《如何在 nodejs 使用环境变量》

记住,需要给 Node 脚本添加 --inspect 参数,才能触发 VSCode debugger 的钩子:

精读《如何在 nodejs 使用环境变量》

这样一来,通过 npm start 就可以启动 Node,并读取配置在 VSCode 的环境变量。

生产环境的环境变量

上面介绍了本地开发如何使用环境变量,但在生产环境,环境变量必须得换个方式管理。

不知道作者与微软是什么关系,这块推荐了微软的 Azure 管理环境变量。

主要思路是通过一个不赚差价的中间商提供环境变量管理服务。通过 Azure CLI 启动你的 Node 项目,就可以从云服务平台拿到环境变量信息。

3 精读

环境变量管理是非常重要的问题,以前还看到将公司数据库密码提交到 Github 的例子,反面教材非常多。

本文介绍了许多本地开发使用环境变量的方式,笔者补充一下生产环境使用环境变量的经验。

私有部署

如果你在一个高自动化运维水平的公司,这个问题已经被私有 Git + 私有云服务器天然解决了。

精读《如何在 nodejs 使用环境变量》

是的,部署私有 Git,把数据库密码提交到 Git 仓库才是最完美的方案!

持久化配置服务

通过自建,或者开源的 Azure 持久化配置服务存储环境变量,在服务器利用 SDK 获取它。

一般云服务商都会打包这项服务,因为只有服务器和持久化配置服务都由一个供应商提供,供应商才能将持久化配置与服务器权限形成关联,让第三方服务器即便拿到 Token 也无法访问配置。

加密服务

如果安全级别特别高,内部 Git 都不允许提交,又要防止第三方(比如某宽带运营商)拦截到信息,就要使用加密服务了。

流程一般是:

  1. 在加密平台注册,拿到密钥。
  2. 在加密平台设置环境变量,加密平台会对内容进行加密。
  3. 利用 Node SDK 获取到加密平台输出的密文。
  4. 利用 SDK 和密钥解密成明文。

4 总结

对待在基础设施完备公司的同学,可能不需要关心环境变量安全性问题。对于自己搭建博客,或者使用第三方服务器的同学,这篇文章告诉我们三个注意点:

  1. 不要将重要环境变量提交到公开的 Git 仓库。
  2. 本地通过 VSCode 调试环境变量既方便又安全。
  3. 生产环境通过云服务商提供的环境变量配置服务拿到环境变量。

5 更多讨论

讨论地址是:精读《如何在 nodejs 使用环境变量》 · Issue #89 · dt-fe/weekly

如果你想参与讨论,请点击这里,每周都有新的主题,周末或周一发布。

点赞
收藏
评论区
推荐文章
blmius blmius
4年前
MySQL:[Err] 1292 - Incorrect datetime value: ‘0000-00-00 00:00:00‘ for column ‘CREATE_TIME‘ at row 1
文章目录问题用navicat导入数据时,报错:原因这是因为当前的MySQL不支持datetime为0的情况。解决修改sql\mode:sql\mode:SQLMode定义了MySQL应支持的SQL语法、数据校验等,这样可以更容易地在不同的环境中使用MySQL。全局s
Wesley13 Wesley13
3年前
MySQL部分从库上面因为大量的临时表tmp_table造成慢查询
背景描述Time:20190124T00:08:14.70572408:00User@Host:@Id:Schema:sentrymetaLast_errno:0Killed:0Query_time:0.315758Lock_
美凌格栋栋酱 美凌格栋栋酱
7个月前
Oracle 分组与拼接字符串同时使用
SELECTT.,ROWNUMIDFROM(SELECTT.EMPLID,T.NAME,T.BU,T.REALDEPART,T.FORMATDATE,SUM(T.S0)S0,MAX(UPDATETIME)CREATETIME,LISTAGG(TOCHAR(
Karen110 Karen110
4年前
一篇文章带你了解JavaScript日期
日期对象允许您使用日期(年、月、日、小时、分钟、秒和毫秒)。一、JavaScript的日期格式一个JavaScript日期可以写为一个字符串:ThuFeb02201909:59:51GMT0800(中国标准时间)或者是一个数字:1486000791164写数字的日期,指定的毫秒数自1970年1月1日00:00:00到现在。1\.显示日期使用
皕杰报表之UUID
​在我们用皕杰报表工具设计填报报表时,如何在新增行里自动增加id呢?能新增整数排序id吗?目前可以在新增行里自动增加id,但只能用uuid函数增加UUID编码,不能新增整数排序id。uuid函数说明:获取一个UUID,可以在填报表中用来创建数据ID语法:uuid()或uuid(sep)参数说明:sep布尔值,生成的uuid中是否包含分隔符'',缺省为
待兔 待兔
1年前
手写Java HashMap源码
HashMap的使用教程HashMap的使用教程HashMap的使用教程HashMap的使用教程HashMap的使用教程22
Jacquelyn38 Jacquelyn38
4年前
2020年前端实用代码段,为你的工作保驾护航
有空的时候,自己总结了几个代码段,在开发中也经常使用,谢谢。1、使用解构获取json数据let jsonData  id: 1,status: "OK",data: 'a', 'b';let  id, status, data: number   jsonData;console.log(id, status, number )
Wesley13 Wesley13
3年前
FLV文件格式
1.        FLV文件对齐方式FLV文件以大端对齐方式存放多字节整型。如存放数字无符号16位的数字300(0x012C),那么在FLV文件中存放的顺序是:|0x01|0x2C|。如果是无符号32位数字300(0x0000012C),那么在FLV文件中的存放顺序是:|0x00|0x00|0x00|0x01|0x2C。2.  
Wesley13 Wesley13
3年前
mysql设置时区
mysql设置时区mysql\_query("SETtime\_zone'8:00'")ordie('时区设置失败,请联系管理员!');中国在东8区所以加8方法二:selectcount(user\_id)asdevice,CONVERT\_TZ(FROM\_UNIXTIME(reg\_time),'08:00','0
Wesley13 Wesley13
3年前
PHP创建多级树型结构
<!lang:php<?php$areaarray(array('id'1,'pid'0,'name''中国'),array('id'5,'pid'0,'name''美国'),array('id'2,'pid'1,'name''吉林'),array('id'4,'pid'2,'n
Python进阶者 Python进阶者
1年前
Excel中这日期老是出来00:00:00,怎么用Pandas把这个去除
大家好,我是皮皮。一、前言前几天在Python白银交流群【上海新年人】问了一个Pandas数据筛选的问题。问题如下:这日期老是出来00:00:00,怎么把这个去除。二、实现过程后来【论草莓如何成为冻干莓】给了一个思路和代码如下:pd.toexcel之前把这
智码棱镜客
智码棱镜客
Lv1
稚子牵衣问归来何太迟?共谁争岁月;赢得鬓边丝?
文章
5
粉丝
0
获赞
0