語言 › Node.js

使用 Docker 部署 Node.js 應用程式

在 Docker 上使用加密的 .env.vault 檔案部署 Node.js 應用程式。

初始設定

建立一個 index.js 檔案（如果尚未建立）。

index.js

// index.js
const PORT = process.env.PORT || 3000
const http = require('http')
const server = http.createServer((req, res) => {
  res.statusCode = 200
  res.setHeader('Content-Type', 'text/plain')
  res.end(`Hello ${process.env.HELLO}`)
})

server.listen(PORT, () => {
  console.log(`Server running on port:${PORT}/`)
})

新增 package.json 檔案。

package.json

{
  "scripts": {
    "start": "node index.js"
  }
}

新增一個 Dockerfile。

Dockerfile

# Dockerfile
FROM node:16
WORKDIR /usr/src/app
COPY package*.json ./
RUN npm install
COPY . .
EXPOSE 3000
CMD node index.js

將其提交到程式碼，並使用 Docker 在本機建置。

docker build -t docker-nodejs . && docker run --rm -it -p 3000:3000 --init docker-nodejs

您的應用程式正在 Docker 上執行

建置完成後，您的應用程式將在 localhost:3000 上顯示 'Hello undefined'，因為它沒有存取環境變數的方式。接下來我們來處理這個問題。

安裝 dotenv

安裝 dotenv。

npm install dotenv --save # Requires dotenv >= 16.1.0

在您的專案根目錄中建立一個 .env 檔案。

.env

# .env
HELLO="World"

在您的應用程式中盡可能提早匯入並設定 dotenv。

index.js

// index.js
require('dotenv').config()
console.log(process.env) // remove this after you've confirmed it is working

const PORT = process.env.PORT || 3000
const http = require('http')
...

嘗試在本機重新建置。

docker build -t docker-nodejs . && docker run --rm -it -p 3000:3000 --init docker-nodejs
{
  ...
  HELLO: 'World'
}
Server running on port:3000/

完美。process.env 現在具有您在 .env 檔案中定義的金鑰和值。

localhost

這涵蓋了本機開發建置。接下來，我們來解決生產環境的問題。

建置 .env.vault

推送您最新的 .env 檔案變更，並編輯您的生產密鑰。瞭解更多關於同步的資訊

npx dotenv-vault@latest push
npx dotenv-vault@latest open production

使用 UI 來設定每個環境的這些密鑰。

www.dotenv.org

然後建置您加密的 .env.vault 檔案。

npx dotenv-vault@latest build

其內容應如下所示。

.env.vault

#/-------------------.env.vault---------------------/
#/         cloud-agnostic vaulting standard         /
#/   [how it works](https://dotenv.org/env-vault)   /
#/--------------------------------------------------/

# development
DOTENV_VAULT_DEVELOPMENT="/HqNgQWsf6Oh6XB9pI/CGkdgCe6d4/vWZHgP50RRoDTzkzPQk/xOaQs="
DOTENV_VAULT_DEVELOPMENT_VERSION=2

# production
DOTENV_VAULT_PRODUCTION="x26PuIKQ/xZ5eKrYomKngM+dO/9v1vxhwslE/zjHdg3l+H6q6PheB5GVDVIbZg=="
DOTENV_VAULT_PRODUCTION_VERSION=2

設定 DOTENV_KEY

取得您的生產 DOTENV_KEY。

npx dotenv-vault@latest keys production
# outputs: dotenv://:[email protected]/vault/.env.vault?environment=production

為 Docker 執行設定 DOTENV_KEY。

docker build -t docker-nodejs . && docker run -e DOTENV_KEY="dotenv://:[email protected]/vault/.env.vault?environment=production" --rm -it -p 3000:3000 --init docker-nodejs

這裡的重要部分是 -e 旗標。如需更多資訊，請參閱 Docker 環境變數。

執行 Docker

將這些變更安全地提交到程式碼，並在 Docker 上執行。

就是這樣！在建置和執行時，您的 .env.vault 檔案將被解密，其生產密鑰將會即時注入為環境變數。

當您在記錄中看到 'Loading env from encrypted .env.vault' 時，您就知道事情已正確運作。如果未設定 DOTENV_KEY（例如在本機機器上開發時），它將會回復到標準的 dotenv 功能。

docker build -t && docker run -e

您已成功使用新的 .env.vault 標準來加密和部署您的密鑰。這比將您的密鑰分散在多個第三方平台和工具上安全得多。每當您需要新增或變更密鑰時，只需重新建置您的 .env.vault 檔案並重新部署即可。