Merge branch 'main' into trunk-io/update-trunk

.gitignore

@@ -26,7 +26,6 @@
 
 # Output from other tools that might be used alongside Terraform/OpenTofu
 *.tfvars.json
-backend.tf.json
 
 # Taskit files
 .taskit/
@@ -39,4 +38,4 @@ backend.tf.json
 **/*.temp
 **/*.bak
 **/*.*swp
-**/.DS_Store
+**/.DS_Store

examples/complete/README.md

@@ -0,0 +1,38 @@
+# Complete Example
+
+This example demonstrates how to use the spacelift-automation component to manage Spacelift stacks, including the ability for Spacelift to manage its own configuration.
+
+Normally, this directory would contain a simple root module to spin up a basic example. To showcase a more practical use case where Spacelift manages its own infrastructure, we’ve moved the configuration to the expected path: [examples/complete/components/spacelift-automation/](./components/spacelift-automation/).
+
+By doing this, we provide an example of how to set up Spacelift to automate the management of your infrastructure stacks, including itself.
+
+## Use the Example
+
+1. Prerequisites:
+   - Replace the following configuration files with your own values:
+     - `backend.tf.json`: Configure your Terraform backend settings
+     - `example.tfvars`: Set your Spacelift configuration variables
+     - `example.yaml`: Define your stack configuration
+       > **Important:** These files may contain sensitive information. Ensure you:
+       >
+       > - Remove any hardcoded credentials or sensitive values
+       > - Have appropriate Spacelift and AWS permissions
+       > - Follow your organization's security practices
+1. Navigate to the spacelift-automation component directory:
+   ```sh
+   cd ./components/spacelift-automation/
+   ```
+1. Initialize Terraform:
+   ```sh
+   tofu init
+   ```
+1. Select the worspace:
+   ```sh
+   tofu workspace select example
+   ```
+1. Review the Terraform plan:
+   ```sh
+   tofu plan -var-file tfvars/example.tfvars
+   ```
+
+This will set up the Spacelift stack that manages itself.

examples/complete/components/random-pet/main.tf

@@ -0,0 +1,3 @@
+resource "random_pet" "template" {
+  length = var.length
+}

examples/complete/components/random-pet/stacks/common.yaml

@@ -0,0 +1,3 @@
+stack_settings:
+  manage_state: true
+  description: This stack generates random pet names

examples/complete/components/random-pet/stacks/example.yaml

@@ -0,0 +1,2 @@
+stack_settings:
+  manage_state: true

examples/complete/components/random-pet/tfvars/example.tfvars

@@ -0,0 +1 @@
+length = 10

examples/complete/components/random-pet/variables.tf

@@ -0,0 +1,4 @@
+variable "length" {
+  description = "The length of the random name"
+  type        = number
+}

examples/complete/components/random-pet/versions.tf

@@ -0,0 +1,10 @@
+terraform {
+  required_version = "~> 1.0"
+
+  required_providers {
+    random = {
+      source  = "hashicorp/random"
+      version = "~> 3.0"
+    }
+  }
+}

examples/complete/components/spacelift-automation/backend.tf.json

@@ -0,0 +1,18 @@
+{
+  "terraform": {
+    "backend": {
+      "s3": {
+        "workspace_key_prefix": "terraform-spacelift-automation",
+        "acl": "bucket-owner-full-control",
+        "bucket": "mp-automation-tfstate",
+        "dynamodb_table": "mp-automation-tfstate-lock",
+        "encrypt": true,
+        "key": "terraform.tfstate",
+        "region": "us-east-1",
+        "assume_role": {
+          "role_arn": "arn:aws:iam::755965222190:role/mp-automation-tfstate"
+        }
+      }
+    }
+  }
+}

examples/complete/components/spacelift-automation/main.tf

@@ -0,0 +1,12 @@
+module "automation" {
+  source = "../../../../"
+
+  github_enterprise = var.github_enterprise
+  repository        = var.repository
+  branch            = var.branch
+
+  root_modules_path        = var.root_modules_path
+  all_root_modules_enabled = var.all_root_modules_enabled
+
+  aws_integration_id = var.aws_integration_id
+}

examples/complete/components/spacelift-automation/stacks/common.yaml

@@ -0,0 +1,3 @@
+stack_settings:
+  administrative: true
+  aws_integration_enabled: true