首页>编程相关>其他源码
下载

Terraform Google 云存储模块

该模块可以轻松创建一个或多个GCS存储桶，并将其基本权限分配给任意用户。

该模块将创建/触发的资源/服务/激活/删除是：

  • 一个或多个GCS桶
  • 这些存储桶的零个或多个 IAM 绑定

如果您只想创建单个存储桶，请考虑使用简单的存储桶子模块。

兼容性

该模块适用于 Terraform 0.13+ 并使用 Terraform 1.0+ 进行测试。如果您发现使用 Terraform >=0.13 不兼容，请提出问题。如果您尚未升级并且需要此模块的 Terraform 0.12.x 兼容版本，则适用于 Terraform 0.12.x 的最新发布版本是 v1.7.1。

用法

该模块的基本用法如下： 

 module "gcs_buckets" {
  source  = " terraform-google-modules/cloud-storage/google "
  version = " ~> 8.0 "
  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],user:[email protected] "
  }
}

功能示例包含在示例目录中。

输入

姓名描述类型默认必需的
管理员将被授予所有存储桶上的 Roles/storage.objectAdmin 的 IAM 类型成员。 list(string) []不
自动分类小写无前缀存储桶名称的可选映射 => 布尔值，默认为 false。 map(bool) {}不
存储桶管理员小写无前缀名称的映射 => 以逗号分隔的 IAM 风格的每个存储桶管理员。 map(string) {}不
存储桶创建者小写无前缀名称的映射 => 以逗号分隔的 IAM 风格的每个存储桶创建者。 map(string) {}不
Bucket_hmac_key_admins小写无前缀名称的映射 => 以逗号分隔的 IAM 样式每存储桶 HMAC 密钥管理员。 map(string) {}不
存储桶生命周期规则特定存储桶的附加生命周期规则。小写无前缀名称映射 => 要配置的生命周期规则列表。
地图（设置（对象（{
 # 带键的对象：
 # - type - 此生命周期规则的操作类型。支持的值：Delete 和 SetStorageClass。
 # - storage_class -（如果操作类型为 SetStorageClass，则为必需）受此生命周期规则影响的对象的目标存储类。
 动作=地图（字符串）

 # 带键的对象：
 # - 年龄 - （可选）满足此条件的对象的最小年龄（以天为单位）。
 # - created_before - （可选）RFC 3339 中对象的创建日期（例如 2017-06-13）以满足此条件。
 # - with_state - （可选）匹配活动和/或存档对象。支持的值包括：“LIVE”、“ARCHIVED”、“ANY”。
 # - matches_storage_class - （可选）满足此条件的对象存储类的逗号分隔字符串。支持的值包括：MULTI_REGIONAL、REGIONAL、NEARLINE、COLDLINE、STANDARD、DURABLE_REDUCED_AVAILABILITY。
 # - num_newer_versions - （可选）仅与版本化对象相关。满足此条件的对象的较新版本的数量。
 # - custom_time_before - （可选）RFC 3339 格式 YYYY-MM-DD 中的日期。当对象的 customTime 元数据设置为早于此生命周期条件中使用的日期时，就满足此条件。
 # - days_since_custom_time - （可选）自自定义时间元数据属性起经过多少天后此条件变为真。
 # - days_since_noncurrent_time - （可选）仅与版本化对象相关。自对象的非当前时间戳以来经过的天数。
 # - noncurrent_time_before - （可选）仅与版本化对象相关。 RFC 3339 中对象变为非并发的日期（例如 2017-06-13）。
 条件=地图（字符串）
 }）））
 {}不
仅存储桶策略禁用指定存储桶上的临时 ACL。默认为 true。小写无前缀名称映射 => 布尔值map(bool) {}不
存储桶管理员小写无前缀名称的映射 => 以逗号分隔的 IAM 风格的每存储桶存储管理员。 map(string) {}不
存储桶查看者小写无前缀名称的映射 => 以逗号分隔的 IAM 样式每存储桶查看器。 map(string) {}不
科尔斯CORS 值的混合类型属性的映射集。请在此处查看适当的属性类型：https://www.terraform.io/docs/providers/google/r/storage_bucket.html#cors set(any) []不
创造者将被授予所有存储桶上的 Roles/storage.objectCreators 的 IAM 风格成员。 list(string) []不
自定义放置配置小写无前缀名称的映射 => 自定义放置配置对象。格式与提供商文档中描述的相同 https://www.terraform.io/docs/providers/google/r/storage_bucket#custom_placement_config any {}不
基于默认事件的保留对添加到特定存储桶的新对象启用基于事件的保留。默认为 false。小写无前缀名称映射 => 布尔值map(bool) {}不
加密密钥名称小写无前缀名称 => 字符串的可选映射，空字符串将被忽略。 map(string) {}不
文件夹小写无前缀名称映射 => 顶级文件夹对象列表。 map(list(string)) {}不
强制销毁小写无前缀名称的可选映射 => 布尔值，默认为 false。 map(bool) {}不
hmac_key_admins将被授予所有存储桶上的 Roles/storage.hmacKeyAdmin 的 IAM 类型成员。 list(string) []不
hmac_service_accounts用于授予 GCS 访问权限的 HMAC 服务帐户列表。 map(string) {}不
标签贴在桶上的标签map(string) {}不
生命周期规则要配置的生命周期规则列表。格式与提供程序文档 https://www.terraform.io/docs/providers/google/r/storage_bucket.html#lifecycle_rule 中描述的相同，但 condition.matches_storage_class 应该是逗号分隔的字符串。
设置（对象（{
 # 带键的对象：
 # - type - 此生命周期规则的操作类型。支持的值：Delete 和 SetStorageClass。
 # - storage_class -（如果操作类型为 SetStorageClass，则为必需）受此生命周期规则影响的对象的目标存储类。
 动作=地图（字符串）

 # 带键的对象：
 # - 年龄 - （可选）满足此条件的对象的最小年龄（以天为单位）。
 # - created_before - （可选）RFC 3339 中对象的创建日期（例如 2017-06-13）以满足此条件。
 # - with_state - （可选）匹配活动和/或存档对象。支持的值包括：“LIVE”、“ARCHIVED”、“ANY”。
 # - matches_storage_class - （可选）满足此条件的对象存储类的逗号分隔字符串。支持的值包括：MULTI_REGIONAL、REGIONAL、NEARLINE、COLDLINE、STANDARD、DURABLE_REDUCED_AVAILABILITY。
 # - matches_prefix - （可选）满足此条件的一个或多个匹配名称前缀。
 # - matches_suffix - （可选）满足这一条件的一个或多个匹配名称后缀。
 # - num_newer_versions - （可选）仅与版本化对象相关。满足此条件的对象的较新版本的数量。
 # - custom_time_before - （可选）RFC 3339 格式 YYYY-MM-DD 中的日期。当对象的 customTime 元数据设置为早于此生命周期条件中使用的日期时，就满足此条件。
 # - days_since_custom_time - （可选）自自定义时间元数据属性起经过多少天后此条件变为真。
 # - days_since_noncurrent_time - （可选）仅与版本化对象相关。自对象的非当前时间戳以来经过的天数。
 # - noncurrent_time_before - （可选）仅与版本化对象相关。 RFC 3339 中对象变为非并发的日期（例如 2017-06-13）。
 条件=地图（字符串）
 }））
 []不
地点铲斗位置。 string "EU"不
记录小写无前缀名称的映射 => 存储桶日志记录配置对象。格式与提供商文档中描述的相同 https://www.terraform.io/docs/providers/google/r/storage_bucket.html#logging any {}不
名字存储桶名称后缀。 list(string)不适用是的
前缀用于生成存储桶名称的前缀。 string ""不
项目ID存储桶项目 ID。 string不适用是的
公共访问预防阻止公众访问存储桶。可接受的值是继承或强制执行的。如果继承，则仅当存储桶受公共访问阻止组织策略约束时，该存储桶才会使用公共访问阻止。 string "inherited"不
随机后缀向所有存储桶名称添加相同但随机的 4 字符后缀bool false不
保留政策保留策略值映射。格式与提供商文档中描述的相同 https://www.terraform.io/docs/providers/google/r/storage_bucket#retention_policy any {}不
设置管理员角色将 Roles/storage.objectAdmin 角色授予 admins 和 bucket_admins。 bool false不
设置创建者角色向创建者和bucket_creators授予roles/storage.objectCreator角色。 bool false不
set_hmac_access设置对 GCS 的 S3 兼容访问。 bool false不
set_hmac_key_admin_roles将roles/storage.hmacKeyAdmin 角色授予hmac_key_admins 和bucket_hmac_key_admins。 bool false不
设置存储管理员角色将roles/storage.admin 角色授予storage_admins 和bucket_storage_admins。 bool false不
设置查看者角色向查看者和bucket_viewers授予roles/storage.objectViewer角色。 bool false不
软删除策略要应用的软删除策略。小写无前缀名称映射 => 软删除策略。格式与提供商文档中描述的相同 https://www.terraform.io/docs/providers/google/r/storage_bucket.html#nested_soft_delete_policy map(any) {}不
存储管理员将被授予所有存储桶上的 Roles/storage.admin 的 IAM 类型成员。 list(string) []不
存储类桶存储类。 string "STANDARD"不
版本控制小写无前缀名称的可选映射 => 布尔值，默认为 false。 map(bool) {}不
观众将被授予所有存储桶上的 Roles/storage.objectViewer 的 IAM 风格成员。 list(string) []不
网站网站价值地图。支持的属性：main_page_suffix、not_found_page map(any) {}不

输出

姓名描述
apphub_service_uri Apphub 使用的 CAIS 样式的 URI。
桶桶资源（一次性使用）。
水桶将资源存储为列表。
桶映射按名称存储资源。
hmac_keys HMAC 密钥列表。
姓名存储桶名称（一次性使用）。
名字存储桶名称。
名称列表存储桶名称列表。
网址存储桶 URL（一次性使用）。
网址存储桶 URL。
网址列表存储桶 URL 列表。

要求

这些部分描述了使用此模块的要求。

软件

以下依赖项必须可用：

  • 地形 >= 0.13.0
    • 对于 Terraform v0.11，请参阅上面的兼容性部分
  • 适用于 GCP 插件的 Terraform Provider >= v4.42

服务帐号

必须使用具有以下角色的用户或服务帐户凭据来配置此模块的资源：

  • 存储管理员： roles/storage.admin

项目工厂模块和 IAM 模块可以组合使用，以提供应用了必要角色的服务帐户。

蜜蜂

必须使用启用了以下 API 的项目来托管该模块的资源：

  • Google 云存储 JSON API： storage-api.googleapis.com

项目工厂模块可用于配置启用必要 API 的项目。

贡献

有关为本模块做出贡献的信息，请参阅贡献指南。

展开
附加信息
相关应用
为您推荐
相关资讯 全部