github.com/ratanraj/packer@v1.3.2/website/source/docs/builders/file.html.md (about)

     1  ---
     2  description: |
     3      The file Packer builder is not really a builder, it just creates an artifact
     4      from a file. It can be used to debug post-processors without incurring high
     5      wait times. It does not run any provisioners.
     6  layout: docs
     7  page_title: 'File - Builders'
     8  sidebar_current: 'docs-builders-file'
     9  ---
    10  
    11  # File Builder
    12  
    13  Type: `file`
    14  
    15  The `file` Packer builder is not really a builder, it just creates an artifact
    16  from a file. It can be used to debug post-processors without incurring high
    17  wait times. It does not run any provisioners.
    18  
    19  ## Basic Example
    20  
    21  Below is a fully functioning example. It doesn't do anything useful, since no
    22  provisioners are defined, but it will connect to the specified host via ssh.
    23  
    24  ``` json
    25  {
    26    "type": "file",
    27    "content": "Lorem ipsum dolor sit amet",
    28    "target": "dummy_artifact"
    29  }
    30  ```
    31  
    32  ## Configuration Reference
    33  
    34  Configuration options are organized below into two categories: required and
    35  optional. Within each category, the available options are alphabetized and
    36  described.
    37  
    38  Any [communicator](/docs/templates/communicator.html) defined is ignored.
    39  
    40  ### Required:
    41  
    42  -   `target` (string) - The path for a file which will be copied as the
    43      artifact.
    44  
    45  ### Optional:
    46  
    47  You can only define one of `source` or `content`. If none of them is
    48  defined the artifact will be empty.
    49  
    50  -   `source` (string) - The path for a file which will be copied as the
    51      artifact.
    52  
    53  -   `content` (string) - The content that will be put into the artifact.