<div id="readability-page-1" class="page"><div id="main" role="main">
  
  



  <article class="page" itemscope="" itemtype="https://schema.org/CreativeWork">
    <meta itemprop="headline" content="[Dockerfile] Parser directive">
    <meta itemprop="description" content="  Dockerfile 내 구문들이 처리되는 방법을 지시하는 구문을 의미한다.  # directive = value 형식의 특수한 주석 형태로 기재한다.  Build 단계로 표시되지 않고, build에 layer를 추가하지도 않는다.  Parser directive가 한번 처리되고 나면 docker는 추가적인 parser directive를 찾지 않는다. Parser directive 이 후 주석, 빈 줄, builder 명령이 처리되고 나면 Parser directive가 나타나더라도 단순한 주석으로 처리된다. 따라서 Parser directive는 Dockerfile 맨 위에 위치해야 한다.  Case-insensitive 성질을 갖지만 convention은 소문자 기재이다.  Parser directive 위에 빈 줄을 포함하는 것 또한 Convention이다. 따라서 line continuation character는 지원되지 않는다.  현재 지원되는 Parser directive는 2 가지이다.          syntax      escape      ">
    <meta itemprop="datePublished" content="2021-05-02T00:00:00+09:00">
    

    <div>
      
        <header>
          
          

  <p>
    
      
      <span>
        
        <time datetime="2021-05-02T00:00:00+09:00">May 2, 2021</time>
      </span>
    

    <span></span>

    
      
      

      <span>
        
        
          1 minute read
        
      </span>
    
  </p>


        </header>
      

      <section itemprop="text">
        
        <ul>
  <li>Dockerfile 내 구문들이 처리되는 방법을 지시하는 구문을 의미한다.</li>
  <li><code># directive = value</code> 형식의 특수한 주석 형태로 기재한다.</li>
  <li>Build 단계로 표시되지 않고, build에 layer를 추가하지도 않는다.</li>
  <li>Parser directive가 한번 처리되고 나면 docker는 추가적인 parser directive를 찾지 않는다. Parser directive 이 후 주석, 빈 줄, builder 명령이 처리되고 나면 Parser directive가 나타나더라도 단순한 주석으로 처리된다. 따라서 Parser directive는 Dockerfile 맨 위에 위치해야 한다.</li>
  <li>Case-insensitive 성질을 갖지만 convention은 소문자 기재이다.</li>
  <li>Parser directive 위에 빈 줄을 포함하는 것 또한 Convention이다. 따라서 line continuation character는 지원되지 않는다.</li>
  <li>현재 지원되는 Parser directive는 2 가지이다.
    <ol>
      <li><code>syntax</code></li>
      <li><code>escape</code></li>
    </ol>
  </li>
</ul>

<h2 id="syntax">Syntax</h2>

<div><pre><code># syntax=[remote image reference]
</code></pre></div>

<p>사용 예:</p>
<div><pre><code># syntax=docker/dockerfile:1
# syntax=docker.io/docker/dockerfile:1
# syntax=example.com/user/repo:tag@sha256:abcdef...
</code></pre></div>

<p>Syntax directive는 <a href="https://github.com/moby/buildkit">BuildKit</a> 이라는 builder backend를 사용하는 경우에만 쓸 수 있고 Dockerfile을 build하는데 사용되는 Dockerfile syntax의 위치를 정의한다.</p>

<p>Docker에서 Dockerfile을 build하는 default syntax말고 custom dockerfile implementations로 build하기 위해서 사용한다.</p>

<h2 id="escape">Escape</h2>


<p>or</p>


<p>Escape directive는 Dockerfile 내에서 사용되는 escape 문자를 지정할 때 사용한다. escape directive가 없는 경우 default value는 <code>\</code> (backslash)이다. 해당 기능은 주로 Windows OS에서 build하는 경우 사용하게 된다. Unix-based OS (MacOS, Linux 등)에서는 escape 문자로 <code>\</code> (backslash)를 사용하고 directory path separator로 <code>/</code> (slash)를 사용하지만, Windows OS는 escape 문자로 <code>`</code>(backtick)을 사용하고 directory path separator로 <code>\</code> (backslash)를 사용한다.</p>

<p>Dockerfile에서 default escape character는 <code>\</code> (backslash)이므로 Windows의 directory path separator를 표기하기 위해서는 Windows PowerShell처럼 <code>\\</code>을 사용해야 한다. 이는 사용에 불편함을 주고 예기치 않는 build 실패를 유발할 수 있다. 따라서 Escape directive로 escape 문자를 <code>`</code> (backtick)으로 지정해버리면 문제를 간단하게 해결할 수 있다.</p>

        
      </section>

      

      


      
  

    </div>

    
  </article>

  
  
    
  
  
</div></div>

맹군’s 블로그

MyungHoon, Song

Dockerfile 내 구문들이 처리되는 방법을 지시하는 구문을 의미한다.
# directive = value 형식의 특수한 주석 형태로 기재한다.
Build 단계로 표시되지 않고, build에 layer를 추가하지도 않는다.
Parser directive가 한번 처리되고 나면 docker는 추가적인 parser directive를 찾지 않는다. Parser directive 이 후 주석, 빈 줄, builder 명령이 처리되고 나면 Parser directive가 나타나더라도 단순한 주석으로 처리된다. 따라서 Parser directive는 Dockerfile 맨 위에 위치해야 한다.
Case-insensitive 성질을 갖지만 convention은 소문자 기재이다.
Parser directive 위에 빈 줄을 포함하는 것 또한 Convention이다. 따라서 line continuation character는 지원되지 않는다.
현재 지원되는 Parser directive는 2 가지이다.
    
syntax
escape
Syntax
# syntax=[remote image reference]
사용 예:
# syntax=docker/dockerfile:1
# syntax=docker.io/docker/dockerfile:1
# syntax=example.com/user/repo:tag@sha256:abcdef...
Syntax directive는 BuildKit 이라는 builder backend를 사용하는 경우에만 쓸 수 있고 Dockerfile을 build하는데 사용되는 Dockerfile syntax의 위치를 정의한다.
Docker에서 Dockerfile을 build하는 default syntax말고 custom dockerfile implementations로 build하기 위해서 사용한다.
Escape
# escape=\ (backslash)
or
# escape=` (backtick)
Escape directive는 Dockerfile 내에서 사용되는 escape 문자를 지정할 때 사용한다. escape directive가 없는 경우 default value는 \ (backslash)이다. 해당 기능은 주로 Windows OS에서 build하는 경우 사용하게 된다. Unix-based OS (MacOS, Linux 등)에서는 escape 문자로 \ (backslash)를 사용하고 directory path separator로 / (slash)를 사용하지만, Windows OS는 escape 문자로 `(backtick)을 사용하고 directory path separator로 \ (backslash)를 사용한다.
Dockerfile에서 default escape character는 \ (backslash)이므로 Windows의 directory path separator를 표기하기 위해서는 Windows PowerShell처럼 \\을 사용해야 한다. 이는 사용에 불편함을 주고 예기치 않는 build 실패를 유발할 수 있다. 따라서 Escape directive로 escape 문자를 ` (backtick)으로 지정해버리면 문제를 간단하게 해결할 수 있다.

[Dockerfile] Parser directive

댓글