This folder contains cloud-agnostic guides that apply across Azure, AWS, and GCP Databricks deployments.
Start here if you're having trouble getting Terraform to connect to your cloud or Databricks.
Learn how to set up authentication for Terraform so it can:
- Connect to your cloud provider (Azure/AWS/GCP)
- Connect to Databricks
- Deploy resources without permission errors
Perfect for:
- First-time Terraform users
- Troubleshooting "authentication failed" errors
- Setting up CI/CD pipelines
- Understanding which credentials go where
Understand how Databricks accesses your cloud account.
Learn how Databricks creates workspaces and accesses storage:
- AWS: Cross-account roles and AssumeRole pattern
- Azure: First-party app and managed identities
- GCP: Service accounts and impersonation
- Unity Catalog storage access patterns
- Security model and audit trails
Perfect for:
- Understanding "how does this work?"
- Security reviews and compliance
- Troubleshooting access issues
- Explaining to management/security teams
Understand Databricks network architecture and design secure networks.
Learn how to design and deploy Databricks networking:
- Control plane vs compute plane architecture
- AWS customer-managed VPC (complete with troubleshooting)
- Azure VNet injection (complete with troubleshooting)
- GCP customer-managed VPC (complete with troubleshooting)
- VPC/VNet requirements, security rules, NAT configuration
- Private connectivity options (PrivateLink, Private Link, PSC, VPC-SC)
- Cross-cloud comparison table
- Cloud-specific troubleshooting with CLI examples
- Best practices across all three clouds
Perfect for:
- Platform engineers deploying infrastructure
- Cloud architects designing secure networks
- Security teams reviewing network controls
- Troubleshooting connectivity issues across AWS, Azure, and GCP
Quick answers to frequently asked questions.
Searchable Q&A covering all Databricks topics:
- General concepts (classic vs serverless, workspace types)
- Networking (AWS, Azure, GCP-specific questions)
- Authentication & identity (coming soon)
- Security & compliance
- Troubleshooting common issues
Perfect for:
- Quick reference when stuck
- Understanding specific concepts
- Comparing options across clouds
- Troubleshooting guidance
- Security Guide - Best practices for secure Databricks deployments
- Performance Guide - Optimization and tuning recommendations
- Start with the topic you need help with
- Each guide is written in plain English (no jargon)
- Follow the step-by-step instructions
- Copy-paste the examples
- Refer back when you get stuck
Found something confusing? Please let us know so we can improve these guides.