Skip to content

Commit

Permalink
Add support for reading modules from GCS bucket
Browse files Browse the repository at this point in the history
  • Loading branch information
sl1pm4t authored and David Gillies committed May 21, 2019
1 parent 8b45443 commit af6083e
Showing 1 changed file with 26 additions and 0 deletions.
26 changes: 26 additions & 0 deletions website/docs/modules/sources.html.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,8 @@ types, as listed below.

* [S3 buckets](#s3-bucket)

* [GCS buckets](#gcs-bucket)

Each of these is described in the following sections. Module source addresses
use a _URL-like_ syntax, but with extensions to support unambiguous selection
of sources and additional features.
Expand Down Expand Up @@ -375,6 +377,30 @@ preferring those earlier in the list when multiple are available:
* If running on an EC2 instance, temporary credentials associated with the
instance's IAM Instance Profile.

## GCS Bucket

You can use archives stored in Google Cloud Storage as module sources using the special `gcs::`
prefix, followed by
[a GCS bucket object URL](https://cloud.google.com/storage/docs/request-endpoints#typical).

For example

* `gcs::https://www.googleapis.com/storage/v1/BUCKET_NAME/PATH_TO_MODULE`
* `gcs::https://www.googleapis.com/storage/v1/BUCKET_NAME/PATH/TO/module.zip`

```hcl
module "consul" {
source = "gcs::https://www.googleapis.com/storage/v1/modules/foomodule.zip"
}
```

The module installer uses Google Cloud SDK to authenticate with GCS. To set credentials you can:

* Enter the path of your service account key file in the GOOGLE_APPLICATION_CREDENTIALS environment variable, or;
* If you're running Terraform from a GCE instance, default credentials are automatically available. See [Creating and Enabling Service Accounts](https://cloud.google.com/compute/docs/authentication) for Instances for more details
* On your computer, you can make your Google identity available by running `gcloud auth application-default login`.


## Modules in Package Sub-directories

When the source of a module is a version control repository or archive file
Expand Down

0 comments on commit af6083e

Please sign in to comment.