cloud-foundation-fabric/modules
Wiktor Niesiobędzki fab2ad08b9 Fixes for service-mesh example in gke-hub 2023-02-09 17:56:55 +01:00
..
__experimental Bump provider version 2023-02-07 15:59:29 +01:00
api-gateway Bump provider version 2023-02-07 15:59:29 +01:00
apigee Bump provider version 2023-02-07 15:59:29 +01:00
artifact-registry Bump provider version 2023-02-07 15:59:29 +01:00
bigquery-dataset Bump provider version 2023-02-07 15:59:29 +01:00
bigtable-instance Bump provider version 2023-02-07 15:59:29 +01:00
billing-budget Bump provider version 2023-02-07 15:59:29 +01:00
binauthz Bump provider version 2023-02-07 15:59:29 +01:00
cloud-config-container Bump provider version 2023-02-07 15:59:29 +01:00
cloud-function Bump provider version 2023-02-07 15:59:29 +01:00
cloud-identity-group Bump provider version 2023-02-07 15:59:29 +01:00
cloud-run Bump provider version 2023-02-07 15:59:29 +01:00
cloudsql-instance Bump provider version 2023-02-07 15:59:29 +01:00
compute-mig Bump provider version 2023-02-07 15:59:29 +01:00
compute-vm Update TOC 2023-02-07 16:17:16 +01:00
container-registry Bump provider version 2023-02-07 15:59:29 +01:00
data-catalog-policy-tag Bump provider version 2023-02-07 15:59:29 +01:00
datafusion Bump provider version 2023-02-07 15:59:29 +01:00
dns Bump provider version 2023-02-07 15:59:29 +01:00
endpoints Bump provider version 2023-02-07 15:59:29 +01:00
folder Bump provider version 2023-02-07 15:59:29 +01:00
gcs Bump provider version 2023-02-07 15:59:29 +01:00
gke-cluster Bump provider version 2023-02-07 15:59:29 +01:00
gke-hub Fixes for service-mesh example in gke-hub 2023-02-09 17:56:55 +01:00
gke-nodepool Bump provider version 2023-02-07 15:59:29 +01:00
iam-service-account Bump provider version 2023-02-07 15:59:29 +01:00
kms Bump provider version 2023-02-07 15:59:29 +01:00
logging-bucket Bump provider version 2023-02-07 15:59:29 +01:00
net-address Bump provider version 2023-02-07 15:59:29 +01:00
net-cloudnat Bump provider version 2023-02-07 15:59:29 +01:00
net-glb Bump provider version 2023-02-07 15:59:29 +01:00
net-ilb Bump provider version 2023-02-07 15:59:29 +01:00
net-ilb-l7 Bump provider version 2023-02-07 15:59:29 +01:00
net-interconnect-attachment-direct Bump provider version 2023-02-07 15:59:29 +01:00
net-vpc Bump provider version 2023-02-07 15:59:29 +01:00
net-vpc-firewall Bump provider version 2023-02-07 15:59:29 +01:00
net-vpc-peering Bump provider version 2023-02-07 15:59:29 +01:00
net-vpn-dynamic Bump provider version 2023-02-07 15:59:29 +01:00
net-vpn-ha Bump provider version 2023-02-07 15:59:29 +01:00
net-vpn-static Bump provider version 2023-02-07 15:59:29 +01:00
organization Bump provider version 2023-02-07 15:59:29 +01:00
project Bump provider version 2023-02-07 15:59:29 +01:00
projects-data-source Bump provider version 2023-02-07 15:59:29 +01:00
pubsub Bump provider version 2023-02-07 15:59:29 +01:00
secret-manager Bump provider version 2023-02-07 15:59:29 +01:00
service-directory Bump provider version 2023-02-07 15:59:29 +01:00
source-repository Bump provider version 2023-02-07 15:59:29 +01:00
vpc-sc Bump provider version 2023-02-07 15:59:29 +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