docs: add optional installation script and enhance resource configuration in module guide

DevelopmentCats · DevelopmentCats · commit 7a906b77cb31 · 2025-06-26T02:32:48.000Z
diff --git a/docs/about/contributing/modules.md b/docs/about/contributing/modules.md
@@ -181,6 +181,7 @@ module "code-server" {
 ```text
 my-module/
 ├── main.tf          # Terraform configuration
+├── run.sh           # Installation/setup script (optional but recommended)
 ├── README.md        # Documentation with frontmatter
 └── main.test.ts     # Test suite
 ```
@@ -212,8 +213,13 @@ variable "port" {
 data "coder_workspace" "me" {}
 
 resource "coder_script" "install" {
-  agent_id = var.agent_id
-  script   = "#!/bin/bash\necho 'Installing service...'"
+  agent_id     = var.agent_id
+  display_name = "Install Service"
+  icon         = "/icon/service.svg"
+  script = templatefile("${path.module}/run.sh", {
+    PORT = var.port
+  })
+  run_on_start = true
 }
 
 resource "coder_app" "service" {
