ed091163be
This adds the new `required_plugins` block to be nested under the packer block.
Example:
```hcl
packer {
required_plugins {
aws = {
version = ">= 2.7.0"
source = "azr/aws"
}
azure = ">= 2.7.0"
}
}
```
For example on darwin_amd64 Packer will install those under :
* "${PACKER_HOME_DIR}/plugin/github.com/azr/amazon/packer-plugin-amazon_2.7.0_x5.0_darwin_amd64"
* "${PACKER_HOME_DIR}/plugin/github.com/hashicorp/azure/packer-plugin-azure_2.7.0_x5.0_darwin_amd64_x5"
+ docs
+ tests
39 lines
1.1 KiB
Plaintext
39 lines
1.1 KiB
Plaintext
---
|
|
page_title: file - Functions - Configuration Language
|
|
sidebar_title: file
|
|
description: |-
|
|
The file function reads the contents of the file at the given path and
|
|
returns them as a string.
|
|
---
|
|
|
|
# `file` Function
|
|
|
|
`file` reads the contents of a file at the given path and returns them as
|
|
a string.
|
|
|
|
```hcl
|
|
file(path)
|
|
```
|
|
|
|
Strings in the Packer language are sequences of Unicode characters, so
|
|
this function will interpret the file contents as UTF-8 encoded text and
|
|
return the resulting Unicode characters. If the file contains invalid UTF-8
|
|
sequences then this function will produce an error.
|
|
|
|
This function can be used only with files that already exist on disk
|
|
at the beginning of a Packer run. Functions do not participate in the
|
|
dependency graph, so this function cannot be used with files that are generated
|
|
dynamically during a Packer operation.
|
|
|
|
## Examples
|
|
|
|
```shell-session
|
|
> file("${path.folder}/hello.txt")
|
|
Hello World
|
|
```
|
|
|
|
## Related Functions
|
|
|
|
- [`fileexists`](/docs/templates/hcl_templates/functions/file/fileexists) determines whether a file exists
|
|
at a given path.
|