jjaladi / terraform-google-cloud-storage

This module makes it easy to create one or more GCS buckets, and assign basic permissions on them to arbitrary users.

Terraform Google Cloud Storage Module

This module makes it easy to create one or more GCS buckets, and assign basic permissions on them to arbitrary users.

The resources/services/activations/deletions that this module will create/trigger are:

• One or more GCS buckets
• Zero or more IAM bindings for those buckets

If you only wish to create a single bucket, consider using the simple bucket submodule instead.

Compatibility

This module is meant for use with Terraform 0.12. If you haven't upgraded and need a Terraform 0.11.x-compatible version of this module, the last released version intended for Terraform 0.11.x is 0.1.0.

Usage

Basic usage of this module is as follows:

module "gcs_buckets" {
  source  = "terraform-google-modules/cloud-storage/google"
  version = "~> 1.7"
  project_id  = "<PROJECT ID>"
  names = ["first", "second"]
  prefix = "my-unique-prefix"
  set_admin_roles = true
  admins = ["group:[email protected]"]
  versioning = {
    first = true
  }
  bucket_admins = {
    second = "user:[email protected],[email protected]"
  }
}

Functional examples are included in the examples directory.

Inputs

Name	Description	Type	Default	Required
admins	IAM-style members who will be granted roles/storage.objectAdmin on all buckets.	list(string)	<list>	no
bucket_admins	Map of lowercase unprefixed name => comma-delimited IAM-style bucket admins.	map	<map>	no
bucket_creators	Map of lowercase unprefixed name => comma-delimited IAM-style bucket creators.	map	<map>	no
bucket_policy_only	Disable ad-hoc ACLs on specified buckets. Defaults to true. Map of lowercase unprefixed name => boolean	map	<map>	no
bucket_viewers	Map of lowercase unprefixed name => comma-delimited IAM-style bucket viewers.	map	<map>	no
cors	Map of maps of mixed type attributes for CORS values. See appropriate attribute types here: https://www.terraform.io/docs/providers/google/r/storage_bucket.html#cors	any	<map>	no
creators	IAM-style members who will be granted roles/storage.objectCreators on all buckets.	list(string)	<list>	no
encryption_key_names	Optional map of lowercase unprefixed name => string, empty strings are ignored.	map	<map>	no
folders	Map of lowercase unprefixed name => list of top level folder objects.	map	<map>	no
force_destroy	Optional map of lowercase unprefixed name => boolean, defaults to false.	map	<map>	no
labels	Labels to be attached to the buckets	map	<map>	no
lifecycle_rules	List of lifecycle rules to configure. Format is the same as described in provider documentation https://www.terraform.io/docs/providers/google/r/storage_bucket.html#lifecycle_rule except condition.matches_storage_class should be a comma delimited string.	object	<list>	no
location	Bucket location.	string	"EU"	no
names	Bucket name suffixes.	list(string)	n/a	yes
prefix	Prefix used to generate the bucket name.	string	n/a	yes
project_id	Bucket project id.	string	n/a	yes
set_admin_roles	Grant roles/storage.objectAdmin role to admins and bucket_admins.	bool	"false"	no
set_creator_roles	Grant roles/storage.objectCreator role to creators and bucket_creators.	bool	"false"	no
set_viewer_roles	Grant roles/storage.objectViewer role to viewers and bucket_viewers.	bool	"false"	no
storage_class	Bucket storage class.	string	"MULTI_REGIONAL"	no
versioning	Optional map of lowercase unprefixed name => boolean, defaults to false.	map	<map>	no
viewers	IAM-style members who will be granted roles/storage.objectViewer on all buckets.	list(string)	<list>	no
website	Map of website values. Supported attributes: main_page_suffix, not_found_page	any	<map>	no

Outputs

Name	Description
bucket	Bucket resource (for single use).
buckets	Bucket resources as list.
buckets_map	Bucket resources by name.
name	Bucket name (for single use).
names	Bucket names.
names_list	List of bucket names.
url	Bucket URL (for single use).
urls	Bucket URLs.
urls_list	List of bucket URLs.

Requirements

These sections describe requirements for using this module.

Software

The following dependencies must be available:

• Terraform v0.12
  • For Terraform v0.11 see the Compatibility section above
• Terraform Provider for GCP plugin v3.0

Service Account

User or service account credentials with the following roles must be used to provision the resources of this module:

• Storage Admin: roles/storage.admin

The Project Factory module and the IAM module may be used in combination to provision a service account with the necessary roles applied.

APIs

A project with the following APIs enabled must be used to host the resources of this module:

• Google Cloud Storage JSON API: storage-api.googleapis.com

The Project Factory module can be used to provision a project with the necessary APIs enabled.

Contributing

Refer to the contribution guidelines for information on contributing to this module.