mirror of
https://github.com/opentofu/opentofu.git
synced 2025-02-15 01:53:51 -06:00
Added s3 and unarchiving docs (#9677)
The underlying [go-getter](https://github.com/hashicorp/go-getter) supports S3 Buckets and unarchiving. Adding mentions of this to the module sources documentation.
This commit is contained in:
parent
7940af2ff2
commit
3500630243
@ -23,6 +23,8 @@ Terraform supports the following sources:
|
|||||||
|
|
||||||
* HTTP URLs
|
* HTTP URLs
|
||||||
|
|
||||||
|
* S3 buckets
|
||||||
|
|
||||||
Each is documented further below.
|
Each is documented further below.
|
||||||
|
|
||||||
## Local File Paths
|
## Local File Paths
|
||||||
@ -165,3 +167,44 @@ Terraform then looks for the resulting module URL in the following order:
|
|||||||
```
|
```
|
||||||
<meta name=“terraform-get” content="github.com/hashicorp/example" />
|
<meta name=“terraform-get” content="github.com/hashicorp/example" />
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### S3 Bucket
|
||||||
|
|
||||||
|
Terraform can also store modules in an S3 bucket. To access the bucket
|
||||||
|
you must have appropriate AWS credentials in your configuration or
|
||||||
|
available via shared credentials or environment variables.
|
||||||
|
|
||||||
|
There are a variety of S3 bucket addressing schemes, most are
|
||||||
|
[documented in the S3
|
||||||
|
configuration](http://docs.aws.amazon.com/AmazonS3/latest/dev/UsingBucket.html#access-bucket-intro).
|
||||||
|
Here are a couple of examples.
|
||||||
|
|
||||||
|
Using the `s3` protocol.
|
||||||
|
|
||||||
|
```
|
||||||
|
module "consul" {
|
||||||
|
source = "s3::https://s3-eu-west-1.amazonaws.com/consulbucket/consul.zip"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
Or directly using the bucket's URL.
|
||||||
|
|
||||||
|
```
|
||||||
|
module "consul" {
|
||||||
|
source = "consulbucket.s3-eu-west-1.amazonaws.com/consul.zip"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
## Unarchiving
|
||||||
|
|
||||||
|
Terraform will automatically unarchive files based on the extension of
|
||||||
|
the file being requested (over any protocol). It supports the following
|
||||||
|
archive formats:
|
||||||
|
|
||||||
|
* tar.gz and tgz
|
||||||
|
* tar.bz2 and tbz2
|
||||||
|
* zip
|
||||||
|
* gz
|
||||||
|
* bz2
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user