Add terraform examples folder structure

[Copilot]

Bootstraps the repo with a consistent, scalable folder layout for hosting multiple Terraform examples across cloud providers.

Structure

examples/
├── aws/
│   ├── ec2-instance/
│   ├── s3-bucket/
│   └── vpc/
├── azure/
│   ├── resource-group/
│   └── virtual-network/
└── gcp/
    ├── gke-cluster/
    └── vpc-network/
modules/          # reusable modules landing zone

Conventions

• Every example is self-contained under examples/<provider>/<resource>/
• Each folder follows the standard five-file layout: main.tf, variables.tf, outputs.tf, versions.tf, README.md
• Provider version constraints pinned in versions.tf (AWS ~> 5.0, AzureRM ~> 3.0, Google ~> 5.0)
• .gitignore covers .terraform/, state files, lock files, and *.tfvars
• Root README.md updated with structure overview, per-example usage pattern, and contributing guide

Original prompt

create a folder structure that best suites a repo that will contain several terraform examples.

[jblaaa-codes-ms]

@copilot the examples would NOT have anything other than azure, can you remove any of the aws type structure?

[Copilot]

Pull request overview

Bootstraps the repository with a consistent Terraform examples layout (by cloud provider and resource/use-case), plus baseline documentation and ignore rules to support adding more examples over time.

Changes:

• Added a standardized examples/<provider>/<example>/ structure with initial AWS, Azure, and GCP examples (each with main.tf, variables.tf, outputs.tf, versions.tf, README.md).
• Added modules/ as a landing zone for reusable Terraform modules with a starter README.
• Updated root README.md and added .gitignore for Terraform artifacts.

Reviewed changes

Copilot reviewed 37 out of 38 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
README.md	Documents repo purpose, structure, and the standard example layout/usage flow.
.gitignore	Ignores Terraform working directories, state/plan files, and tfvars.
modules/README.md	Introduces the intended reusable module area and basic usage guidance.
examples/aws/ec2-instance/main.tf	Adds an EC2 instance example using latest Amazon Linux 2 AMI selection.
examples/aws/ec2-instance/variables.tf	Defines inputs for the EC2 instance example.
examples/aws/ec2-instance/outputs.tf	Exposes basic EC2 outputs.
examples/aws/ec2-instance/versions.tf	Pins Terraform/provider constraints and configures the AWS provider.
examples/aws/ec2-instance/README.md	Documents the EC2 instance example usage and inputs/outputs.
examples/aws/s3-bucket/main.tf	Adds an S3 bucket example with encryption, versioning option, and public access block.
examples/aws/s3-bucket/variables.tf	Defines inputs for the S3 bucket example.
examples/aws/s3-bucket/outputs.tf	Exposes basic S3 outputs.
examples/aws/s3-bucket/versions.tf	Pins Terraform/provider constraints and configures the AWS provider.
examples/aws/s3-bucket/README.md	Documents the S3 bucket example usage and inputs/outputs.
examples/aws/vpc/main.tf	Adds a VPC example with public/private subnets and routing resources.
examples/aws/vpc/variables.tf	Defines inputs for the VPC example.
examples/aws/vpc/outputs.tf	Exposes VPC/subnet/IGW outputs.
examples/aws/vpc/versions.tf	Pins Terraform/provider constraints and configures the AWS provider.
examples/aws/vpc/README.md	Documents the VPC example usage and inputs/outputs.
examples/azure/resource-group/main.tf	Adds a basic Azure resource group example.
examples/azure/resource-group/variables.tf	Defines inputs for the Azure resource group example.
examples/azure/resource-group/outputs.tf	Exposes Azure resource group outputs.
examples/azure/resource-group/versions.tf	Pins Terraform/provider constraints and configures the AzureRM provider.
examples/azure/resource-group/README.md	Documents the Azure resource group example usage and inputs/outputs.
examples/azure/virtual-network/main.tf	Adds a basic Azure VNet + subnet example (including RG creation).
examples/azure/virtual-network/variables.tf	Defines inputs for the Azure virtual network example.
examples/azure/virtual-network/outputs.tf	Exposes Azure VNet/subnet outputs.
examples/azure/virtual-network/versions.tf	Pins Terraform/provider constraints and configures the AzureRM provider.
examples/azure/virtual-network/README.md	Documents the Azure virtual network example usage and inputs/outputs.
examples/gcp/gke-cluster/main.tf	Adds a basic GKE cluster example.
examples/gcp/gke-cluster/variables.tf	Defines inputs for the GKE cluster example.
examples/gcp/gke-cluster/outputs.tf	Exposes GKE outputs (with sensitive markings).
examples/gcp/gke-cluster/versions.tf	Pins Terraform/provider constraints and configures the Google provider.
examples/gcp/gke-cluster/README.md	Documents the GKE cluster example usage and inputs/outputs.
examples/gcp/vpc-network/main.tf	Adds a GCP VPC + subnetwork example.
examples/gcp/vpc-network/variables.tf	Defines inputs for the GCP VPC network example.
examples/gcp/vpc-network/outputs.tf	Exposes VPC/subnetwork outputs.
examples/gcp/vpc-network/versions.tf	Pins Terraform/provider constraints and configures the Google provider.
examples/gcp/vpc-network/README.md	Documents the GCP VPC network example usage and inputs/outputs.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.