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