Minimal rewording of top-level README, initial infrastructure README (#15)

* minimal rewording of top-level README, initial infrastructure README

* update shared vpc input/output table in README
This commit is contained in:
Ludovico Magnocavallo
2019-10-21 20:35:34 +02:00
committed by GitHub
parent ddb8c70f79
commit c24cb2eafa
3 changed files with 21 additions and 10 deletions

View File

@@ -1,8 +1,17 @@
# Cloud Foundation Toolkit - Fabric
The Cloud Foundation Fabric provides end-to-end Terraform code examples for prototyping on GCP.
Code from this repository can be used as the basis for rapid prototyping of networking and organizational design,
and to lay the automated foundations for adopting additional CFT modules.
Cloud Foundation Fabric provides end-to-end Terraform code examples on GCP, which are meant for prototyping and as minimal samples to aid in designing real-world infrastructures. As such, these samples are meant to be adapted and updated for your different use cases, and often do not implement GCP security best practices for production use.
The Fabric repository is designed to be adapted and updated for your use cases.
For full-featured support out of the box, alternative Cloud Foundation Toolkit modules should be considered or integrated.
All the examples leverage composition, combining different Cloud Foundation Toolkit modules to realize an integrated design. Additional modules can be combined in to tailor the examples to specific needs, and to implement additional best practices. You can check the [full list of Cloud Foundation Toolkit modules here](https://github.com/terraform-google-modules).
The examples are organized into two main sections: GCP foundational design, and infrastructure design
## Foundational examples
Foundational examples deal with organization-level management of GCP resources, and take care of folder hierarchy, initial automation requirements (service accounts, GCS buckets), and high level best practices like audit log exports and organization policies.
They are simplified versions of real-life use cases, and put a particular emphasis on separation of duties at the environment or tenant level, and decoupling high level permissions from the day to day running of infrastructure automation. More details and the actual examples are available in the [foundations folder](foundations).
## Infrastructure examples
Infrastructure examples showcase typical networking configurations on GCP, and are meant to illustrate how to automate them with Terraform, and to offer an easy way of testing different scenarios. Like the foundational examples, they are simplified versions of real-life use cases. More details and the actual examples are available in the [infrastructure folder](infrastructure).