🎨
Docker
  • Docker入门
  • Docker overview
    • 隔离与限制
    • copy-on-write(CoW: 写时复制)
    • docker中的联合文件系统
    • Docker存储
      • tmpfs mounts
      • volume
      • bind mounts
    • Docker网络
      • host模式
      • bridge模式
        • default bridge模式
        • User-defined bridge模式
      • none模式
      • container模式
  • 容器监控方式
    • prometheus + grafana+cAdvisor监控容器
  • Dockerfile指令
    • Usage
    • BuildKit
    • Format
    • Parser directives
      • syntax
      • escape
    • Environment replacement
    • FROM
      • 了解ARG和FROM之间的交互方式
    • .dockerignore file
    • RUN
    • CMD
    • COPY
    • ADD
    • ENV
    • WORKDIR
    • ARG
      • Impact on build caching(对构建缓存的影响)
      • Default(默认值)
      • Scope(作用域)
      • Using ARG Variables(使用ARG变量)
      • Predefined ARGS(预先定义好的ARG变量)
      • Automatic platform ARGs in the global scope(全局作用域中自动化平台的ARGS)
    • STOPSIGNAL
    • HEALTHCHECK
    • SHELL
    • ONBUILD
    • Dockerfile示例
    • LABEL
    • MAINTAINER (deprecated)
    • EXPOSE
    • ENTRYPOINT
      • Shell形式的ENTRYPOINT示例
      • 理解CMD和ENTRYPOINT是如何交互的
    • VOLUME
    • USER
  • docker-compose.yaml文件中常用指令
    • compose文件结构和示例
    • 服务配置参考
      • build
        • dockerfile
        • context
        • shm_size
        • network
        • labels
        • cache_from
        • args
        • target
      • cap_add, cap_drop
      • cgroup_parent
      • command
      • configs
        • 短语法形式
        • 长语法形式
      • container_name
      • credential_spec
        • EXAMPLE GMSA CONFIGURATION
      • depends_on
      • deploy
        • endpoint_mode
        • labels
        • mode
        • placement
        • max_replicas_per_node
        • replicas
        • resource
        • restart_policy
        • rollback_config
        • Update_config
        • Not supported for docker stack deploy
      • devices
      • dns
      • dns_search
      • entrypoint
      • env_file
      • environment
      • expose
      • external_links
      • extra_hosts
      • healthcheck
      • image
      • init
      • isolation
      • labels
      • links
      • logging
      • network_mode
      • networks
        • alias
        • IPV4_ADDRESS, IPV6_ADDRESS
      • pid
      • ports
        • 长语法
        • 短语法
      • profiles
      • restart
      • secrets
        • 长语法
        • 短语法
      • security_opt
      • stop_grace_period
      • stop_signal
      • sysctls
      • tmpfs
      • ulimits
      • userns_mode
      • volumes
        • 长语法
        • 短语法
        • VOLUMES FOR SERVICES, SWARMS, AND STACK FILES
      • domainname, hostname, ipc, mac_address, privileged, read_only, shm_size, stdin_open, tty, user, work
      • Specifying durations
      • Specifying byte values
      • Volume configuration reference
        • driver
        • driver_opts
        • external
        • labels
        • name
      • Network configuration reference
        • name
        • external
        • labels
        • internal
        • ipam
        • enable_ipv6
        • driver
          • overlay
          • bridge
          • host或者none
        • driver_opts
        • attachable
      • configs configuration reference
      • secrets configuration reference
      • Variable substitution
      • Extension fields
  • docker-compose示例
    • WordPress
    • PostgreSQL
    • Django和PostgreSQL
    • Rails和PostgreSQL
  • Dockerfile最佳实践
Powered by GitBook
On this page

Was this helpful?

  1. Dockerfile指令

ENV

PreviousADDNextWORKDIR

Last updated 4 years ago

Was this helpful?

ENV <key>=<value> ...

ENV指令将环境变量设置为值。此值可以用于构建阶段中所有后续指令之中,并且在许多情况下也可以。该值将被解释为其他环境变量,因此如果不对引号字符进行转义,则将其删除。像命令行解析一样,引号和反斜杠可用于在值中包含空格。

示例:

ENV MY_NAME="John Doe"
ENV MY_DOG=Rex\ The\ Dog
ENV MY_CAT=fluffy

ENV指令允许一次设置多个变量,下面的示例将在最终镜像中产生相同的结果:

ENV MY_NAME="John Doe" MY_DOG=Rex\ The\ Dog \
    MY_CAT=fluffy

从结果镜像运行容器时,使用ENV设置的环境变量将保留。我们可以使用docker inspect查看值,并使用docker run --env <key>=<value>更改它们。

#dockerfile

ARG VERSION=7
FROM centos:$VERSION
ENV NAME=TonyYang AGE=31 \
    ADDRESS=CHINA \
    SEX=MALE
CMD ["/bin/echo", "testing finished!"]

运行上面Dockerfile构建的镜像时的输出结果:

liuyang@liuyangdeiMac docker % docker run -it camelgem/test:v4 bash
[root@7887a9d16075 /]# env
ADDRESS=CHINA
HOSTNAME=7887a9d16075
TERM=xterm
NAME=TonyYang

可以看到上面的输出结果中包含了咱们之前在Dockerfile中定义的环境变量。

环境变量的持久性可能导致意外的副作用。例如,设置ENV DEBIAN_FRONTEND=noninteractive会更改apt-get的行为,并可能使镜像用户感到困惑。

如果仅在构建过程中需要环境变量,而在最终的镜像中不需要,请考虑为单个命令设置一个值:

RUN DEBIAN_FRONTEND=noninteractive apt-get update && apt-get install -y ...

或使用ARG,因为在最终生成的镜像中不会保留ARG设置的变量:

ARG DEBIAN_FRONTEND=noninteractive
RUN apt-get update && apt-get install -y ...

可选语法

ENV指令还允许使用另一种语法ENV ,省略了=。例如:

ENV MY_VAR my-value

此语法不允许在单个ENV指令中设置多个环境变量,并且可能会造成混淆。例如,以下代码将单个环境变量ONE设置为TWO= THREE=world:

ENV ONE TWO= THREE=world

支持使用备用语法是为了实现向后兼容,但出于上述原因,不建议使用该语法,并且在将来的发行版中可能会删除该语法。

内联替换