cloud-foundation-fabric/modules
Julio Castillo 826ff14ef9 Sort variables and outputs 2022-11-21 13:17:55 +01:00
..
__experimental Fix variable/output sort check 2022-11-21 13:17:55 +01:00
api-gateway Update provider version (needed for dns logging support). 2022-10-25 12:15:02 +02:00
apigee Fix variable/output sort check 2022-11-21 13:17:55 +01:00
artifact-registry Update provider version (needed for dns logging support). 2022-10-25 12:15:02 +02:00
bigquery-dataset Update readme 2022-11-12 19:25:41 +01:00
bigtable-instance Update provider version (needed for dns logging support). 2022-10-25 12:15:02 +02:00
billing-budget Update provider version (needed for dns logging support). 2022-10-25 12:15:02 +02:00
binauthz Fix variable/output sort check 2022-11-21 13:17:55 +01:00
cloud-config-container Sort variables and outputs 2022-11-21 13:17:55 +01:00
cloud-function Fix variable/output sort check 2022-11-21 13:17:55 +01:00
cloud-identity-group Update provider version (needed for dns logging support). 2022-10-25 12:15:02 +02:00
cloud-run cannot instead of can not 2022-11-11 11:56:47 +00:00
cloudsql-instance Fix variable/output sort check 2022-11-21 13:17:55 +01:00
compute-mig Fix variable/output sort check 2022-11-21 13:17:55 +01:00
compute-vm Replace Docker's `gcplogs` driver with the GCP COS logging agent (#977) 2022-11-15 13:19:52 +01:00
container-registry Update provider version (needed for dns logging support). 2022-10-25 12:15:02 +02:00
data-catalog-policy-tag cannot instead of can not 2022-11-11 11:56:47 +00:00
datafusion Update provider version (needed for dns logging support). 2022-10-25 12:15:02 +02:00
dns Fix variable/output sort check 2022-11-21 13:17:55 +01:00
endpoints Generate files based on readme contents 2022-11-18 17:48:52 +01:00
folder Generate files based on readme contents 2022-11-18 17:48:52 +01:00
gcs Update readme 2022-11-12 19:25:41 +01:00
gke-cluster Merge branch 'master' into ludo/gke-autopilot-datapath 2022-10-25 23:24:20 +02:00
gke-hub Refactor VPC firewall module for Terraform 1.3 (#949) 2022-11-04 13:56:07 +01:00
gke-nodepool fix service account create (#923) 2022-10-27 15:12:04 +00:00
iam-service-account cannot instead of can not 2022-11-11 11:56:47 +00:00
kms Add tests for factory examples 2022-11-18 17:48:52 +01:00
logging-bucket Update readme 2022-11-12 19:25:41 +01:00
net-address Update provider version (needed for dns logging support). 2022-10-25 12:15:02 +02:00
net-cloudnat Update provider version (needed for dns logging support). 2022-10-25 12:15:02 +02:00
net-glb Fix variable/output sort check 2022-11-21 13:17:55 +01:00
net-ilb Fix variable/output sort check 2022-11-21 13:17:55 +01:00
net-ilb-l7 Sort variables and outputs 2022-11-21 13:17:55 +01:00
net-interconnect-attachment-direct Update provider version (needed for dns logging support). 2022-10-25 12:15:02 +02:00
net-vpc Generate files based on readme contents 2022-11-18 17:48:52 +01:00
net-vpc-firewall Fix variable/output sort check 2022-11-21 13:17:55 +01:00
net-vpc-peering cannot instead of can not 2022-11-11 11:56:47 +00:00
net-vpn-dynamic Update provider version (needed for dns logging support). 2022-10-25 12:15:02 +02:00
net-vpn-ha Update provider version (needed for dns logging support). 2022-10-25 12:15:02 +02:00
net-vpn-static Update provider version (needed for dns logging support). 2022-10-25 12:15:02 +02:00
organization Generate files based on readme contents 2022-11-18 17:48:52 +01:00
project Generate files based on readme contents 2022-11-18 17:48:52 +01:00
projects-data-source Fix variable/output sort check 2022-11-21 13:17:55 +01:00
pubsub 1 + 1 = 2 2022-11-20 16:56:23 +01:00
secret-manager Update provider version (needed for dns logging support). 2022-10-25 12:15:02 +02:00
service-directory Update provider version (needed for dns logging support). 2022-10-25 12:15:02 +02:00
source-repository Update provider version (needed for dns logging support). 2022-10-25 12:15:02 +02:00
vpc-sc Refactor vps-sc module for Terraform 1.3 (#963) 2022-11-10 19:34:45 +01:00
README.md Apigee module and blueprint 2022-11-16 19:49:26 +01:00

README.md

Terraform modules suite for Google Cloud

The modules collected in this folder are designed as a suite: they are meant to be composed together, and are designed to be forked and modified where use of third party code and sources is not allowed.

Modules try to stay close to the low level provider resources they encapsulate, and they all share a similar interface that combines management of one resource or set or resources, and the corresponding IAM bindings.

Authoritative IAM bindings are primarily used (e.g. google_storage_bucket_iam_binding for GCS buckets) so that each module is authoritative for specific roles on the resources it manages, and can neutralize or reconcile IAM changes made elsewhere.

Specific modules also offer support for non-authoritative bindings (e.g. google_storage_bucket_iam_member for service accounts), to allow granular permission management on resources that they don't manage directly.

These modules are not necessarily backward compatible. Changes breaking compatibility in modules are marked by major releases (but not all major releases contain breaking changes). Please be mindful when upgrading Fabric modules in existing Terraform setups, and always try to use versioned references in module sources so you can easily revert back to a previous version. Since the introduction of the moved block in Terraform we try to use it whenever possible to make updates non-breaking, but that does not cover all changes we might need to make.

These modules are used in the examples included in this repository. If you are using any of those examples in your own Terraform configuration, make sure that you are using the same version for all the modules, and switch module sources to GitHub format using references. The recommended approach to working with Fabric modules is the following:

  • Fork the repository and own the fork. This will allow you to:

    • Evolve the existing modules.
    • Create your own modules.
    • Sync from the upstream repository to get all the updates.
  • Use GitHub sources with refs to reference the modules. See an example below:

    module "project" {
        source              = "github.com/GoogleCloudPlatform/cloud-foundation-fabric//modules/project?ref=v13.0.0"
        name                = "my-project"
        billing_account     = "123456-123456-123456"
        parent              = "organizations/123456"
    }
    

Foundational modules

Networking modules

Compute/Container

Data

Development

Security

Serverless