jjzjj

Dockerfile命令详解之 ARG

清风怎不知意 2024-04-21 原文

        许多同学不知道Dockerfile应该如何写，不清楚Dockerfile中的指令分别有什么意义，能达到什么样的目的，接下来我将在容器化专栏中详细的为大家解释每一个指令的含义以及用法。
专栏订阅传送门https://blog.csdn.net/qq_38220908/category_11989778.html

        指令不区分大小写。但是，按照惯例，它们应该是大写的，以便更容易地将它们与参数区分开来。(引用至官方文档>>>) 

        

        【开发云】年年都是折扣价，不用四处薅羊毛

语法

ARG <name>[=<default value>]

        ARG指令用于定义一个变量，用户可以在构建Docker镜像的时候，使用 --build-arg 定义变量的值。比如：

        我们新建一个Dockerfile文件，使用ARG定义参数username，这里我们没有赋予默认值

FROM ubuntu
ARG username
RUN echo $username

        然后我们使用以下命令构建镜像，我们可以看到RUN echo $username被替换成了RUN echo 清风怎不知意

docker build --build-arg username=清风怎不知意 -t myapp:tag-v0.0.1 .

来自Docker官方的警告：

        不建议在构建时使用ARG传递密钥、用户凭证等信息，因为构建时的信息是任何用户都可以通过docker history看到的！！！！！！！！！

         我们也可以使用 ARG username=默认姓名 赋予变量默认值。

        我们还可以利用ARG指令，声明基础镜像的版本，使其在构建的时候可以通过--build-arg选项对镜像版本进行修改，比如：

        Dockerfile

ARG BASE_VERSION=latest
FROM openjdk:$BASE_VERSION
RUN echo $BASE_VERSION

         当我们运行命令 docker build . 的时候，没有使用--build-arg 定义BASE_VERSION的值，所以BASE_VERSION取默认值latest，实际拉取的基础镜像版本是 openjdk:latest

         当我们运行命令docker build --build-arg BASE_VERSION=11 . 的时候，BASE_VERSION的值为11，所以实际拉取的镜像版本是 openjdk:11

 注意：

        在FROM指令前使用ARG指令定义的变量，只能用于FROM指令。所以，Dockerfile第三行的 RUN echo $BASE_VERSION指令，并未取到值！！！

作用域

        上面的例子我们可以看到，ARG声明的变量是有作用域限制的。接下来我们说说ARG指令定义变量的作用域。

1、与常规变量的定义一样，变量的生效时间，都是在被定义之后。

比如：

Dockerfile

FROM ubuntu

# 定义环境变量
ENV MYENV=test
RUN echo $MYENV

# 覆盖定义的环境变量
ARG MYENV
RUN echo $MYENV

使用以下命令构建镜像文件

docker build --build-arg MYENV=pre -t myapp:tag-v0.0.2 .

运行的结果为：

         第一次RUN 指令 echo 的值是test，第二次RUN指令 echo 的值是pre，我们可以看到ARG指令只影响到了其后面的变量值。

        如果我们构建镜像的时候，不指定参数值，那么ARG指令声明的MYENV变量的值，会以上面EVN指令定义的值为默认值

docker build -t myapp:tag-v0.0.2 .

        可以看到，两次RUN指令echo的值都是与ENV指令定义的值一样的

 2、 ARG指令声明的变量在当前构建阶段完成后失效

        相当于在函数内声明的变量，只能在该函数内生效。所以在进行多阶段构建时，每个阶段都必须重新使用ARG指令声明变量。

  • 错误使用方式

        多阶段构建Dockerfile

FROM ubuntu
ARG SETTINGS=12
RUN echo $SETTINGS

FROM ubuntu
RUN echo $SETTINGS

        使用以下命令构建镜像

docker build  --no-cache .

        我们可以看到，我们在第一阶段声明的SETTINGS参数，在第二阶段构建的时候，SETTINGS未取值

  • 正确使用方式        

         当我们为第二阶段使用ARG声明参数后，再次构建，可以看到，此时变量SETTINGS的值变为了22

        多阶段构建Dockerfile

FROM ubuntu
ARG SETTINGS=12
RUN echo $SETTINGS

FROM ubuntu
ARG SETTINGS=22
RUN echo $SETTINGS

        我们可以使用ARG或者ENV指令指定RUN指令可用的变量，但是ENV指令定义的环境变量，会覆盖ARG定义的同名变量

预定义变量

        Docker提供以下预定义变量

  • HTTP_PROXY
  • http_proxy
  • HTTPS_PROXY
  • https_proxy
  • FTP_PROXY
  • ftp_proxy
  • NO_PROXY
  • no_proxy
  • ALL_PROXY
  • all_proxy

        针对以上预定义的变量，我们同样可以使用--build-arg给他们赋值，并且，这些预定义变量不会被docker history所记录，能够相对安全的保护这部分敏感信息。 

        如果我们需要改变预定义变量的行为，我们可以在Dockerfile中声明同名变量，比如我们在Dockerfile中使用指令 ARG HTTP_PROXY重新声明了预定义变量，这时候，我们在构建镜像的时候，docker history就会记录下它的值，失去对此信息的保护，并且，更改HTTP_PROXY的值会使构建的缓存失效。

[1]  感谢大佬 @kenllf 的斧正

详解Dockerfilexff0cxffxff0javadocker容器服务器运维

有关Dockerfile命令详解之 ARG的更多相关文章

  1. ruby - 在 Ruby 中编写命令行实用程序 - 2

    我想用ruby​​编写一个小的命令行实用程序并将其作为gem分发。我知道安装后，Guard、Sass和Thor等某些gem可以从命令行自行运行。为了让gem像二进制文件一样可用，我需要在我的gemspec中指定什么。 最佳答案 Gem::Specification.newdo|s|...s.executable='name_of_executable'...endhttp://docs.rubygems.org/read/chapter/20 关于ruby-在Ruby中编写命令行实用程序

  2. ruby-on-rails - rbenv:从 RVM 移动到 rbenv 后，在 Jenkins 执行 shell 中找不到命令 - 2

    我从Ubuntu服务器上的RVM转移到rbenv。当我使用RVM时，使用bundle没有问题。转移到rbenv后，我在Jenkins的执行shell中收到“找不到命令”错误。我内爆并删除了RVM，并从~/.bashrc'中删除了所有与RVM相关的行。使用后我仍然收到此错误:rvmimploderm~/.rvm-rfrm~/.rvmrcgeminstallbundlerecho'exportPATH="$HOME/.rbenv/bin:$PATH"'>>~/.bashrcecho'eval"$(rbenvinit-)"'>>~/.bashrc.~/.bashrcrbenvversions

  3. ruby - 从 Ruby : capturing the output while displaying the output? 运行 shell 命令 - 2

    我有一个问题。我想从另一个ruby​​脚本运行一个ruby​​脚本并捕获它的输出信息，同时让它也输出到屏幕。亚军#!/usr/bin/envrubyprint"Enteryourpassword:"password=gets.chompputs"Hereisyourpassword:#{password}"我运行的脚本文件:开始.rboutput=`runner`putsoutput.match(/Hereisyour(password:.*)/).captures[0].to_s正如您在此处看到的那样，存在问题。在start.rb的第一行，屏幕是空的。我在运行程序中看不到“输入您的密

  4. ruby - 是否有将图像文件转换为 ASCII 艺术的命令行程序或库？ - 2

    有这样的事吗？我想在Ruby程序中使用它。 最佳答案 试试这个http://csl.sublevel3.org/jp2a/此外，Imagemagick可能还有一些东西 关于ruby-是否有将图像文件转换为ASCII艺术的命令行程序或库？，我们在StackOverflow上找到一个类似的问题： https://stackoverflow.com/questions/6510445/

  5. ruby - 在 Ruby 的 if 语句中检查 bash 命令 - 2

    如何在Ruby的if语句中检查bash命令的返回值(true/false)。我想要这样的东西，if("/usr/bin/fswscell>/dev/null2>&1")has_afs="true"elsehas_afs="false"end它会提示以下错误含义，它总是返回true。(irb):5:warning:stringliteralincondition正确的语法是什么？更新:/usr/bin/fswscell寻找afs安装和运行状态。它会抛出这样的字符串，Thisworkstationbelongstocell如果afs没有运行，命令以状态1退出 最

  6. ruby - 可以正常中断的来自 Rake 的长时间运行的 shell 命令？ - 2

    在几个项目中，我希望有一个类似rakeserver的rake任务，它将通过任何需要的方式开始为该应用程序提供服务。这是一个示例:task:serverdo%x{bundleexecrackup-p1234}end这行得通，但是当我准备停止它时，按Ctrl+c并没有正常关闭；它中断了Rake任务本身，它说rakeaborted!并给出堆栈跟踪。在某些情况下，我必须执行Ctrl+c两次。我可能可以用Signal.trap写一些东西来更优雅地中断它。有没有更简单的方法？ 最佳答案 trap('SIGINT'){puts"Yourmessa

  7. ruby - Capistrano 中的执行、测试和捕获命令有什么区别？ - 2

    关于SSHkit-Github它说:Allbackendssupporttheexecute(*args),test(*args)&capture(*args)来自SSHkit-Rubydoc,我明白execute实际上是test的别名？test之间有什么区别？,execute,capture在Capistrano/SSHKit中我应该什么时候使用？ 最佳答案 执行只是执行命令。使用非0退出引发错误。测试方法的行为与execute完全相同，但是它返回bool值(true如果命令以0退出，而false否则)。它通常用于控制任务中的流程

  8. ruby - 如何在 Ruby 中执行 Windows CLI 命令？ - 2

    我在目录“C:\DocumentsandSettings\test.exe”中有一个文件，但是当我用单引号编写命令时`C:\DocumentsandSettings\test.exe(我无法在此框中显示)，用于在Ruby中执行命令，我无法这样做，我收到的错误是找不到文件或目录。我尝试用“//”和“\”替换“\”，但似乎没有任何效果。我也使用过系统、IO.popen和exec命令，但所有的努力都是徒劳的。exec命令还使程序退出，这是我不想发生的。提前致谢。 最佳答案 反引号环境就像双引号，所以反斜杠用于转义。此外，Ruby会将空格解

  9. ruby - 将命令行上的变量传递给 Cucumber 测试 - 2

    我正在尝试将cucumber项目的用户名和密码置于版本控制之外。有没有办法在命令行上手动将用户名和密码等变量传递给Cucumber脚本？我的备份计划是将它们放在一个YML文件中，然后将该文件添加到gitignore，这样它们就不会被置于版本控制中。 最佳答案 所以，我看到了您对铁皮人的评论，答案是肯定的。cucumberPASSWORD=my_passwordPASSWORD被设置为环境变量，您可以通过将其引用为ENV['PASSWORD']来使用它的值。例如，browser.text_field(:id=>'pwd').setEN

  10. ruby - 无法安装 gem - make 未被识别为内部或外部命令可运行程序或批处理文件 - 2

    我想在Windows7上安装带有ruby​​1.9.3的rspec-railsgem。我收到一些错误消息，提示无法安装某些json库。所以，我使用下面的说明来解决它。来源=The'json'nativegemrequiresinstalledbuildtools从[rubyinstaller.org][3]下载[Ruby1.9.3][2]从[rubyinstaller.org][3]下载DevKit文件对于Ruby1.9.3，使用[DevKit-tdm-32-4.5.2-20110712-1620-sfx.exe][4]将DevKit解压到路径C:\Ruby193\DevKit运行cd

随机推荐