如何将环境变量传递给 Docker 容器？

Question

我是 Docker 新手，不清楚如何从容器访问外部数据库。在连接字符串中硬编码是最好的方法吗？

# Dockerfile
ENV DATABASE_URL amazon:rds/connection?string

Answer 1

您可以使用 -e 标志将环境变量传递给您的容器。

来自启动脚本的示例：

sudo docker run -d -t -i -e REDIS_NAMESPACE='staging' \ 
-e POSTGRES_ENV_POSTGRES_PASSWORD='foo' \
-e POSTGRES_ENV_POSTGRES_USER='bar' \
-e POSTGRES_ENV_DB_NAME='mysite_staging' \
-e POSTGRES_PORT_5432_TCP_ADDR='docker-db-1.hidden.us-east-1.rds.amazonaws.com' \
-e SITE_URL='staging.mysite.com' \
-p 80:80 \
--link redis:redis \  
--name container_name dockerhub_id/image_name

或者，如果您不希望在命令行上显示该值，ps 等将显示该值，-e 可以从当前环境中提取值，只要您提供它没有=:

sudo PASSWORD='foo' docker run  [...] -e PASSWORD [...]

如果你有很多环境变量，特别是如果它们是保密的，你可以use an env-file:

$ docker run --env-file ./env.list ubuntu bash

--env-file 标志将文件名作为参数，并期望每一行都采用 VAR=VAL 格式，模仿传递给 --env 的参数。注释行只需要以#

为前缀

Answer 2

如here 和@errata 所述，您可以使用docker run .. 命令传递-e 参数。

但是，这种方法的可能缺点是您的凭据将显示在您运行它的进程列表中。

为了使其更安全，您可以在配置文件中写入您的凭据，并使用--env-file 执行docker run，如here 所述。然后您可以控制该配置文件的访问权限，以便其他有权访问该计算机的人看不到您的凭据。

Answer 3

如果您使用“docker-compose”作为启动容器的方法，实际上有一种有用的方法可以将服务器上定义的环境变量传递给 Docker 容器。

在您的 docker-compose.yml 文件中，假设您正在构建一个基本的 hapi-js 容器，代码如下所示：

hapi_server:
  container_name: hapi_server
  image: node_image
  expose:
    - "3000"

假设您的 docker 项目所在的本地服务器有一个名为“NODE_DB_CONNECT”的环境变量，您希望将其传递给您的 hapi-js 容器，并且您希望它的新名称为“HAPI_DB_CONNECT”。然后在docker-compose.yml 文件中，将本地环境变量传递给容器并重命名，如下所示：

hapi_server:
  container_name: hapi_server
  image: node_image
  environment:
    - HAPI_DB_CONNECT=${NODE_DB_CONNECT}
  expose:
    - "3000"

我希望这可以帮助您避免在容器中的任何文件中硬编码数据库连接字符串！

Answer 4

使用-e 或--env 值设置环境变量（默认[]）。

来自启动脚本的示例：

 docker run  -e myhost='localhost' -it busybox sh

如果您想从命令行使用多个环境，那么在每个环境变量之前使用 -e 标志。

例子：

 sudo docker run -d -t -i -e NAMESPACE='staging' -e PASSWORD='foo' busybox sh

注意：确保将容器名称放在环境变量之后，而不是之前。

如果您需要设置许多变量，请使用--env-file 标志

例如，

 $ docker run --env-file ./my_env ubuntu bash

如需任何其他帮助，请查看 Docker 帮助：

 $ docker run --help

官方文档： https://docs.docker.com/compose/environment-variables/

Answer 5

使用docker-compose，您可以继承 docker-compose.yml 中的环境变量以及随后由docker-compose 调用的任何 Dockerfile(s) 以构建映像。这在 Dockerfile RUN 命令应该执行特定于环境的命令时很有用。

（您的 shell 环境中已经存在 RAILS_ENV=development）

docker-compose.yml：

version: '3.1'
services:
  my-service: 
    build:
      #$RAILS_ENV is referencing the shell environment RAILS_ENV variable
      #and passing it to the Dockerfile ARG RAILS_ENV
      #the syntax below ensures that the RAILS_ENV arg will default to 
      #production if empty.
      #note that is dockerfile: is not specified it assumes file name: Dockerfile
      context: .
      args:
        - RAILS_ENV=${RAILS_ENV:-production}
    environment: 
      - RAILS_ENV=${RAILS_ENV:-production}

Dockerfile：

FROM ruby:2.3.4

#give ARG RAILS_ENV a default value = production
ARG RAILS_ENV=production

#assign the $RAILS_ENV arg to the RAILS_ENV ENV so that it can be accessed
#by the subsequent RUN call within the container
ENV RAILS_ENV $RAILS_ENV

#the subsequent RUN call accesses the RAILS_ENV ENV variable within the container
RUN if [ "$RAILS_ENV" = "production" ] ; then echo "production env"; else echo "non-production env: $RAILS_ENV"; fi

这样，我就不需要在文件或docker-composebuild/up命令中指定环境变量：

docker-compose build
docker-compose up

Answer 6

有一个很好的 hack 如何将主机环境变量通过管道传输到 docker 容器：

env > env_file && docker run --env-file env_file image_name

非常小心地使用这种技术，因为env > env_file 会将ALL 主机ENV 变量转储到env_file 并使其在运行的容器中可访问。

Answer 7

我们还可以使用 -e 标志和 $ 来使用主机环境变量：

在运行以下命令之前，需要导出（意味着设置）本地环境变量。

docker run -it -e MG_HOST=$MG_HOST \
    -e MG_USER=$MG_USER \
    -e MG_PASS=$MG_PASS \
    -e MG_AUTH=$MG_AUTH \
    -e MG_DB=$MG_DB \
    -t image_tag_name_and_version

通过使用此方法，您可以使用您的给定名称自动设置环境变量。在我的情况下（MG_HOST，MG_USER）

另外：

如果您使用的是 python，您可以通过以下方式访问 docker 内的这些环境变量

import os

host = os.environ.get('MG_HOST')
username = os.environ.get('MG_USER')
password = os.environ.get('MG_PASS')
auth = os.environ.get('MG_AUTH')
database = os.environ.get('MG_DB')

Answer 8

我遇到的问题是我将 --env-file 放在命令的末尾

docker run -it --rm -p 8080:80 imagename --env-file ./env.list

修复

docker run --env-file ./env.list -it --rm -p 8080:80 imagename

Answer 9

另一种方法是使用/usr/bin/env的力量：

docker run ubuntu env DEBUG=1 path/to/script.sh

Answer 10

对于 Amazon AWS ECS/ECR，您应该通过私有 S3 存储桶管理您的环境变量（尤其是机密）。请参阅博文 How to Manage Secrets for Amazon EC2 Container Service–Based Applications by Using Amazon S3 and Docker。

Answer 11

如果你在本地有一个env.sh的环境变量，并且想在容器启动时设置它，你可以试试

COPY env.sh /env.sh
COPY <filename>.jar /<filename>.jar
ENTRYPOINT ["/bin/bash" , "-c", "source /env.sh && printenv && java -jar /<filename>.jar"]

此命令将使用 bash shell 启动容器（我想要一个 bash shell，因为 source 是一个 bash 命令），获取 env.sh 文件（设置环境变量）并执行 jar 文件。

env.sh 看起来像这样，

#!/bin/bash
export FOO="BAR"
export DB_NAME="DATABASE_NAME"

我添加了printenv 命令只是为了测试实际的源命令是否有效。当您确认源命令正常工作或环境变量将出现在您的 docker 日志中时，您可能应该将其删除。

Answer 12

docker run --rm -it --env-file <(bash -c 'env | grep <your env data>') 是一种 gr​​ep 存储在 .env 中的数据并将它们传递给 Docker 的方法，而不会不安全地存储任何内容（因此您不能只查看 docker history 并获取密钥。

假设您的 .env 中有大量 AWS 内容，如下所示：

AWS_ACCESS_KEY: xxxxxxx
AWS_SECRET: xxxxxx
AWS_REGION: xxxxxx

使用docker run --rm -it --env-file <(bash -c 'env | grep AWS_') 运行 docker 将获取所有内容并将其安全传递，以便从容器内访问。

Answer 13

使用 jq 将 env 转换为 JSON：

env_as_json=`jq -c -n env`
docker run -e HOST_ENV="$env_as_json" <image>

这需要 jq 版本 1.6 或更新版本

这将主机环境作为 json 推送，本质上就像在 Dockerfile 中一样：

ENV HOST_ENV  (all env from the host as json)

Answer 14

这是我解决它的方法

docker run --rm -ti -e AWS_ACCESS_KEY_ID -e AWS_SECRET_ACCESS_KEY -e AWS_SESSION_TOKEN -e AWS_SECURITY_TOKEN amazon/aws-cli s3 ls

再举一个例子：

export VAR1=value1
export VAR2=value2

$ docker run --env VAR1 --env VAR2 ubuntu env | grep VAR
VAR1=value1
VAR2=value2