Adding AWS Multiple Workspace Example

[JDBraun]

This example provides a functioning AWS multiple workspace example.

Included in this example are:

• Logging: A logging pipeline that creates all of the underlying cloud resources and Databricks resources to receive billing and audit logs.
• Unity Catalog: An isolated pipeline that creates the needed S3 bucket and IAM role for the root metastore. This isolates the metastore using the account level provider and decouples it from any workspaces.
• Common Account Modules: In this folder are commonly used account related modules that are called from each of the environments. These include: cloud provider assets (e.g. cross-account role, DBFS, and basic networking set-up) as well as environment specific Databricks assets (e.g. workspace creation, metastore assignment, and identity assignment).
• Common Workspace Modules: In this folder are commonly used workspace related modules that are called from each of the environments. These include cluster policies and workspace configurations as examples.
• Databricks environment: Three environments are included as examples that invoke the previous mentioned modules. These can stay as is, be reduced, or changed to reflect the logical set-up of the end user.

In addition: Reference Images: These reference images include real screenshots as well as logical architecture diagrams of the set-up tfvars Examples: To expedite adoption of this example, we've provided tfvars examples that can be copied and applied into the repo

Further improvements:

• Metastore and identities assignment: We can further improve this repo by building out the metastore and identities assignment into one. Then include a way to iterate over a list of account level identities instead of a single user.

[JDBraun]

Let's structure it differently - modules will go to the top-level modules folder, and then in examples we'll just show how to call these modules.

@alexott if I'm reading this correctly:

• reference_images
• modules (infrastructure, account, workspace)
• examples (dev, prod, qa)
• README.md

is that how you were imaging it?

[alexott]

@JDBraun I meant to have correct structure inside the repository, like this:

examples/
  aws-multi-workspace
     README.md
     *.tf files
modules/
  aws-module1
     README.md
     main.tf
     ...
  aws-module2
     README.md
     main.tf
     ...

images could be placed in the subdirectories of examples or in modules...

I've tried to talk about this layout in this PR: https://github.com/databricks/terraform-databricks-examples/pull/111/files

[JDBraun]

@JDBraun I meant to have correct structure inside the repository, like this:

examples/
  aws-multi-workspace
     README.md
     *.tf files
modules/
  aws-module1
     README.md
     main.tf
     ...
  aws-module2
     README.md
     main.tf
     ...

images could be placed in the subdirectories of examples or in modules...

I've tried to talk about this layout in this PR: https://github.com/databricks/terraform-databricks-examples/pull/111/files

Got it, thanks! I'll go ahead and take another stab at restructuring